Traffic - Get Traffic Incident Detail

リファレンス

サービス:: Maps

API バージョン:: 1.0

特定の境界ボックス内のトラフィックインシデントに関する情報を取得するために使用します。

Traffic Incident Detail API は、現在の Traffic Model IDに基づいて、特定の境界ボックス内のトラフィックインシデントに関する情報を提供する HTTP GET 要求です。トラフィックモデル ID は、呼び出しと API の間でデータの同期を許可するために使用できます。トラフィックモデル ID は、トラフィックインシデントの通貨を決定するための重要な値です。これは 1 分ごとに更新され、タイムアウトする前に 2 分間有効です。これは、インシデントタイルレンダリングで使用されます。これは、Viewport API から取得できます。

GET https://atlas.microsoft.com/traffic/incident/detail/{format}?api-version=1.0&style={style}&boundingbox={boundingbox}&boundingZoom={boundingZoom}&trafficmodelid={trafficmodelid}

省略可能なパラメーターを含む:

GET https://atlas.microsoft.com/traffic/incident/detail/{format}?api-version=1.0&style={style}&boundingbox={boundingbox}&boundingZoom={boundingZoom}&trafficmodelid={trafficmodelid}&language={language}&projection={projection}&geometries={geometries}&expandCluster={expandCluster}&originalPosition={originalPosition}

URI パラメーター

名前	/	必須	型	説明
format	path	True	ResponseFormat	応答の目的の形式。値は、json することも、xml することもできます。
api-version	query	True	string	Azure Maps API のバージョン番号。
boundingbox	query	True	number[]	`boundingbox` は、角を記述する 2 つの値ペア (左下隅の場合は最初のペア、右上は 2 つ目) で表されます。ペアは、以下で指定した `projection`のいずれかを使用して指定できます (例: minY、minX、maxY、maxX ) または 2 つの緯度と経度のペア (例: minLat、minLon、maxLat、maxLon)。注: 緯度と経度のペアを使用する場合は、`projection` パラメーターを "EPSG4326" に設定する必要があります。
boundingZoom	query	True	integer (int32) minimum: 0 maximum: 22	目的のタイルのズームレベル。ラスタータイルの場合は 0 から 22、ベクタータイルの場合は 0 から 22
style	query	True	IncidentDetailStyle	Traffic Incident Tile API でタイルをレンダリングするために使用されるスタイル。これは、応答内のトラフィックインシデントの座標に影響します。
trafficmodelid	query	True	string	トラフィックモデルを参照する番号。これは、Viewport API から取得できます。これは 1 分ごとに更新され、タイムアウトする前に 2 分間有効です。間違ったトラフィックモデル ID が指定されている場合は、インターフェイスから正しい ID が返されます。 -1 の値は常に最新のトラフィックモデルを呼び出します
expandCluster	query		boolean	クラスター内のすべてのトラフィックインシデントを個別に一覧表示するかどうかを示すブール値
geometries	query		IncidentGeometryType	インシデントに追加されたベクタージオメトリの型 (応答の要素で返されます)。
language	query		string	出力言語の ISO 639-1 コードをします。サポートされている言語は、ar、ca、cs、da、de、el、en、en-GB、en-US、es、et、fi、fr、he、hu、id、in*、it、lt、lv、nb、nl、no、pl、pt、ro、ru、sk、sv、th、tr、zh です。詳細については、サポートされている言語のを参照してください。無効な言語コードが指定されると、応答が英語で返されます。インシデントの原因または説明に翻訳がない場合は、英語の説明が返されます。
originalPosition	query		boolean	インシデント () の元の位置と、トラフィックチューブの先頭にシフトされた位置 () を返すかどうかを示すブール値
projection	query		ProjectionStandard	要求と応答の座標を指定するために使用されるプロジェクション。 EPSG900913 (既定) または EPSG4326

要求ヘッダー

名前	必須	型	説明
x-ms-client-id		string	Microsoft Entra ID セキュリティモデルと組み合わせて使用するアカウントを指定します。これは Azure Maps アカウントの一意の ID を表し、Azure Maps 管理プレーンアカウント API から取得できます。 Azure Maps で Microsoft Entra ID セキュリティを使用するには、ガイダンス次の記事を参照してください。

応答

名前	型	説明
200 OK	TrafficIncidentDetail	わかりました
Other Status Codes	ErrorResponse	予期しないエラーが発生しました。

セキュリティ

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 を使用すると、複数のユースケースに対するアプリケーションの構成ベースのセットアップが可能になります。

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 で、または 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 information about a traffic incident

要求のサンプル

HTTP

GET https://atlas.microsoft.com/traffic/incident/detail/json?api-version=1.0&style=s3&boundingbox=6841263.950712,511972.674418,6886056.049288,582676.925582&boundingZoom=11&trafficmodelid=1335294634919

応答のサンプル

状態コード:: 200

{
  "tm": {
    "@id": "1521671948910",
    "poi": [
      {
        "id": "europe_HD_NL_TTR116377227776064",
        "p": {
          "x": 538636.9,
          "y": 6842004.5
        },
        "ic": 9,
        "ty": 1,
        "cs": 0,
        "d": "roadworks",
        "c": "new roadworks layout",
        "f": "Amstelveen/Vinkeveen - N201 (N196)",
        "t": "Uithoorn-Centrum (N196)",
        "l": 220,
        "dl": 14,
        "r": "N196"
      },
      {
        "id": "europe_CLUSTER_11_-34959639",
        "p": {
          "x": 528668.6,
          "y": 6848897.9
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 528622.5,
          "y": 6848661.2
        },
        "ctr": {
          "x": 528714.7,
          "y": 6849134.6
        },
        "cs": 2,
        "l": 190
      },
      {
        "id": "europe_CLUSTER_11_-1540737434",
        "p": {
          "x": 518277,
          "y": 6852206.8
        },
        "ic": 9,
        "ty": 1,
        "cbl": {
          "x": 517421.3,
          "y": 6851776.4
        },
        "ctr": {
          "x": 519132.8,
          "y": 6852637.2
        },
        "cs": 2,
        "l": 1620
      },
      {
        "id": "europe_CLUSTER_11_-26712906",
        "p": {
          "x": 529902.2,
          "y": 6855622.4
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 529524.6,
          "y": 6855377.2
        },
        "ctr": {
          "x": 530279.9,
          "y": 6855867.7
        },
        "cs": 4,
        "l": 660
      },
      {
        "id": "europe_HD_NL_TTR116367997504816",
        "p": {
          "x": 568216,
          "y": 6851287.6
        },
        "ic": 9,
        "ty": 1,
        "cs": 0,
        "d": "roadworks",
        "c": "new roadworks layout",
        "f": "Ankeveen (N236)",
        "t": "Weesp (N236)",
        "l": 2760,
        "dl": 73,
        "r": "N236"
      },
      {
        "id": "europe_HD_NL_TTR116367997261488",
        "p": {
          "x": 561973.7,
          "y": 6854259.4
        },
        "ic": 9,
        "ty": 3,
        "cs": 0,
        "d": "roadworks",
        "c": "new roadworks layout",
        "f": "Weesp (N236)",
        "t": "Ankeveen (N236)",
        "l": 2650,
        "r": "N236"
      },
      {
        "id": "europe_HD_NL_TTR116331064819392",
        "p": {
          "x": 571268.5,
          "y": 6858435.4
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "IJsselmeerweg",
        "t": "A6",
        "l": 370
      },
      {
        "id": "europe_CLUSTER_11_-1442937814",
        "p": {
          "x": 563934,
          "y": 6859271.3
        },
        "ic": 9,
        "ty": 1,
        "cbl": {
          "x": 563726.1,
          "y": 6859250.4
        },
        "ctr": {
          "x": 564141.9,
          "y": 6859292.2
        },
        "cs": 2,
        "l": 460
      },
      {
        "id": "europe_CLUSTER_11_258400781",
        "p": {
          "x": 558055.6,
          "y": 6861147.1
        },
        "ic": 13,
        "ty": 1,
        "cbl": {
          "x": 557493.3,
          "y": 6860514.8
        },
        "ctr": {
          "x": 558618,
          "y": 6861779.4
        },
        "cs": 3,
        "l": 1030
      },
      {
        "id": "europe_HD_NL_TTR116100227865681",
        "p": {
          "x": 542665,
          "y": 6861959.7
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "Strawinskylaan",
        "t": "Matthijs Vermeulenpad",
        "l": 110
      },
      {
        "id": "europe_CLUSTER_11_1438243625",
        "p": {
          "x": 545058.7,
          "y": 6864571.6
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 543779.5,
          "y": 6864070.7
        },
        "ctr": {
          "x": 546337.8,
          "y": 6865072.6
        },
        "cs": 5,
        "l": 1590
      },
      {
        "id": "europe_HD_NL_TTR116081762316976",
        "p": {
          "x": 547507.8,
          "y": 6866259.3
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "Alexanderplein (s113)",
        "t": "Stadhouderskade",
        "l": 390,
        "r": "S100"
      },
      {
        "id": "europe_CLUSTER_11_691732516",
        "p": {
          "x": 541448.7,
          "y": 6867162.1
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 541160.1,
          "y": 6866710.7
        },
        "ctr": {
          "x": 541737.2,
          "y": 6867613.5
        },
        "cs": 4,
        "l": 430
      },
      {
        "id": "europe_CLUSTER_11_1582351486",
        "p": {
          "x": 534709.6,
          "y": 6865174.7
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 534562.2,
          "y": 6865025.3
        },
        "ctr": {
          "x": 534856.9,
          "y": 6865324.2
        },
        "cs": 2,
        "l": 380
      },
      {
        "id": "europe_CLUSTER_11_-2070222267",
        "p": {
          "x": 536813.1,
          "y": 6868188.3
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 536191.1,
          "y": 6867699.7
        },
        "ctr": {
          "x": 537435.1,
          "y": 6868677
        },
        "cs": 7,
        "l": 1380
      },
      {
        "id": "europe_CLUSTER_11_-496866890",
        "p": {
          "x": 516025.5,
          "y": 6871606.3
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 514115.1,
          "y": 6870216.9
        },
        "ctr": {
          "x": 517935.9,
          "y": 6872995.7
        },
        "cs": 7,
        "l": 1510
      },
      {
        "id": "europe_HD_NL_TTR115675492352160",
        "p": {
          "x": 517835.3,
          "y": 6883216.3
        },
        "ic": 8,
        "ty": 4,
        "cs": 0,
        "d": "closed",
        "f": "Amsterdamseweg",
        "t": "A22",
        "l": 710
      },
      {
        "id": "europe_CLUSTER_11_834920993",
        "p": {
          "x": 543803.8,
          "y": 6875659.8
        },
        "ic": 8,
        "ty": 0,
        "cbl": {
          "x": 543474.7,
          "y": 6875602.7
        },
        "ctr": {
          "x": 544133,
          "y": 6875716.9
        },
        "cs": 2,
        "l": 760
      }
    ]
  }
}

定義

名前	説明
DelayMagnitude	インシデントに関連する遅延の大きさ。これらの値は、トラフィックタイルのインシデントの色に対応します
ErrorAdditionalInfo	リソース管理エラーの追加情報。
ErrorDetail	エラーの詳細。
ErrorResponse	エラー応答
IconCategory	このインシデントに関連付けられているアイコンカテゴリ。値は 0 から 13 の範囲の数値で、意味は次のとおりです。- 0: Unknown、1: Accident、2: Fog、3: Dangerous Conditions、4: Rain、5: Ice、6: Jam、7: Lane Closed、8: Road Closed、9: Road Works、10: Wind、11: Flooding、12: Detour、13: Cluster Cluster
IncidentDetailStyle	Traffic Incident Tile API でタイルをレンダリングするために使用されるスタイル。これは、応答内のトラフィックインシデントの座標に影響します。
IncidentGeometryType	インシデントに追加されたベクタージオメトリの型 (応答の要素で返されます)。
Point	デカルト平面内の座標 (x, y) を持つ点の一般的な表現。
ProjectionStandard	要求と応答の座標を指定するために使用されるプロジェクション。 EPSG900913 (既定) または EPSG4326
ResponseFormat	応答の目的の形式。値は、json することも、xml することもできます。
Tm	Main response 要素
TrafficIncidentDetail	このオブジェクトは、成功したトラフィックインシデントの詳細呼び出しから返されます
TrafficIncidentPointOfInterest

DelayMagnitude

列挙

インシデントに関連する遅延の大きさ。これらの値は、トラフィックタイルのインシデントの色に対応します

値	説明
0	不明
1	軽微
2	適度
3	少佐
4	無期限 (道路閉鎖およびその他の無期限の遅延に使用)

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

エラーの詳細。

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

ErrorResponse

Object

エラー応答

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

IconCategory

列挙

このインシデントに関連付けられているアイコンカテゴリ。値は 0 から 13 の範囲の数値で、意味は次のとおりです。- 0: Unknown、1: Accident、2: Fog、3: Dangerous Conditions、4: Rain、5: Ice、6: Jam、7: Lane Closed、8: Road Closed、9: Road Works、10: Wind、11: Flooding、12: Detour、13: Cluster Cluster

値	説明
0	不明
1	事故
10	風
11	冠水
12	回り道
13	クラスター: 異なるアイコンカテゴリを持つインシデントがクラスターに含まれている場合に返されます。
14	分解された車両
2	霧
3	危険な条件
4	雨
5	凍雨
6	ジャム
7	レーンクローズ
8	通行止め
9	道路工事

IncidentDetailStyle

列挙

Traffic Incident Tile API でタイルをレンダリングするために使用されるスタイル。これは、応答内のトラフィックインシデントの座標に影響します。

値	説明
night	夜のスタイル。
s1	重大度を示す色付きのシェブロンを含むトラフィックラインを作成します。
s2	ある程度の光彩を持つプレーンな線を作成します。
s3	s2 スタイルとは異なる、ある程度の光彩を持つプレーンな線を作成します。

IncidentGeometryType

列挙

インシデントに追加されたベクタージオメトリの型 (応答の要素で返されます)。

値	説明
original	インシデントを道路上に正確に配置します。
shifted	インシデントを (ズームレベルに応じて) 少し移動して、特定の道路レーンを示します。

Point

Object

デカルト平面内の座標 (x, y) を持つ点の一般的な表現。

名前	型	説明
x	number	x 座標
y	number	y 座標

ProjectionStandard

列挙

要求と応答の座標を指定するために使用されるプロジェクション。 EPSG900913 (既定) または EPSG4326

値	説明
EPSG4326	EPSG4326
EPSG900913	EPSG900913

ResponseFormat

列挙

応答の目的の形式。値は、json することも、xml することもできます。

値	説明
json	JavaScript オブジェクト表記データ交換形式をする
xml	拡張マークアップ言語をする

Tm

Object

Main response 要素

名前	型	説明
@id	string	このインシデントのトラフィックモデルの ID
poi	TrafficIncidentPointOfInterest[]	1 つのトラフィックインシデントまたはトラフィックインシデントのクラスター

TrafficIncidentDetail

Object

このオブジェクトは、成功したトラフィックインシデントの詳細呼び出しから返されます

名前	型	説明
tm	Tm	Main response 要素

TrafficIncidentPointOfInterest

Object

名前	型	説明
c	string	要求された言語でのインシデントの原因 (使用可能な場合)
cbl	Point	要求のプロジェクションにおけるクラスターの左下座標
cs	integer (int32)	クラスターサイズ: クラスター内のインシデントの数
ctr	Point	要求のプロジェクションにおけるクラスターの右上座標
d	string	要求された言語でのインシデントの説明
dl	integer (int32)	インシデントによる遅延 (道路閉鎖を除く)
ed	string (date-time)	インシデントの推定終了日 (使用可能な場合)。日付はISO8601形式で記述されます。
f	string	From: インシデントが原因でトラフィックが開始される交差点または場所の名前
ic	IconCategory (int32)	このインシデントに関連付けられているアイコンカテゴリ。値は 0 から 13 の範囲の数値で、意味は次のとおりです。- 0: Unknown、1: Accident、2: Fog、3: Dangerous Conditions、4: Rain、5: Ice、6: Jam、7: Lane Closed、8: Road Closed、9: Road Works、10: Wind、11: Flooding、12: Detour、13: Cluster Cluster
id	string	トラフィックインシデントの ID
l	integer (int32)	インシデントの長さ (メートル単位)
p	Point	クラスターまたは生インシデントのアイコンを描画する必要があるポイント。要求されたプロジェクションで表されます。これは、交通スタイル、ズームレベル、道路の種類の影響を受ける
r	string	インシデントの影響を受ける道路番号。複数の道路番号がスラッシュで区切られます
sd	string (date-time)	インシデントの開始日 (使用可能な場合)。日付はISO8601形式で記述されます。
t	string	To: インシデントが原因でトラフィックが終了する交差点または場所の名前
ty	DelayMagnitude (int32)	インシデントに関連する遅延の大きさ。これらの値は、トラフィックタイルのインシデントの色に対応します

次の方法で共有

Traffic - Get Traffic Incident Detail

URI パラメーター

要求ヘッダー

応答

セキュリティ

AADToken

注記

スコープ

subscription-key

SAS Token

例

Request information about a traffic incident

要求のサンプル

応答のサンプル

定義

DelayMagnitude

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

IconCategory

IncidentDetailStyle

IncidentGeometryType

Point

ProjectionStandard

ResponseFormat

Tm

TrafficIncidentDetail

TrafficIncidentPointOfInterest

その他のリソース