Render - Get Map Attribution

マップ著作権属性情報を取得するために使用します。
Get Map Attribution API を使用すると、ユーザーはタイルセットのセクションのマップ著作権属性情報を要求できます。

GET {endpoint}/map/attribution?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&bounds={bounds}

URI パラメーター

名前 / 必須 説明
endpoint
path True

string (uri)

Azure Mapsサービスのホストネーム。 Azureパブリッククラウドにはhttps://atlas.microsoft.comを使いましょう。 特定のAzure Maps地理やソブリンクラウドをターゲットにする場合は、Azure Maps地理的範囲を参照してください。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

bounds
query True

number[]

境界ボックスの四角形領域を表す文字列。 境界パラメーターは、4 つの境界ボックス座標によって定義され、WGS84 経度と緯度が南西角に続き、WGS84 経度と北東角の緯度が続きます。 文字列は次の形式で表示されます: [SouthwestCorner_Longitude, SouthwestCorner_Latitude, NortheastCorner_Longitude, NortheastCorner_Latitude].

tilesetId
query True

TilesetID

タイルセットは、事前設定されたズーム レベルで、正方形のタイルの均一なグリッドに分割されたラスターまたはベクター データのコレクションです。 すべてのタイルセットには、要求を行うときに使用する tilesetId があります。 Azure Mapsが提供するすぐに使えるタイルセットは以下の通りです。 たとえば、microsoft.base です。

zoom
query True

integer (int32)

目的のマップ属性のズーム レベル。

要求ヘッダー

名前 必須 説明
x-ms-client-id

string

Microsoft Entra IDセキュリティモデルで使用されることを意図したアカウントを示します。 このAzure Mapsアカウントの一意IDは、Azure Maps管理プレーンのアカウントAPIから取得できます。 Azure MapsにおけるMicrosoft Entra IDセキュリティの使用についての詳細は、Azure Mapsの認証管理Manage certificationをご覧ください。

応答

名前 説明
200 OK

MapAttribution

要求は成功しました。

Other Status Codes

ErrorResponse

予期しないエラー応答。

セキュリティ

AadToken

これらはMicrosoft Entra OAuth 2.0フローです。 Azureロールベースアクセス制御と組み合わせることで、Azure Maps REST APIへのアクセス制御に利用できます。 Azure ロールベースのアクセス制御は、1つ以上の Azure Maps リソースアカウントまたはサブリソースへのアクセスを指定するために使用されます。 Azure Maps REST API に対する 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、任意のユーザー、グループ、またはサービス プリンシパルにアクセス権を付与できます。

シナリオを実装するには、認証の概念表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを介してアプリケーションをモデル化するためのソリューションを提供します。

Note

  • このセキュリティ定義 使用して、アプリケーションがアクセスを要求している Azure Maps リソースを示す必要があります。 これは、Maps 管理 APIから取得できます。
  • Authorization URL は、Azure パブリック クラウド インスタンスに固有です。 ソブリンクラウドは固有の認可URLとMicrosoft Entra IDの設定を持っています。
  • Azure ロールベースのアクセス制御は、Azure portal、PowerShell、CLI、Azure SDK、または REST API を使用して Azure 管理プレーンから構成されます。
  • Azure Maps Web SDK を使用すると、複数のユース ケースに対するアプリケーションの構成ベースのセットアップが可能になります。
  • Microsoft ID プラットフォームの詳細については、「Microsoft ID プラットフォームの概要」を参照してください。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前 説明
https://atlas.microsoft.com/.default

subscription-key

これは、Azure portal で、または PowerShell、CLI、Azure SDK、または REST API を使用して Azure Maps アカウント を作成 場合にプロビジョニングされる共有キーです。

このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。 つまり、このキーは、発行されたアカウントのマスター キーとして使用できます。

パブリックに公開されているアプリケーションの場合は、キーを安全に格納できるように、機密クライアント アプリケーション アプローチを使用して Azure Maps REST API にアクセスすることをお勧めします。

型: apiKey
/: header

SAS Token

これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンを介して、Azure Maps リソース のリスト SAS 操作から作成される Shared Access Signature トークンです。

このトークンを使用すると、すべてのアプリケーションは、Azure ロールベースのアクセス制御と、特定のトークンに対する使用の有効期限、レート、およびリージョンに対するきめ細かな制御を使用してアクセスすることが承認されます。 つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。

パブリックに公開されているアプリケーションの場合は、Map アカウント リソースの許可された配信元の特定の一覧を構成し、レンダリングの不正使用を制限し、SAS トークンを定期的に更新するように することをお勧めします。

型: apiKey
/: header

Successful Attribution Request

要求のサンプル

GET https://atlas.microsoft.com/map/attribution?api-version=2024-04-01&tilesetId=microsoft.base&zoom=6&bounds=-122.414162,47.57949,-122.247157,47.668372

応答のサンプル

{
  "copyrights": [
    "<a data-azure-maps-attribution-tileset=\"microsoft.base\">&copy;2022 TomTom</a>"
  ]
}

定義

名前 説明
ErrorAdditionalInfo

リソース管理エラーの追加情報。

ErrorDetail

エラーの詳細。

ErrorResponse

すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。

MapAttribution

タイルセットの要求されたセクションの著作権属性。

TilesetID

タイルセットは、事前設定されたズーム レベルで、正方形のタイルの均一なグリッドに分割されたラスターまたはベクター データのコレクションです。 すべてのタイルセットには、要求を行うときに使用する tilesetId があります。 Azure Mapsが提供するすぐに使えるタイルセットは以下の通りです。 たとえば、microsoft.base です。

ErrorAdditionalInfo

リソース管理エラーの追加情報。

名前 説明
info

追加情報。

type

string

追加情報の種類。

ErrorDetail

エラーの詳細。

名前 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。

code

string

エラー コード。

details

ErrorDetail[]

エラーの詳細。

message

string

エラー メッセージ。

target

string

エラーターゲット。

ErrorResponse

すべてのAzure Resource Manager APIで失敗した操作に対してエラー詳細を返す共通のエラー応答です。 (これは、OData エラー応答形式にも従います)。

名前 説明
error

ErrorDetail

エラー オブジェクト。

MapAttribution

タイルセットの要求されたセクションの著作権属性。

名前 説明
copyrights

string[]

著作権文字列の一覧。

TilesetID

タイルセットは、事前設定されたズーム レベルで、正方形のタイルの均一なグリッドに分割されたラスターまたはベクター データのコレクションです。 すべてのタイルセットには、要求を行うときに使用する tilesetId があります。 Azure Mapsが提供するすぐに使えるタイルセットは以下の通りです。 たとえば、microsoft.base です。

説明
microsoft.base

ベース マップは、道路、自然フィーチャ、人工地物、およびベクター タイル内のそれらのフィーチャのラベルを表示する標準マップです。

ズーム レベル 0 ~ 22 をサポートします。 形式: vector (pbf)。

microsoft.base.labels

ベクター タイル内の道路、自然フィーチャ、人工フィーチャのラベルを表示します。

ズーム レベル 0 ~ 22 をサポートします。 形式: vector (pbf)。

microsoft.base.hybrid

道路、境界、ラベルのデータをベクター タイルに表示します。

ズーム レベル 0 ~ 22 をサポートします。 形式: vector (pbf)。

microsoft.terra.main

影付きレリーフとテラレイヤー。

ズーム レベル 0 ~ 6 をサポートします。 形式: ラスター (png)。

microsoft.base.road

私たちのメインスタイルを持つすべてのレイヤー。

ズーム レベル 0 ~ 22 をサポートします。 形式: ラスター (png)。

microsoft.base.darkgrey

濃い灰色のスタイルを持つすべてのレイヤー。

ズーム レベル 0 ~ 22 をサポートします。 形式: ラスター (png)。

microsoft.base.labels.road

メイン スタイルでデータにラベルを付けます。

ズーム レベル 0 ~ 22 をサポートします。 形式: ラスター (png)。

microsoft.base.labels.darkgrey

濃い灰色のスタイルでデータにラベルを付けます。

ズーム レベル 0 ~ 22 をサポートします。 形式: ラスター (png)。

microsoft.base.hybrid.road

メイン スタイルの道路、境界、ラベルのデータ。

ズーム レベル 0 ~ 22 をサポートします。 形式: ラスター (png)。

microsoft.base.hybrid.darkgrey

濃い灰色のスタイルの道路、境界、ラベルのデータ。

ズーム レベル 0 ~ 22 をサポートします。 形式: ラスター (png)。

microsoft.imagery

衛星画像または航空写真の組み合わせ。 S1 および G2 価格 SKU でのみ使用できます。

ズーム レベル 1 ~ 19 をサポートします。 形式: ラスター (png)。

microsoft.weather.radar.main

気象レーダー タイル。 雨、雪、氷、混合条件の領域を含む最新の気象レーダー画像。 Azure Maps気象サービスの報道の詳細については、Azure Maps気象サービスの報道をご覧ください。 レーダーデータの詳細については、Azure Maps<>の気象サービスをご覧ください。

ズーム レベル 0 ~ 15 をサポートします。 形式: ラスター (png)。

microsoft.weather.infrared.main

赤外線タイルの天気。 最新の赤外線衛星画像は、その温度によって雲を示しています。 詳細については、Azure Maps気象サービスのカバレッジをご覧ください。 衛星データの詳細については、Azure Maps気象サービスをご覧ください。

ズーム レベル 0 ~ 15 をサポートします。 形式: ラスター (png)。

microsoft.traffic.absolute

ベクトル内の絶対トラフィック タイル

microsoft.traffic.absolute.main

メイン スタイルのラスター内の絶対トラフィック タイル。

microsoft.traffic.relative

ベクター内の相対トラフィック タイル

microsoft.traffic.relative.main

メイン スタイルのラスター内の相対トラフィック タイル。

microsoft.traffic.relative.dark

ダーク スタイルのラスター内の相対トラフィック タイル。

microsoft.traffic.delay

ベクター内のトラフィック タイル

microsoft.traffic.delay.main

メイン スタイルのラスター内のトラフィック タイル

microsoft.traffic.reduced.main

メイン スタイルのラスター内のトラフィック タイルの削減

microsoft.traffic.incident

ベクター内のインシデント タイル