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