次の方法で共有

Traffic - Get Traffic Incident Tile

  • リファレンス
サービス:
Maps
API バージョン:
1.0

トラフィック インシデントを示す 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

TileFormat

応答の目的の形式。 指定できる値は png & pbf です。
api-version
 query True

string

Azure Maps API のバージョン番号。
style
 query True

TrafficIncidentTileStyle

タイルのレンダリングに使用するスタイル。 形式が pbf の場合、このパラメーターは無効です。
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 (両端を含む) である必要があります。 詳細については、「ズーム レベルとタイル グリッドの」を参照してください。
t
 query

string

特定の時刻におけるトラフィックの状態の参照値。Viewport API 呼び出しから取得され、trafficState フィールドの 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"

ヘッダー

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 とスコープに対するアクセス制御が可能なオブジェクトを介してアプリケーションをモデル化するためのソリューションを提供します。

注記

  • このセキュリティ定義 使用して、アプリケーションがアクセスを要求している 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 を使用すると、複数のユース ケースに対するアプリケーションの構成ベースのセットアップが可能になります。

型: 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 で、または PowerShell、CLI、Azure SDK、または REST API を使用して Azure Maps アカウント を作成 場合にプロビジョニングされる共有キーです。

このキーを使用すると、すべてのアプリケーションがすべての REST API にアクセスできます。 つまり、このキーは、発行されたアカウントのマスター キーとして使用できます。

パブリックに公開されているアプリケーションの場合は、キーを安全に格納できるように、機密クライアント アプリケーション アプローチを使用して Azure Maps REST API にアクセスすることをお勧めします。

型: apiKey
/: query

SAS Token

これは、Azure portal、PowerShell、CLI、Azure SDK、または REST API を介して Azure 管理プレーンを介して、Azure Maps リソース のリスト SAS 操作から作成される Shared Access Signature トークンです。

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

パブリックに公開されているアプリケーションの場合は、Map アカウント リソースの許可された配信元の特定の一覧を構成し、レンダリングの不正使用を制限し、SAS トークンを定期的に更新するように することをお勧めします。

型: apiKey
/: header

例

Request a tile depicting a traffic incident

要求のサンプル

GET https://atlas.microsoft.com/traffic/incident/tile/png?api-version=1.0&style=night&zoom=10&x=175&y=408

応答のサンプル

状態コード:
200 
{}

定義

名前 説明
ErrorAdditionalInfo

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

エラーの詳細。
ErrorResponse

エラー応答
TileFormat

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

タイルのレンダリングに使用するスタイル。 形式が pbf の場合、このパラメーターは無効です。

ErrorAdditionalInfo

Object

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

名前 型 説明
info

object

追加情報。
type

string

追加情報の種類。

ErrorDetail

Object

エラーの詳細。

名前 型 説明
additionalInfo

ErrorAdditionalInfo[]

エラーの追加情報。
code

string

エラー コード。
details

ErrorDetail[]

エラーの詳細。
message

string

エラー メッセージ。
target

string

エラーターゲット。

ErrorResponse

Object

エラー応答

名前 型 説明
error

ErrorDetail

エラー オブジェクト。

TileFormat

列挙

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

値 説明
pbf

pbf 形式のベクター グラフィック。 ズーム レベル 0 ~ 22 をサポートします。
png

png 形式の画像。 ズーム レベル 0 から 18 をサポートします。

TrafficIncidentTileStyle

列挙

タイルのレンダリングに使用するスタイル。 形式が pbf の場合、このパラメーターは無効です。

値 説明
night

夜のスタイル。
s1

重大度を示す色付きのシェブロンを含むトラフィック ラインを作成します。
s2

ある程度の光彩を持つプレーンな線を作成します。
s3

s2 スタイルとは異なる、ある程度の光彩を持つプレーンな線を作成します。