Traffic - Get Traffic Incident Detail

참조

서비스:: Maps

API 버전:: 1.0

지정된 경계 상자 내에서 트래픽 인시던트에 대한 정보를 가져오는 데 사용합니다.

Traffic Incident Detail API는 현재 트래픽 모델 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 매개 변수

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) minimum: 0 maximum: 22	원하는 타일의 확대/축소 수준입니다. 래스터 타일의 경우 0~22, 벡터 타일의 경우 0~22
style	query	True	IncidentDetailStyle	트래픽 인시던트 타일 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

요청 헤더

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 리소스를 나타내야 합니다. 이는 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
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 범위의 숫자이며, 0: 알 수 없음, 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

열거형

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

값	Description
0	알 수 없음
1	사소한
2	보통
3	중요한
4	무기한(도로 폐쇄 및 기타 무기한 지연에 사용됨)

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

오류 세부 정보입니다.

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

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

IconCategory

열거형

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

값	Description
0	알 수 없음
1	사고
10	바람
11	홍수
12	우회
13	클러스터: 클러스터에 서로 다른 아이콘 범주의 인시던트가 포함된 경우 반환됩니다.
14	세분화 차량
2	안개
3	위험한 조건
4	비
5	Ice
6	잼
7	레인 닫힘
8	도로 폐쇄
9	도로 공사

IncidentDetailStyle

열거형

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

값	Description
night	밤 스타일.
s1	심각도를 나타내는 색이 지정된 펼침 단추를 사용하여 교통선을 만듭니다.
s2	특정 수준의 네온으로 일반 선을 만듭니다.
s3	s2 스타일과 다른 특정 수준의 네온으로 일반 선을 만듭니다.

IncidentGeometryType

열거형

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

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

Point

Object

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

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

ProjectionStandard

열거형

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

값	Description
EPSG4326	EPSG4326
EPSG900913	EPSG900913

ResponseFormat

열거형

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

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

Tm

Object

기본 응답 요소

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

TrafficIncidentDetail

Object

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

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

TrafficIncidentPointOfInterest

Object

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

추가 리소스