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 매개 변수

Name	In(다음 안에)	필수	형식	Description
format	path	True	ResponseFormat	원하는 응답 형식입니다. 값은 json 또는 xml일 수 있습니다.
api-version	query	True	string	Azure Maps API의 버전 번호.
boundingbox	query	True	number[]	는 `boundingbox` 모서리를 설명하는 두 개의 값 쌍으로 표시됩니다(왼쪽 아래 모서리의 경우 첫 번째 쌍, 오른쪽 위에는 두 번째 쌍). 쌍은 아래에 지정된 의 중 하나 `projection`(예: minY,minX,maxY,maxX) 또는 두 개의 위도-경도 쌍(예: minLat,minLon,maxLat,maxLon)을 사용하여 지정할 수 있습니다. 참고: 위도/경도 쌍을 사용하는 경우 매개 변수를 `projection` "EPSG4326"로 설정해야 합니다.
boundingZoom	query	True	integer int32	원하는 타일의 확대/축소 수준입니다. 래스터 타일의 경우 0~22, 벡터 타일의 경우 0~22
style	query	True	IncidentDetailStyle	트래픽 인 시던트 타일 API에서 타일을 렌더링하는 데 사용할 스타일입니다. 이는 회신에서 트래픽 인시던트 좌표에 영향을 줍니다.
trafficmodelid	query	True	string	트래픽 모델을 참조하는 숫자입니다. 뷰포트 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

요청 헤더

Name	필수	형식	Description
x-ms-client-id		string	Microsoft Entra ID 보안 모델과 함께 사용할 계정을 지정합니다. Azure Maps 계정에 대한 고유 ID를 나타내며 Azure Maps 관리 평면 계정 API에서 검색할 수 있습니다. Azure Maps에서 Microsoft Entra ID 보안을 사용하려면 지침은 다음 문서를 참조하세요.

응답

Name	형식	Description
200 OK	TrafficIncidentDetail	정상
Other Status Codes	ErrorResponse	예기치 않은 오류가 발생했습니다.

보안

AADToken

다음은 Microsoft Entra OAuth 2.0 흐름입니다. Azure 역할 기반 액세스 제어와 쌍을 이루는 경우 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 Azure Maps REST API에 대한 하나 이상의 권한으로 구성된 기본 제공 역할 또는 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.

시나리오를 구현하려면 인증 개념을 보는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하는 솔루션을 제공합니다.

참고

이 보안 정의를 사용하려면 헤더를 사용하여 애플리케이션이 x-ms-client-id 액세스를 요청하는 Azure Maps 리소스를 나타내야 합니다. 이는 지도 관리 API에서 가져올 수 있습니다.

Authorization URL 은 Azure 퍼블릭 클라우드 인스턴스와 관련이 있습니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다. * Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면 에서 구성됩니다. * Azure Maps 웹 SDK 를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.

Microsoft ID 플랫폼에 대한 자세한 내용은 Microsoft ID 플랫폼 개요를 참조하세요.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
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
In(다음 안에): query

SAS Token

Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스 의 SAS 나열 작업에서 생성된 공유 액세스 서명 토큰입니다.

이 토큰을 사용하면 모든 애플리케이션이 특정 토큰에 사용할 만료, 속도 및 지역에 대한 Azure 역할 기반 액세스 제어 및 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.

공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.

형식: apiKey
In(다음 안에): 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
      }
    ]
  }
}

정의

Name	Description
DelayMagnitude	인시던트와 관련된 지연의 크기입니다. 이러한 값은 트래픽 타일의 인시던트 색에 해당합니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
IconCategory	이 인시던트에 연결된 아이콘 범주입니다. 값은 0-13 범위의 숫자이며, 알 수 없음, 1: 사고, 2: 안개, 3: 위험한 조건, 4: 비, 5: 얼음, 6: 잼, 7: 차선 폐쇄, 8: 도로 폐쇄, 9: 도로 공사, 10: 바람, 11: 홍수, 12: 우회, 13: 클러스터
IncidentDetailStyle	트래픽 인 시던트 타일 API에서 타일을 렌더링하는 데 사용할 스타일입니다. 이는 회신에서 트래픽 인시던트 좌표에 영향을 줍니다.
IncidentGeometryType	인시던트에 추가된 벡터 기하 도형의 형식입니다(응답의 요소에서 반환됨).
Point	카티전 평면에 좌표(x, y)가 있는 점의 제네릭 표현입니다.
ProjectionStandard	요청 및 응답에서 좌표를 지정하는 데 사용되는 프로젝션입니다. EPSG900913 (기본값) 또는 EPSG4326
ResponseFormat	원하는 응답 형식입니다. 값은 json 또는 xml일 수 있습니다.
Tm	기본 응답 요소
TrafficIncidentDetail	이 개체는 성공적인 트래픽 인시던트 세부 정보 호출에서 반환됩니다.
TrafficIncidentPointOfInterest

DelayMagnitude

인시던트와 관련된 지연의 크기입니다. 이러한 값은 트래픽 타일의 인시던트 색에 해당합니다.

Name	형식	Description
0	Integer	Unknown
1	Integer	부
2	Integer	보통
3	Integer	주요함
4	Integer	무기한(도로 폐쇄 및 기타 무기한 지연에 사용됨)

ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

오류 응답

Name	형식	Description
error	ErrorDetail	Error 개체.

IconCategory

이 인시던트에 연결된 아이콘 범주입니다. 값은 0-13 범위의 숫자이며, 알 수 없음, 1: 사고, 2: 안개, 3: 위험한 조건, 4: 비, 5: 얼음, 6: 잼, 7: 차선 폐쇄, 8: 도로 폐쇄, 9: 도로 공사, 10: 바람, 11: 홍수, 12: 우회, 13: 클러스터

Name	형식	Description
0	Integer	Unknown
1	Integer	사고
10	Integer	Wind
11	Integer	홍수
12	Integer	우회
13	Integer	클러스터: 클러스터에 다른 아이콘 범주가 있는 인시던트가 포함된 경우 반환됩니다.
14	Integer	고장난 차량
2	Integer	안개
3	Integer	위험한 조건
4	Integer	비
5	Integer	Ice
6	Integer	잼
7	Integer	레인 닫힘
8	Integer	도로 폐쇄
9	Integer	도로 공사

IncidentDetailStyle

트래픽 인 시던트 타일 API에서 타일을 렌더링하는 데 사용할 스타일입니다. 이는 회신에서 트래픽 인시던트 좌표에 영향을 줍니다.

Name	형식	Description
night	string	야간 스타일.
s1	string	심각도를 나타내는 색이 지정된 펼침 단추를 사용하여 트래픽 라인을 만듭니다.
s2	string	특정 수준의 네온으로 일반 선을 만듭니다.
s3	string	s2 스타일과 다른 특정 수준의 네온으로 일반 선을 만듭니다.

IncidentGeometryType

인시던트에 추가된 벡터 기하 도형의 형식입니다(응답의 요소에서 반환됨).

Name	형식	Description
original	string	사고를 정확하게 도로에 배치합니다.
shifted	string	확대/축소 수준에 따라 인시던트가 약간 이동하여 특정 도로 차선을 나타냅니다.

Point

카티전 평면에 좌표(x, y)가 있는 점의 제네릭 표현입니다.

Name	형식	Description
x	number	x 좌표
y	number	y 좌표

ProjectionStandard

요청 및 응답에서 좌표를 지정하는 데 사용되는 프로젝션입니다. EPSG900913 (기본값) 또는 EPSG4326

Name	형식	Description
EPSG4326	string	EPSG4326
EPSG900913	string	EPSG900913

ResponseFormat

원하는 응답 형식입니다. 값은 json 또는 xml일 수 있습니다.

Name	형식	Description
json	string	JavaScript 개체 표기법 데이터 교환 형식
xml	string	확장 가능한 태그 언어

Tm

기본 응답 요소

Name	형식	Description
@id	string	이 인시던트에 대한 트래픽 모델의 ID
poi	TrafficIncidentPointOfInterest[]	단일 트래픽 인시던트 또는 트래픽 인시던트 클러스터

TrafficIncidentDetail

이 개체는 성공적인 트래픽 인시던트 세부 정보 호출에서 반환됩니다.

Name	형식	Description
tm	Tm	기본 응답 요소

TrafficIncidentPointOfInterest

Name	형식	Description
c	string	요청된 언어로 인시던트 원인(사용 가능한 경우)
cbl	Point	요청 프로젝션에서 클러스터의 왼쪽 아래 좌표
cs	integer	클러스터 크기: 클러스터의 인시던트 수
ctr	Point	요청 프로젝션에서 클러스터의 오른쪽 위 좌표
d	string	요청된 언어의 인시던트에 대한 설명
dl	integer	인시던트에 의한 지연(도로 폐쇄 제외)
ed	string	인시던트 예상 종료 날짜(사용 가능한 경우)입니다. 날짜는 ISO8601 형식으로 설명됩니다.
f	string	원본: 인시던트로 인한 트래픽이 시작되는 교차로 또는 위치의 이름입니다.
ic	IconCategory	이 인시던트에 연결된 아이콘 범주입니다. 값은 0-13 범위의 숫자이며, 알 수 없음, 1: 사고, 2: 안개, 3: 위험한 조건, 4: 비, 5: 얼음, 6: 잼, 7: 차선 폐쇄, 8: 도로 폐쇄, 9: 도로 공사, 10: 바람, 11: 홍수, 12: 우회, 13: 클러스터
id	string	트래픽 인시던트 ID
l	integer	인시던트 길이(미터)
p	Point	요청된 프로젝션에 표시되는 클러스터 또는 원시 인시던트 아이콘을 그려야 하는 지점입니다. 이는 교통 스타일, 확대/축소 수준 및 도로 유형의 영향을 받습니다.
r	string	인시던트의 영향을 받는 도로 번호입니다. 여러 도로 번호가 슬래시로 구분됩니다.
sd	string	인시던트 시작 날짜(사용 가능한 경우)입니다. 날짜는 ISO8601 형식으로 설명됩니다.
t	string	To: 인시던트로 인한 트래픽이 종료되는 교집합 또는 위치의 이름
ty	DelayMagnitude	인시던트와 관련된 지연의 크기입니다. 이러한 값은 트래픽 타일의 인시던트 색에 해당합니다.

다음을 통해 공유