Render - Get Map Imagery Tile
傳回大小為 256x256 的地圖影像圖格，指定 x 和 y 座標和縮放層級，範圍從 1 到 19。
注意
Azure 地圖服務 轉譯 v1 服務淘汰
Azure 地圖服務 Render v1 服務現在已被取代，將於 9/17/26 淘汰。 為了避免服務中斷，所有轉譯 v1 API 的呼叫都必須更新為使用 轉譯 v2 API 9/17/26。
目前的可用樣式值是「衛星」，單獨提供衛星影像。
注意：建議您開始使用新的 取得地圖底圖 V2 API。
GET https://atlas.microsoft.com/map/imagery/png?api-version=1.0&style=satellite&zoom={zoom}&x={x}&y={y}URI 參數
| 名稱 | 位於 | 必要 | 類型 | Description |
|---|---|---|---|---|
|
format
|
path | True |
所需的回應格式。 可能的值：png。 |
|
|
api-version
|
query | True |
string |
Azure 地圖服務 API 的版本號碼。 |
|
style
|
query | True |
要傳回的對應樣式。 可能的值： 衛星。 |
|
|
x
|
query | True |
integer int32 |
縮放方格上磚的 X 座標。 值必須位於 [0， 2 如需詳細資訊，請參閱 縮放層級和磚網格 線。 |
|
y
|
query | True |
integer int32 |
縮放方格上磚的 Y 座標。 值必須位於 [0， 2 如需詳細資訊，請參閱 縮放層級和磚網格 線。 |
|
zoom
|
query | True |
integer int32 |
所需磚的縮放層級。 如需詳細資訊，請參閱 縮放層級和磚網格 線。 |
要求標頭
| 名稱 | 必要 | 類型 | Description |
|---|---|---|---|
| x-ms-client-id |
string |
指定哪個帳戶與 Microsoft Entra ID 安全性模型搭配使用。 它代表 Azure 地圖服務 帳戶的唯一標識符，可以從 Azure 地圖服務 管理平面帳戶 API 擷取。 若要在 Azure 地圖服務 中使用 Microsoft Entra ID 安全性，請參閱下列文章以取得指引。 |
回應
| 名稱 | 類型 | Description |
|---|---|---|
| 200 OK |
object |
從成功的取得地圖影像磚呼叫傳回此影像 Media Types: "application/json", "image/jpeg", "image/png" 標題 Content-Type: string |
| Other Status Codes |
發生意外錯誤。 Media Types: "application/json", "image/jpeg", "image/png" |
安全性
AADToken
這些是 Microsoft Entra OAuth 2.0 流程。 與 Azure 角色型存取控制配對時，可用來控制對 REST API 的存取 Azure 地圖服務。 Azure 角色型訪問控制可用來指定一或多個 Azure 地圖服務 資源帳戶或子資源的存取權。 任何使用者、群組或服務主體都可以透過內建角色或由一或多個許可權組成的自定義角色來授與存取權，以 Azure 地圖服務 REST API。
若要實作案例，建議您檢視 驗證概念。 總而言之，此安全性定義提供一個解決方案，可透過能夠針對特定 API 和範圍進行存取控制的物件，將應用程式模型化 () 。
備註
- 此安全性定義需要使用
x-ms-client-id標頭來指出應用程式要求存取權 Azure 地圖服務 資源。 這可以從 地圖服務管理 API 取得。
Authorization URL專屬於 Azure 公用雲端實例。 主權雲端具有唯一的授權 URL 和 Microsoft Entra ID 設定。
* 透過 Azure 入口網站、PowerShell、CLI、Azure SDK 或 REST API，從 Azure 管理平面設定 Azure 角色型存取控制。
* Azure 地圖服務 Web SDK 的使用方式允許針對多個使用案例設定應用程式。
- 如需 Microsoft 身分識別平台 的詳細資訊，請參閱 Microsoft 身分識別平台 概觀。
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
| 名稱 | Description |
|---|---|
| https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
這是當您在 Azure 入口網站 或使用 PowerShell、CLI、Azure SDK 或 REST API 中建立 Azure 地圖服務 帳戶時所佈建的共享密鑰。
使用此金鑰時，任何應用程式都可以存取所有 REST API。 換句話說，此金鑰可作為發行帳戶中的主要金鑰。
對於公開的應用程式，我們建議使用機密用戶端應用程式方法來存取 Azure 地圖服務 REST API，以便安全地儲存密鑰。
類型:
apiKey
位於:
query
SAS Token
這是透過 Azure 管理平面透過 Azure 入口網站、PowerShell、CLI、Azure SDK 或 REST API，從 Azure 地圖服務 資源上的清單 SAS 作業建立共用存取簽章令牌。
使用此令牌時，任何應用程式都有權使用 Azure 角色型訪問控制進行存取，並精細控制到期、速率和區域 (特定令牌的使用) 。 換句話說，SAS 令牌可用來允許應用程式以比共用密鑰更安全的方式控制存取。
對於公開的應用程式，我們建議在 地圖帳戶資源 上設定允許的來源特定清單，以限制轉譯濫用，並定期更新 SAS 令牌。
類型:
apiKey
位於:
header
範例
Successful Imagery Tile Request
範例要求
GET https://atlas.microsoft.com/map/imagery/png?api-version=1.0&style=satellite&zoom=6&x=10&y=22
範例回覆
Content-Type: image/png"{file}"定義
| 名稱 | Description |
|---|---|
|
Error |
資源管理錯誤其他資訊。 |
|
Error |
錯誤詳細數據。 |
|
Error |
錯誤回應 |
|
Map |
要傳回的對應樣式。 可能的值： 衛星。 |
|
Raster |
所需的回應格式。 可能的值：png。 |
ErrorAdditionalInfo
資源管理錯誤其他資訊。
| 名稱 | 類型 | Description |
|---|---|---|
| info |
object |
其他資訊。 |
| type |
string |
其他信息類型。 |
ErrorDetail
錯誤詳細數據。
| 名稱 | 類型 | Description |
|---|---|---|
| additionalInfo |
錯誤其他資訊。 |
|
| code |
string |
錯誤碼。 |
| details |
錯誤詳細資料。 |
|
| message |
string |
錯誤訊息。 |
| target |
string |
錯誤目標。 |
ErrorResponse
錯誤回應
| 名稱 | 類型 | Description |
|---|---|---|
| error |
error 物件。 |
MapImageryStyle
要傳回的對應樣式。 可能的值： 衛星。
| 名稱 | 類型 | Description |
|---|---|---|
| satellite |
string |
衛星影像 |
RasterTileFormat
所需的回應格式。 可能的值：png。
| 名稱 | 類型 | Description |
|---|---|---|
| png |
string |
png 格式的影像。 支援縮放層級 0 到 18。 |