Traffic - Get Traffic Incident Tile
を使用して、トラフィック インシデントを示す 256 x 256 ピクセルのタイルを取得します。
Traffic Incident Tile
API は、トラフィック インシデントを示す 256 x 256 ピクセル タイルを返す HTTP GET
要求です。 すべてのタイルで同じグリッド システムが使用されます。 トラフィック タイルは透明な画像を使用するため、マップ タイルの上にレイヤー化して複合表示を作成できます。 トラフィック タイルは、指定されたエリア内の道路上のトラフィックを示すグラフィックスをレンダリングします。
GET https://atlas.microsoft.com/traffic/incident/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}
GET https://atlas.microsoft.com/traffic/incident/tile/{format}?api-version=1.0&style={style}&zoom={zoom}&x={x}&y={y}&t={t}
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
format
|
path | True |
応答の目的の形式。 指定できる値は png & pbf です。 |
|
api-version
|
query | True |
string |
Azure Maps API のバージョン番号。 |
style
|
query | True |
タイルのレンダリングに使用するスタイル。 format が pbf の場合、このパラメーターは無効です。 |
|
x
|
query | True |
integer int32 |
ズーム グリッド上のタイルの X 座標。 値は [0, 2 詳細については、「 ズーム レベルとタイル グリッド 」を参照してください。 |
y
|
query | True |
integer int32 |
ズーム グリッド上のタイルの Y 座標。 値は [0, 2 詳細については、「 ズーム レベルとタイル グリッド 」を参照してください。 |
zoom
|
query | True |
integer int32 |
目的のタイルのズーム レベル。 ラスター タイルの場合、値の範囲は 0 から 22 (両端を含む) である必要があります。 ベクター タイルの場合、値の範囲は 0 から 22 (両端を含む) である必要があります。 詳細については、「 ズーム レベルとタイル グリッド 」を参照してください。 |
t
|
query |
string |
trafficState フィールドの Viewport API 呼び出し trafficModelId 属性から取得された、特定の時刻のトラフィックの状態の参照値。 1 分ごとに更新され、タイムアウトする前に 2 分間有効です。最新のトラフィック情報を取得するには、-1 を使用します。 既定値: 最新のトラフィック情報。 |
要求ヘッダー
名前 | 必須 | 型 | 説明 |
---|---|---|---|
x-ms-client-id |
string |
Microsoft Entra ID セキュリティ モデルと組み合わせて使用するアカウントを指定します。 Azure Maps アカウントの一意の ID を表し、Azure Maps管理プレーン アカウント API から取得できます。 Azure MapsでMicrosoft Entra IDセキュリティを使用するには、次の記事を参照してください。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
object |
このオブジェクトは、成功した Traffic Incident Tile 呼び出しから返されます 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
例
Request a tile depicting a traffic incident
Sample Request
GET https://atlas.microsoft.com/traffic/incident/tile/png?api-version=1.0&style=night&zoom=10&x=175&y=408
Sample Response
{}
定義
名前 | 説明 |
---|---|
Error |
リソース管理エラーの追加情報。 |
Error |
エラーの詳細。 |
Error |
エラー応答 |
Tile |
応答の目的の形式。 指定できる値は png & pbf です。 |
Traffic |
タイルのレンダリングに使用するスタイル。 format が pbf の場合、このパラメーターは無効です。 |
ErrorAdditionalInfo
リソース管理エラーの追加情報。
名前 | 型 | 説明 |
---|---|---|
info |
object |
追加情報。 |
type |
string |
追加情報の種類。 |
ErrorDetail
エラーの詳細。
名前 | 型 | 説明 |
---|---|---|
additionalInfo |
エラーの追加情報。 |
|
code |
string |
エラー コード。 |
details |
エラーの詳細です。 |
|
message |
string |
エラー メッセージ。 |
target |
string |
エラーのターゲット。 |
ErrorResponse
エラー応答
名前 | 型 | 説明 |
---|---|---|
error |
error オブジェクト。 |
TileFormat
応答の目的の形式。 指定できる値は png & pbf です。
名前 | 型 | 説明 |
---|---|---|
pbf |
string |
pbf 形式のベクター グラフィック。 ズーム レベル 0 ~ 22 をサポートします。 |
png |
string |
png 形式の画像。 ズーム レベル 0 ~ 18 をサポートします。 |
TrafficIncidentTileStyle
タイルのレンダリングに使用するスタイル。 format が pbf の場合、このパラメーターは無効です。
名前 | 型 | 説明 |
---|---|---|
night |
string |
夜のスタイル。 |
s1 |
string |
重大度を示す色付きのシェブロンを含む交通線を作成します。 |
s2 |
string |
ある程度の光彩を持つプレーンな線を作成します。 |
s3 |
string |
s2 スタイルとは異なる、ある程度の光彩を持つプレーンな線を作成します。 |