Traffic - Get Traffic Flow Tile

サービス:

Maps

API バージョン:

1.0

トラフィック フローを示す 256 x 256 ピクセルのタイルを取得するには、 を使用します。

Traffic Flow Tile API は、トラフィック フローを示す 256 x 256 ピクセル タイルのトラフィック状態に関するリアルタイム情報を返す HTTP GET 要求です。 すべてのタイルで同じグリッド システムが使用されます。 トラフィック タイルは透明な画像を使用するため、マップ タイルの上にレイヤー化して複合表示を作成できます。 フロー タイルでは、色を使用して、異なる道路セグメントでのトラフィックの速度、またはその速度と問題の道路セグメントのフリーフロー速度の差を示します。

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 パラメーター

名前	/	必須	型	説明
format	path	True	TileFormat	応答の目的の形式。 指定できる値は png & pbf です。
api-version	query	True	string	Azure Maps 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 です。 format が pbf の場合、このパラメーターは無効です。

要求ヘッダー

名前	必須	型	説明
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" ヘッダー Content-Type: string
Other Status Codes	ErrorResponse	予期しないエラーが発生しました。 Media Types: "application/json", "image/jpeg", "image/png", "image/pbf", "application/vnd.mapbox-vector-tile"

セキュリティ

AADToken

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

シナリオを実装するには、 認証の概念を表示することをお勧めします。 要約すると、このセキュリティ定義は、特定の 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 プラットフォームの概要」を参照してください。

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

スコープ

名前	説明
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 にアクセスすることをお勧めします。

型: apiKey
/: query

SAS Token

これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を使用して、Azure 管理プレーンを介して Azure Maps リソース の SAS の一覧表示操作から作成される共有アクセス署名トークンです。

このトークンを使用すると、すべてのアプリケーションが Azure ロールベースのアクセス制御を使用してアクセスし、特定のトークンに使用される有効期限、レート、およびリージョンをきめ細かく制御できます。 つまり、SAS トークンを使用して、アプリケーションが共有キーよりもセキュリティで保護された方法でアクセスを制御できるようにします。

公開されているアプリケーションの場合、 Map アカウント リソース で許可される配信元の特定の一覧を構成して、レンダリングの不正使用を制限し、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"

定義

名前	説明
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
TileFormat	応答の目的の形式。 指定できる値は png & pbf です。
TrafficFlowTileStyle	タイルのレンダリングに使用するスタイル。

ErrorAdditionalInfo

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

名前	型	説明
info	object	追加情報。
type	string	追加情報の種類。

ErrorDetail

エラーの詳細。

名前	型	説明
additionalInfo	ErrorAdditionalInfo[]	エラーの追加情報。
code	string	エラー コード。
details	ErrorDetail[]	エラーの詳細です。
message	string	エラー メッセージ。
target	string	エラーのターゲット。

ErrorResponse

エラー応答

名前	型	説明
error	ErrorDetail	error オブジェクト。

TileFormat

応答の目的の形式。 指定できる値は png & pbf です。

名前	型	説明
pbf	string	pbf 形式のベクター グラフィック。 ズーム レベル 0 ~ 22 をサポートします。
png	string	png 形式の画像。 ズーム レベル 0 ~ 18 をサポートします。

TrafficFlowTileStyle

タイルのレンダリングに使用するスタイル。

名前	型	説明
absolute	string	色は測定された絶対速度を反映します。 絶対速度はフルスピードにアクセスする機能です。
reduced-sensitivity	string	相対色を表示しますが、セグメントで色を変更するにはフリーフローとの大きな違いが必要です。 このモードは、format が png の場合にのみ有効です。
relative	string	これはフリーフローに対する速度であり、トラフィック フローを視覚化する輻輳の領域が強調されています。 フリーフローとは、輻輳がなく、トラフィックが制限速度に従うことができる条件を指します。 マップ上のトラフィック フローを視覚化するために最も使用されるオプション。
relative-delay	string	相対色は、フリーフロー速度と異なる場合にのみ表示されます。 このオプションでは、輻輳の領域のみが強調表示されます。