正しい著作権属性を表示する
Azure Maps Render サービスをベースマップまたはレイヤーとして利用する場合は、適切なデータ プロバイダーの著作権属性をマップに表示する必要があります。 この情報は、マップの右下隅に表示する必要があります。
上の図は、Render サービスからのマップの例であり、道路スタイルを表示しています。 マップの右下隅に著作権属性が表示されます。
上の図は、Render サービスからのマップの例であり、衛星スタイルを表示しています。 別のデータ プロバイダーが一覧表示されていることに注意してください。
Get Map Attribution API
Get Map Attribution API を使用すると、アプリケーション内のマップ上に表示できるようにマップの著作権属性情報を要求することができます。
Get Map Attribution API を使用する場合
マップの著作権属性情報は、Web やモバイル アプリケーションなど、Render API を使用するすべてのアプリケーションに表示する必要があります。
Web、Android、iOS の SDK など、Azure Maps SDK のいずれかを使用すると、マップに対して属性が自動的に表示され、更新されます。
サードパーティ マップで Render Service のマップ タイルを使用する場合は、マップ上で著作権属性情報を表示および更新する必要があります。
エンド ユーザーが別のスタイルを選択するか、拡大または縮小するか、またはマップをパンするたびに、マップのコンテンツが変更されます。 これらの各ユーザー アクションによって、イベントが発生します。 これらのイベントのいずれかが発生したら、Get Map Attribution API を呼び出す必要があります。 著作権属性情報の更新が完了したら、それをマップの右下隅に表示する必要があります。
データ プロバイダーは "リージョン" と "ズーム" レベルによって異なる可能性があるため、Get Map Attribution API はこれらのパラメーターを入力として受け取り、対応する属性テキストを返します。
Get Map Attribution API の使用方法
attribution コマンドを実行するには、次の情報が必要です。
| パラメーター | Type | 説明 |
|---|---|---|
| api-version | string | Azure Maps API のバージョン番号。 |
| bounds | array | 境界ボックスの四角形の領域を表す文字列。 bounds パラメーターは、4 つの境界ボックス座標によって定義されます。 最初の 2 つは、南西隅を定義する WGS84 経度および緯度で、最後の 2 つは北東隅を定義する WGS84 経度および緯度です。 文字列は、[SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude] の形式で表示されます。 |
| tilesetId | TilesetID | タイルセットは、事前設定されたズーム レベルで、正方形のタイルの均一なグリッドに分割されたラスターまたはベクター データのコレクションです。 すべてのタイルセットには、要求を行うときに使用する tilesetId があります。 Azure Maps Creator を使用して作成されたタイルセットの tilesetId は、Tileset Create API を使用して生成されます。 Azure Maps によって提供される、すぐに使用できるタイルセットがあります (microsoft.base.road、microsoft.base.hybrid、microsoft.weather.radar.main など)。完全な一覧については、REST API ドキュメントの「Get Map Attribution」を参照してください。 |
| zoom | 整数 (integer) | 選択されたタイルのズーム レベル。 有効な範囲はタイルによって異なります。特定のタイルセットに対して有効な値については、TilesetID の表を参照してください。 詳細については、「ズーム レベルとタイル グリッド」の記事を参照してください。 |
| subscription-key | string | Azure Maps アカウントから提供される Azure Maps キーの 1 つ。 詳細については、「Azure Maps による認証」の記事を参照してください。 |
次の GET 要求を実行して、マップに表示する対応する著作権属性を取得します。
https://atlas.microsoft.com/map/attribution?subscription-key={Your-Azure-Maps-Subscription-key}&api-version=2.1&tilesetId=microsoft.base&zoom=6&bounds=-122.414162,47.579490,-122.247157,47.668372
追加情報
- 詳細については、Render サービスのドキュメントを参照してください。