Traffic - Get Traffic Incident Detail

リファレンス

サービス:: Maps

API バージョン:: 1.0

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

Traffic Incident Detail API は、現在のトラフィックモデル ID に基づいて、特定の境界ボックス内のトラフィックインシデントに関する情報を提供する HTTP GET 要求です。トラフィックモデル ID は、呼び出しと API の間でデータの同期を許可するために使用できます。トラフィックモデル ID は、トラフィックインシデントの通貨を決定するための重要な値です。 1 分ごとに更新され、タイムアウトする前に 2 分間有効です。これは、インシデントタイルのレンダリングで使用されます。ビューポート 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	目的のタイルのズームレベル。ラスタータイルの場合は 0 から 22、ベクタータイルの場合は 0 から 22
style	query	True	IncidentDetailStyle	Traffic Incident Tile API でタイルをレンダリングするために使用されるスタイル。これは、応答内のトラフィックインシデントの座標に影響します。
trafficmodelid	query	True	string	トラフィックモデルを参照する数値。これは、Viewport API から取得できます。 1 分ごとに更新され、タイムアウトする前に 2 分間有効です。間違ったトラフィックモデル ID が指定されている場合は、インターフェイスから正しいものが返されます。値 -1 は常に最新のトラフィックモデルを呼び出します
expandCluster	query		boolean	クラスター内のすべてのトラフィックインシデントを個別に一覧表示するかどうかを示すブール値
geometries	query		IncidentGeometryType	インシデントに追加されたベクタージオメトリの型 (応答の要素で返されます)。
language	query		string	出力言語の ISO 639-1 コード。サポートされている言語は、ar、ca、cs、da、de、el、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	OK
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 とスコープに対するアクセス制御が可能なオブジェクトを使用してアプリケーションをモデル化するためのソリューションを提供します。

メモ

このセキュリティ定義では、ヘッダーを使用して、 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 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
IncidentDetailStyle	Traffic Incident Tile API でタイルをレンダリングするために使用されるスタイル。これは、応答のトラフィックインシデントの座標に影響します。
IncidentGeometryType	インシデントに追加されたベクタージオメトリの型 (応答の要素で返されます)。
Point	デカルト平面内の座標 (x、y) を持つポイントの一般的な表現。
ProjectionStandard	要求と応答の座標を指定するために使用されるプロジェクション。 EPSG900913 (既定値) または EPSG4326
ResponseFormat	応答の目的の形式。値には json または xml を指定できます。
Tm	Main response 要素
TrafficIncidentDetail	このオブジェクトは、トラフィックインシデントの詳細呼び出しが成功した場合に返されます
TrafficIncidentPointOfInterest

DelayMagnitude

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

名前	型	説明
0	Integer	Unknown
1	Integer	Minor
2	Integer	中
3	Integer	メジャー
4	Integer	不定(通行止めやその他無期限の遅延に使用)

ErrorAdditionalInfo

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

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

ErrorDetail

エラーの詳細。

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

ErrorResponse

エラー応答

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

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

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

IncidentDetailStyle

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

名前	型	説明
night	string	夜のスタイル。
s1	string	重大度を示す色付きのシェブロンを含む交通線を作成します。
s2	string	ある程度の光彩を持つプレーンな線を作成します。
s3	string	s2 スタイルとは異なる、ある程度の光彩を持つプレーンな線を作成します。

IncidentGeometryType

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

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

Point

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

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

ProjectionStandard

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

名前	型	説明
EPSG4326	string	EPSG4326
EPSG900913	string	EPSG900913

ResponseFormat

応答の目的の形式。値には json または xml を指定できます。

名前	型	説明
json	string	JavaScript オブジェクト表記データ交換形式
xml	string	拡張可能なマークアップ言語

Tm

Main response 要素

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

TrafficIncidentDetail

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

名前	型	説明
tm	Tm	Main response 要素

TrafficIncidentPointOfInterest

名前	型	説明
c	string	要求された言語でのインシデントの原因 (使用可能な場合)
cbl	Point	要求のプロジェクションにおけるクラスターの左下座標
cs	integer	クラスターサイズ: クラスター内のインシデントの数
ctr	Point	要求のプロジェクションにおけるクラスターの右上座標
d	string	要求された言語でのインシデントの説明
dl	integer	インシデントによって発生した遅延 (道路閉鎖を除く)
ed	string	インシデントの推定終了日 (使用可能な場合)。日付は、ISO8601形式で記述されます。
f	string	From: インシデントによるトラフィックが開始される交差点または場所の名前
ic	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
id	string	トラフィックインシデントの ID
l	integer	インシデントの長さ (メートル単位)
p	Point	クラスターまたは生インシデントのアイコンを描画する必要があるポイント。要求されたプロジェクションで表されます。これは、交通スタイル、ズームレベル、道路の種類の影響を受ける
r	string	インシデントの影響を受ける道路番号。複数の道路番号はスラッシュで区切られます
sd	string	インシデントの開始日 (使用可能な場合)。日付は、ISO8601形式で記述されます。
t	string	To: インシデントが原因でトラフィックが終了する交差点または場所の名前
ty	DelayMagnitude	インシデントに関連する遅延の大きさ。これらの値は、トラフィックタイルのインシデントの色に対応します

次の方法で共有