Traffic - Get Traffic Incident Detail
지정된 경계 상자 내의 트래픽 인시던트에 대한 정보를 가져오는 데 사용합니다.
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 |
원하는 응답 형식입니다. 값은 json 또는 xml일 수 있습니다. |
|
|
api-version
|
query | True |
string |
Azure Maps API의 버전 번호. |
|
boundingbox
|
query | True |
number[] |
는 |
|
bounding
|
query | True |
integer int32 |
원하는 타일의 확대/축소 수준입니다. 래스터 타일의 경우 0~22, 벡터 타일의 경우 0~22 |
|
style
|
query | True |
트래픽 인 시던트 타일 API에서 타일을 렌더링하는 데 사용할 스타일입니다. 이는 회신에서 트래픽 인시던트 좌표에 영향을 줍니다. |
|
|
trafficmodelid
|
query | True |
string |
트래픽 모델을 참조하는 숫자입니다. 뷰포트 API에서 가져올 수 있습니다. 1분마다 업데이트되며 시간이 초과되기 전에 2분 동안 유효합니다. 잘못된 트래픽 모델 ID를 지정하면 인터페이스에서 올바른 트래픽 모델 ID가 반환됩니다. -1 값은 항상 가장 최근의 트래픽 모델을 호출합니다. |
|
expand
|
query |
boolean |
클러스터의 모든 트래픽 인시던트 목록을 별도로 나열할지 여부를 나타내는 부울 |
|
|
geometries
|
query |
인시던트에 추가된 벡터 기하 도형의 형식입니다(응답의 요소에서 반환됨). |
||
|
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입니다. 자세한 내용은 지원되는 언어를 참조하세요. 잘못된 언어 코드가 제공되면 영어로 응답이 반환됩니다. 인시던트 원인 또는 설명에 번역이 없으면 영어 설명이 반환됩니다. |
|
|
original
|
query |
boolean |
인시던트()의 원래 위치와 트래픽 튜브의 시작 부분으로 이동한 위치를 반환할지 여부에 대한 부울() |
|
|
projection
|
query |
요청 및 응답에서 좌표를 지정하는 데 사용되는 프로젝션입니다. 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 |
정상 |
|
| Other Status Codes |
예기치 않은 오류가 발생했습니다. |
보안
AADToken
Microsoft Entra OAuth 2.0 흐름입니다. Azure 역할 기반 액세스 제어와 쌍을 이루는 경우 Azure Maps REST API에 대한 액세스를 제어하는 데 사용할 수 있습니다. Azure 역할 기반 액세스 제어는 하나 이상의 Azure Maps 리소스 계정 또는 하위 리소스에 대한 액세스를 지정하는 데 사용됩니다. 모든 사용자, 그룹 또는 서비스 주체는 기본 제공 역할 또는 REST API를 Azure Maps 하나 이상의 권한으로 구성된 사용자 지정 역할을 통해 액세스 권한을 부여할 수 있습니다.
시나리오를 구현하려면 인증 개념을 보는 것이 좋습니다. 요약하자면, 이 보안 정의는 특정 API 및 범위에 대한 액세스 제어가 가능한 개체를 통해 애플리케이션을 모델링하기 위한 솔루션을 제공합니다.
참고
- 이 보안 정의에서는 헤더를 사용하여 애플리케이션이
x-ms-client-id액세스를 요청하는 Azure Maps 리소스를 나타내야 합니다. 이는 Maps 관리 API에서 가져올 수 있습니다.
Authorization URL 은 Azure 퍼블릭 클라우드 instance 관련됩니다. 소버린 클라우드에는 고유한 권한 부여 URL 및 Microsoft Entra ID 구성이 있습니다.
* Azure 역할 기반 액세스 제어는 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면에서 구성됩니다.
* Azure Maps Web SDK를 사용하면 여러 사용 사례에 대한 애플리케이션의 구성 기반 설정을 사용할 수 있습니다.
- Microsoft ID 플랫폼 대한 자세한 내용은 Microsoft ID 플랫폼 개요를 참조하세요.
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
| Name | Description |
|---|---|
| https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
이 키는 Azure Portal Azure Maps 계정을 Create PowerShell, CLI, Azure SDK 또는 REST API를 사용할 때 프로비전되는 공유 키입니다.
이 키를 사용하면 모든 애플리케이션이 모든 REST API에 액세스할 수 있습니다. 즉, 이 키는 발급된 계정에서 master 키로 사용할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 기밀 클라이언트 애플리케이션 접근 방식을 사용하여 키를 안전하게 저장할 수 있도록 Azure Maps REST API에 액세스하는 것이 좋습니다.
Type:
apiKey
In:
query
SAS Token
공유 액세스 서명 토큰은 Azure Portal, PowerShell, CLI, Azure SDK 또는 REST API를 통해 Azure 관리 평면을 통해 Azure Maps 리소스의 SAS 나열 작업에서 만들어집니다.
이 토큰을 사용하면 모든 애플리케이션이 특정 토큰에 사용할 만료, 속도 및 지역에 대한 Azure 역할 기반 액세스 제어 및 세분화된 제어를 사용하여 액세스할 수 있는 권한이 부여됩니다. 즉, SAS 토큰을 사용하여 애플리케이션이 공유 키보다 더 보안이 유지되는 방식으로 액세스를 제어할 수 있습니다.
공개적으로 노출된 애플리케이션의 경우 렌더링 남용을 제한하고 정기적으로 SAS 토큰을 갱신하도록 맵 계정 리소스 에서 허용되는 특정 원본 목록을 구성하는 것이 좋습니다.
Type:
apiKey
In:
header
예제
Request information about a traffic incident
Sample Request
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
Sample Response
{
"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 |
|---|---|
|
Delay |
인시던트와 관련된 지연의 크기입니다. 이러한 값은 트래픽 타일의 인시던트 색에 해당합니다. |
|
Error |
리소스 관리 오류 추가 정보입니다. |
|
Error |
오류 세부 정보입니다. |
|
Error |
오류 응답 |
|
Icon |
이 인시던트에 연결된 아이콘 범주입니다. 값은 0-13 범위의 숫자이며, 다음 의미 -- 0: 알 수 없음, 1: 사고, 2: 안개, 3: 위험한 조건, 4: 비, 5: 얼음, 6: 잼, 7: 레인 폐쇄, 8: 도로 폐쇄, 9: 도로 공사, 10: 바람, 11: 홍수, 12: 우회, 13: 클러스터 |
|
Incident |
트래픽 인 시 던트 타일 API에서 타일을 렌더링하는 데 사용할 스타일입니다. 이는 회신에서 트래픽 인시던트 좌표에 영향을 줍니다. |
|
Incident |
인시던트에 추가된 벡터 기하 도형의 형식입니다(응답 요소에서 반환됨). |
| Point |
카티시안 평면에 좌표(x, y)가 있는 점의 제네릭 표현입니다. |
|
Projection |
요청 및 응답에서 좌표를 지정하는 데 사용되는 프로젝션입니다. EPSG900913 (기본값) 또는 EPSG4326 |
|
Response |
원하는 응답 형식입니다. 값은 json 또는 xml일 수 있습니다. |
| Tm |
기본 응답 요소 |
|
Traffic |
이 개체는 성공적인 트래픽 인시던트 세부 정보 호출에서 반환됩니다. |
|
Traffic |
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 |
오류 추가 정보입니다. |
|
| code |
string |
오류 코드입니다. |
| details |
오류 세부 정보입니다. |
|
| message |
string |
오류 메시지입니다. |
| target |
string |
오류 대상입니다. |
ErrorResponse
오류 응답
| Name | 형식 | Description |
|---|---|---|
| error |
Error 개체. |
IconCategory
이 인시던트에 연결된 아이콘 범주입니다. 값은 0-13 범위의 숫자이며, 다음 의미 -- 0: 알 수 없음, 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 |
Places 사고는 정확히 도로에 있습니다. |
| shifted |
string |
확대/축소 수준에 따라 인시던트가 약간 이동하여 특정 도로 차선을 나타냅니다. |
Point
카티시안 평면에 좌표(x, y)가 있는 점의 제네릭 표현입니다.
| Name | 형식 | Description |
|---|---|---|
| x |
number |
x 좌표 |
| y |
number |
y 좌표 |
ProjectionStandard
요청 및 응답에서 좌표를 지정하는 데 사용되는 프로젝션입니다. EPSG900913 (기본값) 또는 EPSG4326
| Name | 형식 | Description |
|---|---|---|
| EPSG4326 |
string |
|
| EPSG900913 |
string |
ResponseFormat
원하는 응답 형식입니다. 값은 json 또는 xml일 수 있습니다.
| Name | 형식 | Description |
|---|---|---|
| json |
string |
|
| xml |
string |
Tm
기본 응답 요소
| Name | 형식 | Description |
|---|---|---|
| @id |
string |
이 인시던트에 대한 트래픽 모델의 ID |
| poi |
단일 트래픽 인시던트 또는 트래픽 인시던트 클러스터 |
TrafficIncidentDetail
이 개체는 성공적인 트래픽 인시던트 세부 정보 호출에서 반환됩니다.
| Name | 형식 | Description |
|---|---|---|
| tm |
기본 응답 요소 |
TrafficIncidentPointOfInterest
| Name | 형식 | Description |
|---|---|---|
| c |
string |
요청된 언어로 인시던트 원인(사용 가능한 경우) |
| cbl |
요청의 프로젝션에서 클러스터의 왼쪽 아래 좌표 |
|
| cs |
integer |
클러스터 크기: 클러스터의 인시던트 수 |
| ctr |
요청 프로젝션에서 클러스터의 오른쪽 위 좌표 |
|
| d |
string |
요청된 언어의 인시던트에 대한 설명 |
| dl |
integer |
인시던트에 의한 지연(도로 폐쇄 제외) |
| ed |
string |
인시던트 예상 종료 날짜(사용 가능한 경우)입니다. 날짜는 ISO8601 형식으로 설명됩니다. |
| f |
string |
원본: 인시던트로 인한 트래픽이 시작되는 교집합 또는 위치의 이름 |
| ic |
이 인시던트에 연결된 아이콘 범주입니다. 값은 0-13 범위의 숫자이며, 다음 의미 -- 0: 알 수 없음, 1: 사고, 2: 안개, 3: 위험한 조건, 4: 비, 5: 얼음, 6: 잼, 7: 레인 폐쇄, 8: 도로 폐쇄, 9: 도로 공사, 10: 바람, 11: 홍수, 12: 우회, 13: 클러스터 |
|
| id |
string |
트래픽 인시던트 ID |
| l |
integer |
인시던트 길이(미터) |
| p |
요청된 프로젝션에 표시되는 클러스터 또는 원시 인시던트 아이콘을 그려야 하는 지점입니다. 이는 교통 스타일, 확대/축소 수준 및 도로 유형에 의해 영향을 받습니다. |
|
| r |
string |
인시던트의 영향을 받는 도로 번호입니다. 여러 도로 번호가 슬래시로 구분됩니다. |
| sd |
string |
인시던트 시작 날짜(사용 가능한 경우)입니다. 날짜는 ISO8601 형식으로 설명됩니다. |
| t |
string |
To: 인시던트로 인한 트래픽이 종료되는 교집합 또는 위치의 이름 |
| ty |
인시던트와 관련된 지연의 크기입니다. 이러한 값은 트래픽 타일의 인시던트 색에 해당합니다. |