Render - Get Map Tile
を使用して、通常は新しいマップ コントロールまたは SDK に統合されるベクター形式またはラスター形式のマップ タイルを取得します。
注意
Azure Maps Render v1 サービスの廃止
Azure Maps Render v1 サービスは非推奨となり、2026 年 9 月 17 日に廃止されます。 サービスの中断を回避するには、2026 年 9 月 17 日までに、Render v1 API へのすべての呼び出しを、Render v2 API を使用するように更新する必要があります。
通常、新しいマップ コントロールまたは SDK に統合されるベクター形式またはラスター形式のマップ タイルをフェッチします。 既定では、Azure は Web マップ コントロールにベクター マップ タイルを使用します ( 「ズーム レベルとタイル グリッド」を参照)
注: 天気予報タイルは、 Get Map Tile V2 API でのみ使用できます。 新しい Get Map Tile V2 API の使用を開始することをお勧めします。
GET https://atlas.microsoft.com/map/tile/{format}?api-version=1.0&layer={layer}&style={style}&zoom={zoom}&x={x}&y={y}
GET https://atlas.microsoft.com/map/tile/{format}?api-version=1.0&layer={layer}&style={style}&zoom={zoom}&x={x}&y={y}&tileSize={tileSize}&language={language}&view={view}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
format
|
path | True |
応答の目的の形式。 指定できる値は png & pbf です。 |
|
api-version
|
query | True |
string |
Azure Maps API のバージョン番号。 |
layer
|
query | True |
要求されたマップ レイヤー。 使用できる値は、基本、ハイブリッド、ラベル、terra です。 |
|
style
|
query | True |
返されるマップ スタイル。 指定できる値は、メイン、濃色、shaded_reliefです。 |
|
x
|
query | True |
integer int32 |
ズーム グリッド上のタイルの X 座標。 値は [0, 2 詳細については、「 ズーム レベルとタイル グリッド 」を参照してください。 |
y
|
query | True |
integer int32 |
ズーム グリッド上のタイルの Y 座標。 値は [0, 2 詳細については、「 ズーム レベルとタイル グリッド 」を参照してください。 |
zoom
|
query | True |
integer int32 |
目的のタイルのズーム レベル。 詳細については、「 ズーム レベルとタイル グリッド 」を参照してください。 |
language
|
query |
string |
検索結果を返す言語。 サポートされている IETF 言語タグの 1 つである必要があります。大文字と小文字は区別されません。 指定した言語のデータが特定のフィールドで使用できない場合は、既定の言語が使用されます。 詳細については、「 サポートされている言語 」を参照してください。 |
|
tile
|
query |
返されるマップ タイルのサイズ (ピクセル単位)。 |
||
view
|
query |
View パラメーター ("user region" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が発生している地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なります。また、View パラメーターを使用すると、アプリケーションがサービスを提供する国/地域に必要なビューにアプリケーションを準拠できます。 既定では、View パラメーターは、要求で定義していない場合でも "Unified" に設定されます。 ユーザーの場所を特定し、その場所を正しく View パラメーターを設定するのはユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View = Auto' を設定することもできます。 Azure Mapsの View パラメーターは、マップ、画像、その他のデータ、Azure Maps経由でアクセスする権限を持つ第三者のコンテンツが利用可能になる国/地域のマッピングに関するものを含む、適用される法律に準拠して使用する必要があります。 例: view=IN。 詳細については、「 サポートされているビュー」 を参照し、使用可能なビューを参照してください。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID セキュリティ モデルと組み合わせて使用するアカウントを指定します。 Azure Maps アカウントの一意の ID を表し、Azure Maps管理プレーン アカウント API から取得できます。 Azure MapsでMicrosoft Entra IDセキュリティを使用するには、次の記事を参照してください。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
object |
このイメージは、マップ タイルの取得呼び出しが成功した場合に返されます Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" Headers Content-Type: string |
Other Status Codes |
予期しないエラーが発生しました。 Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" |
セキュリティ
AADToken
これらは OAuth 2.0 フロー Microsoft Entraです。 Azure ロールベースのアクセス制御と組み合わせて使用すると、Azure Maps REST API へのアクセスを制御できます。 Azure ロールベースのアクセス制御は、1 つ以上のAzure Mapsリソース アカウントまたはサブリソースへのアクセスを指定するために使用されます。 REST API に対する 1 つ以上のアクセス許可で構成される組み込みロールまたはカスタム ロールを使用して、任意のユーザー、グループ、またはサービス プリンシパルにアクセス権 Azure Mapsを付与できます。
シナリオを実装するには、 認証の概念を表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の API とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。
メモ
- このセキュリティ定義では、 ヘッダーを使用して、
x-ms-client-id
アプリケーションがアクセスを要求しているリソース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 プラットフォームの概要」を参照してください。
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名前 | 説明 |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
これは、Azure portalでAzure Maps アカウントを作成するとき、または PowerShell、CLI、Azure SDK、または REST API を使用するときにプロビジョニングされる共有キーです。
このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。 つまり、このキーは、発行されたアカウントのマスター キーとして使用できます。
公開されているアプリケーションの場合は、機密クライアント アプリケーションのアプローチを使用して、キーを安全に格納できるように、Azure Maps REST API にアクセスすることをお勧めします。
Type:
apiKey
In:
query
SAS Token
これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して、Azure 管理プレーンを介して、Azure Maps リソースの List SAS 操作から作成される共有アクセス署名トークンです。
このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンをきめ細かく制御できます。 つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。
公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定の一覧を構成して、レンダリングの不正使用を制限し、SAS トークンを定期的に更新することをお勧めします。
Type:
apiKey
In:
header
例
Successful Tile Request
Sample Request
GET https://atlas.microsoft.com/map/tile/png?api-version=1.0&layer=basic&style=main&zoom=6&x=10&y=22
Sample Response
Content-Type: image/png
"{file}"
定義
名前 | 説明 |
---|---|
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Localized |
View パラメーター ("user region" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が発生している地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なります。また、View パラメーターを使用すると、アプリケーションがサービスを提供する国/地域に必要なビューにアプリケーションを準拠できます。 既定では、View パラメーターは、要求で定義していない場合でも "Unified" に設定されます。 ユーザーの場所を特定し、その場所を正しく View パラメーターを設定するのはユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View = Auto' を設定することもできます。 Azure Mapsの View パラメーターは、マップ、画像、その他のデータ、Azure Maps経由でアクセスする権限を持つ第三者のコンテンツが利用可能になる国/地域のマッピングに関するものを含む、適用される法律に準拠して使用する必要があります。 例: view=IN。 詳細については、「 サポートされているビュー」 を参照し、使用可能なビューを参照してください。 |
Map |
要求されたマップ レイヤー。 使用できる値は、基本、ハイブリッド、ラベル、terra です。 |
Map |
返されるマップ タイルのサイズ (ピクセル単位)。 |
Map |
返されるマップ スタイル。 指定できる値は、メイン、濃色、shaded_reliefです。 |
Tile |
応答の目的の形式。 指定できる値は png & pbf です。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
LocalizedMapView
View パラメーター ("user region" パラメーターとも呼ばれます) を使用すると、地政学的に紛争が発生している地域の特定の国/地域の正しいマップを表示できます。 このようなリージョンのビューは国や地域によって異なります。また、View パラメーターを使用すると、アプリケーションがサービスを提供する国/地域に必要なビューにアプリケーションを準拠できます。 既定では、View パラメーターは、要求で定義していない場合でも "Unified" に設定されます。 ユーザーの場所を特定し、その場所を正しく View パラメーターを設定するのはユーザーの責任です。 または、要求の IP アドレスに基づいてマップ データを返す 'View = Auto' を設定することもできます。 Azure Mapsの View パラメーターは、マップ、画像、その他のデータ、Azure Maps経由でアクセスする権限を持つ第三者のコンテンツが利用可能になる国/地域のマッピングに関するものを含む、適用される法律に準拠して使用する必要があります。 例: view=IN。
詳細については、「 サポートされているビュー」 を参照し、使用可能なビューを参照してください。
名前 | 型 | 説明 |
---|---|---|
AE |
string |
アラブ首長国連邦、AE |
AR |
string |
アルゼンチン (アルゼンチン ビュー) |
Auto |
string |
要求の IP アドレスに基づいてマップ データを返します。 |
BH |
string |
バーレーン (アラビアのビュー) |
IN |
string |
インド (インド ビュー) |
IQ |
string |
イラク (アラビアのビュー) |
JO |
string |
ヨルダン (アラビアのビュー) |
KW |
string |
クウェート (アラビアのビュー) |
LB |
string |
レバノン (アラビアのビュー) |
MA |
string |
モロッコ (モロッコのビュー) |
OM |
string |
オマーン (アラビアのビュー) |
PK |
string |
パキスタン (パキスタンのビュー) |
PS |
string |
パレスチナ自治政府 (アラビアのビュー) |
QA |
string |
カタール (アラビアのビュー) |
SA |
string |
サウジアラビア (アラビアのビュー) |
SY |
string |
シリア (アラビアのビュー) |
Unified |
string |
統一されたビュー (その他) |
YE |
string |
イエメン (アラビアのビュー) |
MapTileLayer
要求されたマップ レイヤー。 使用できる値は、基本、ハイブリッド、ラベル、terra です。
名前 | 型 | 説明 |
---|---|---|
basic |
string |
ポリゴン、境界線、道路、ラベルを含むすべてのマップ フィーチャを含むタイルを返します。 |
hybrid |
string |
罫線、道路、ラベルを含むタイルを返し、他のタイル (衛星画像など) に重ねてハイブリッド タイルを生成できます。 |
labels |
string |
マップのラベル情報のみのタイルを返します。 |
terra |
string |
網掛けされたレリーフ タイルで完成したマップ キャンバス。 ズーム レベル 0 ~ 6 (含む) がサポートされています。 Png は、サポートされている唯一の TileFormat であり、使用可能な MapTileSize のみ 512 です。 |
MapTileSize
返されるマップ タイルのサイズ (ピクセル単位)。
名前 | 型 | 説明 |
---|---|---|
256 |
string |
256 x 256 ピクセルのタイルを返します。 |
512 |
string |
512 x 512 ピクセルのタイルを返します。 |
MapTileStyle
返されるマップ スタイル。 指定できる値は、メイン、濃色、shaded_reliefです。
名前 | 型 | 説明 |
---|---|---|
dark |
string |
Azure Maps メイン スタイルの濃い灰色のバージョン。 PNG は、サポートされている TileFormat のみです。 |
main |
string |
Azure Maps メイン スタイル |
shaded_relief |
string |
Azure Maps メインスタイルは影付きレリーフで完成しました。 レイヤー terra でサポートされます。 |
TileFormat
応答の目的の形式。 指定できる値は png & pbf です。
名前 | 型 | 説明 |
---|---|---|
pbf |
string |
pbf 形式のベクター グラフィック。 ズーム レベル 0 ~ 22 をサポートします。 |
png |
string |
png 形式の画像。 ズーム レベル 0 ~ 18 をサポートします。 |