Render - Get Map Tile

ベクター形式またはラスター形式でマップ タイルを要求するために使用します。

Get Map Tiles API を使用すると、ユーザーはベクター形式またはラスター形式のマップ タイルを要求でき、通常はマップ コントロールまたは SDK に統合できます。 サポートされているタイルタイプには、Azure Mapsの道路タイルやリアルタイムの気象レーダータイルがあります。 デフォルトでは、Azure Maps Web SDKはウェブマップコントロールのレンダリングにベクタータイルを使用します。

GET https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}

GET https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}&timeStamp={timeStamp}&tileSize={tileSize}&language={language}&view={view}

URI パラメーター

要求ヘッダー

応答

セキュリティ

AADToken

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

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

注記

• このセキュリティ定義要求アプリケーションがどのAzure Mapsリソースにアクセスを要求しているかを示すためにx-ms-client-idヘッダーを使用します。 これは、Maps 管理 APIから取得できます。

Authorization URLはAzureパブリッククラウドインスタンス専用です。 ソブリンクラウドは固有の認可URLとMicrosoft Entra IDの設定を持っています。 * Azureロールベースのアクセス制御は、Azureポータル、PowerShell、CLI、Azure SDKs、REST APIを通じてAzure管理プレーンから設定されます。 * Azure Maps Web SDKの利用により、複数のユースケース向けにアプリケーションの設定が可能になります。

• Microsoft ID プラットフォームの詳細については、「Microsoft ID プラットフォームの概要」を参照してください。

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

スコープ

subscription-key

これは共有キーで、Azure Mapsリソースを作成する際に、Azureポータル、PowerShell、CLI、Azure SDKs、REST APIを通じてAzure管理プレーンを通じてプロビジョニングされます。

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

公開されているアプリケーションについては、このキーを安全に保存できるAzure Maps REST APIのサーバー間アクセスを利用することを推奨します。

型: apiKey
/: header

SAS Token

これは共有アクセス署名トークンで、Azure MapsリソースのList SAS操作からAzureポータル、PowerShell、CLI、Azure SDKs、REST APIを通じてAzure管理プレーンを経由して作成されます。

このトークンにより、どのアプリケーションもAzureの役割ベースのアクセス制御と細かい制御で、そのトークンの有効期限、速度、使用地域へのアクセスが許可されます。 つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。

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

型: apiKey
/: header

例

Successful Tile Request

GET https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId=microsoft.base&zoom=6&x=10&y=22

Content-Type: application/vnd.mapbox-vector-tile

"binary image string"

定義

ErrorAdditionalInfo

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

ErrorDetail

エラーの詳細。

ErrorResponse

エラー応答

LocalizedMapView

View パラメーター ("ユーザーリージョン" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が生じしている地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なります。また、View パラメーターを使用すると、アプリケーションがサービスを提供する国/地域で必要なビューにアプリケーションを準拠できます。 既定では、要求で定義していない場合でも、View パラメーターは "Unified" に設定されます。 ユーザーの場所を特定し、その場所に対して View パラメーターを正しく設定するのは、ユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View=Auto' を設定することもできます。 Azure MapsのViewパラメータは、地図、画像、その他のデータ、第三者コンテンツがAzure Mapsを通じて公開されている国・地域の適用法、地図に関する法律を遵守して使用されなければなりません。 例: view=IN。

詳細については、サポートされているビューの を参照し、使用可能なビューを参照してください。

MapTileSize

返されるマップ タイルのサイズ (ピクセル単位)。

TilesetID

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