正しい著作権属性を表示する

Azure Maps Render サービスをベースマップまたはレイヤーとして利用する場合は、適切なデータ プロバイダーの著作権属性をマップに表示する必要があります。 この情報は、マップの右下隅に表示する必要があります。

The above image is an example of a map from the Render service showing the copyright attribution when using the road style

上の図は、Render サービスからのマップの例であり、道路スタイルを表示しています。 マップの右下隅に著作権属性が表示されます。

The above image is an example of a map from the Render service showing the copyright attribution when using the satellite style

上の図は、Render サービスからのマップの例であり、衛星スタイルを表示しています。 別のデータ プロバイダーが一覧表示されていることに注意してください。

Get Map Attribution API

Get Map Attribution API を使用すると、アプリケーション内のマップ上に表示できるようにマップの著作権属性情報を要求することができます。

Get Map Attribution API を使用する場合

マップの著作権属性情報は、Web やモバイル アプリケーションなど、Render API を使用するすべてのアプリケーションに表示する必要があります。

WebAndroidiOS の 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.roadmicrosoft.base.hybridmicrosoft.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 サービスのドキュメントを参照してください。