Render - Get Map Tileset

タイルセットのメタデータを取得するために使用します。
Get Map Tileset API を使用すると、ユーザーはタイルセットのメタデータを要求できます。

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

URI パラメーター

要求ヘッダー

応答

セキュリティ

AadToken

これらはMicrosoft Entra OAuth 2.0フローです。 Azureロールベースアクセス制御と組み合わせることで、Azure Maps REST APIへのアクセス制御に利用できます。 Azure ロールベースのアクセス制御は、1つ以上の Azure Maps リソースアカウントまたはサブリソースへのアクセスを指定するために使用されます。 任意のユーザー、グループ、またはサービスプリンシパルは、組み込みの役割や1つ以上のREST API権限からなるカスタムロールを通じてアクセス権Azure Maps付与されます。\n\nシナリオを実装するには、authentication conceptsを見ることをお勧めします。 まとめると、このセキュリティ定義は、特定のAPIやスコープでアクセス制御が可能なオブジェクトを通じてアプリケーションをモデリングするソリューションを提供します。\n\n#### 注記\n* このセキュリティ定義要求x-ms-client-idヘッダーを使用してアプリケーションがどのAzure Mapsリソースへのアクセスを要求しているかを示します。 これはMaps管理APIから取得可能です。\n* \nAuthorization URLはAzureパブリッククラウドインスタンス専用です。 ソブリンクラウドは固有の認可URLとMicrosoft Entra IDの設定を持っています。 \n* \nAzureロールベースのアクセス制御は、Azure管理プレーンから、Azureポータル、PowerShell、CLI、Azure SDK、REST APIを通じて構成されます。\n* \nAzure MapsWeb SDKは、複数のユースケース向けにアプリケーションの設定を可能にします。\n* Microsoft ID プラットフォームの詳細については、Microsoft ID プラットフォーム概要をご覧ください。

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

スコープ

subscription-key

これは共有キーで、AzureポータルでCreate a Azure Maps accountを行うか、PowerShell、CLI、Azure SDK、REST APIを使ってプロビジョニングされます。\n\n このキーがあれば、どのアプリケーションでもすべてのREST APIにアクセスできます。 つまり、この鍵は発行された口座のマスターキーとして使うことができます。\n\n 公開されているアプリケーションについては、confidential client applications方式を用いてREST API Azure Mapsにアクセスし、鍵を安全に保存できるようにすることをお勧めします。

型: apiKey
/: header

SAS Token

これは共有アクセス署名トークンで、Azure MapsリソースのList SAS操作からAzureポータル、PowerShell、CLI、Azure SDK、REST APIを通じてAzure管理プレーンを経由して作成されます。\n\n このトークンにより、どのアプリケーションでもAzureでアクセスが許可されますロールベースのアクセス制御や、特定のトークンの有効期限、速度、使用領域の細かい制御。 言い換えれば、SASトークンは共有鍵よりも安全な方法でアクセスを制御するために使えます。\n\n 公開されているアプリケーションについては、 Mapアカウントリソース 上で許可された発信元の特定のリストを設定し、レンダリングの乱用を制限し、SASトークンを定期的に更新することを推奨します。

型: apiKey
/: header

例

Successful Tileset Request

GET {endpoint}/map/tileset?api-version=2024-04-01&tilesetId=microsoft.base

{
  "attribution": "<a data-azure-maps-attribution-tileset=\"microsoft.base\">&copy;2022 TomTom</a>",
  "bounds": [
    -180,
    -90,
    180,
    90
  ],
  "maxzoom": 22,
  "minzoom": 0,
  "scheme": "xyz",
  "tilejson": "2.2.0",
  "tiles": [
    "https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}"
  ],
  "version": "1.0.0"
}

定義

ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

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

MapTileset

TileJSON 形式のタイルセットのメタデータ。

TilesetID

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