Traffic - Get Traffic Flow Tile

服務:

Maps

API 版本:

1.0

用來取得顯示流量流量的 256 x 256 像素磚。

Traffic Flow Tile API 是 HTTP GET 要求，會傳回 256 x 256 像素磚中顯示流量流量的流量條件實時資訊。 所有磚都會使用相同的網格線系統。 因為交通圖格使用透明影像，所以可以在地圖底圖頂端分層，以建立復合顯示。 Flow 圖格會使用色彩來指出不同道路區段的交通速度，或該速度與有問題的道路區段自由流量速度之間的差異。

GET https://atlas.microsoft.com/traffic/flow/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}

含選擇性參數:

GET https://atlas.microsoft.com/traffic/flow/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}&thickness={thickness}

URI 參數

名稱	位於	必要	類型	Description
format	path	True	TileFormat	所需的回應格式。 可能的值為 png & pbf。
api-version	query	True	string	Azure 地圖服務 API 的版本號碼。
style	query	True	TrafficFlowTileStyle	用來呈現磚的樣式。
x	query	True	integer int32	縮放方格上磚的 X 座標。 值必須位於 [0， 2zoom -1] 範圍內。 如需詳細資訊，請參閱 縮放層級和磚網格 線。
y	query	True	integer int32	縮放方格上磚的 Y 座標。 值必須位於 [0， 2zoom -1] 範圍內。 如需詳細資訊，請參閱 縮放層級和磚網格 線。
zoom	query	True	integer int32	所需磚的縮放層級。 針對 點陣 圖格，值必須位於範圍：0-22 (內含) 。 對於 向量 磚，值必須位於範圍：0-22 (內含) 。 如需詳細資訊，請參閱 縮放層級和磚網格 線。
thickness	query		integer int32	代表流量之線條寬度的值。 這個值是乘數，接受的值範圍從 1 到 20。 預設值是 10。 當格式為 pbf 時，此參數無效。

要求標頭

名稱	必要	類型	Description
x-ms-client-id		string	指定哪一個帳戶用於搭配 Microsoft Entra ID 安全性模型使用。 它代表 Azure 地圖服務帳戶的唯一標識碼，而且可以從 Azure 地圖服務管理平面帳戶 API 擷取。 若要在 Azure 地圖服務中使用 Microsoft 專案標識碼安全性，請參閱下列 文章 以取得指引。

回應

名稱	類型	Description
200 OK	object	此影像會從成功的流量圖格呼叫傳回 Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile" 標題 Content-Type: string
Other Status Codes	ErrorResponse	發生意外錯誤。 Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

安全性

AADToken

這些是 entra OAuth 2.0 Flow Microsoft 。 與 Azure 角色型存 取控制配對時，可用來控制對 Azure 地圖服務 REST API 的存取。 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 入口網站中 建立 Azure 地圖服務帳戶 或使用 PowerShell、CLI、Azure SDK 或 REST API 時所佈建的共用密鑰。

使用此金鑰時，任何應用程式都可以存取所有 REST API。 換句話說，此金鑰可作為發行帳戶中的主要金鑰。

對於公開的應用程式，我們建議使用 機密用戶端應用程式 方法來存取 Azure 地圖服務 REST API，以便安全地儲存您的密鑰。

類型: apiKey
位於: query

SAS Token

這是透過 Azure 入口網站、PowerShell、CLI、Azure SDK 或 REST API，從 Azure 地圖服務資源 上的清單 SAS 作業建立共用存取簽章令牌。

使用此令牌時，任何應用程式都有權使用 Azure 角色型訪問控制進行存取，並精細控制到期、速率和區域 (特定令牌的使用) 。 換句話說，SAS 令牌可用來允許應用程式以比共用密鑰更安全的方式控制存取。

對於公開的應用程式，我們建議在 地圖帳戶資源 上設定允許的來源特定清單，以限制轉譯濫用，並定期更新 SAS 令牌。

類型: apiKey
位於: header

範例

Request tile depicting the traffic flow

範例要求

HTTP

GET https://atlas.microsoft.com/traffic/flow/tile/png?api-version=1.0&style=absolute&zoom=12&x=2044&y=1360

範例回覆

狀態碼:

200

"binary string image"

定義

名稱	Description
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
TileFormat	所需的回應格式。 可能的值為 png & pbf。
TrafficFlowTileStyle	用來呈現磚的樣式。

ErrorAdditionalInfo

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細資料。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

TileFormat

所需的回應格式。 可能的值為 png & pbf。

名稱	類型	Description
pbf	string	pbf 格式的向量圖形。 支援縮放層級 0 到 22。
png	string	png 格式的影像。 支援縮放層級 0 到 18。

TrafficFlowTileStyle

用來呈現磚的樣式。

名稱	類型	Description
absolute	string	色彩會反映測量的絕對速度。 絕對速度是存取完整速度的功能。
reduced-sensitivity	string	顯示相對色彩，但需要與手繪多邊形較大的差異，區段才能變更色彩。 只有在格式為 png 時，此模式才有效。
relative	string	這是相對於自由流量的速度，醒目提示將交通流量可視化的壅塞區域。 自由流量是指沒有壅塞的情況，而流量可以遵循速度限制。 用來在地圖上可視化交通流量的最常用選項。
relative-delay	string	只顯示與自由流程速度不同的相對色彩。 此選項只會強調壅塞的區域。