교통정보
- REQUEST ( 교통정보 )
curl --request GET \
--url 'https://apis.openapi.sk.com/tmap/traffic?version=1&reqCoordType=WGS84GEO&resCoordType=WGS84GEO&trafficType=null&radius=1&zoomLevel=1000&sort=index&appKey=hd921-ksu29-hzq8i-91jai' \
--header 'Accept: application/json'
- RESPONSE ( 교통정보 )
| Name | Date Type | Mandatory | Example | Description |
|---|---|---|---|---|
| type | String | Y | FeatureCollection | KML Root 노드입니다. |
| features | Node | N | 포인트 및 라인의 형상 정보입니다. (geojson 표준 규격) | |
| type | String | N | Feature | 링크 정보입니다. (geojson 표준 규격) |
| geometry | Node | N | 형상 정보 입니다. (geojson 표준 규격) | |
| type | String | N | LineString | geometry의 type입니다. |
| coordinates | String | N | 좌표 정보입니다. - 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고 복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다. - 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]] | |
| properties | node | Y | 사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격) | |
| index | number | N | 1 | 전체 순번입니다. |
| lineIndex | number | N | 1 | 링크의 순번입니다. |
| id | String | N | 1000 | 링크 ID(TSD Link ID)입니다. |
| name | String | N | 마포대교북단 | 링크 명칭입니다. |
| description | String | N | 소통정보 원할 | 정보 내용입니다. - 형식: {startNodeName}에서 {endNodeName} 방면 {congestion} - 동발정보형태: 돌발 상세 정보 |
| congestion | number | N | 혼잡도 입니다. - 0: 정보없음 - 1: 원할 - 2: 서행 - 3: 지체 - 4: 정체 | |
| direction | number | N | 방향 정보입니다. - 0: 정방향 - 1: 역방향 | |
| roadType | number | N | 도로 타입 정보입니다. - 001: 고속도로 - 002: 도시고속도로 - 004: 주요도로 - 005: 터널 - 006: 한강교량 - 007: 한강주변도로 - 013: 수도권 주요국도 | |
| startNodeName | String | N | 동부간선도로 수락산역 | 시작 노드명입니다. |
| endNodeName | String | N | 동부간선도로 마들길 | 종료 노드명입니다. |
| distance | number | N | 300 | 구간 거리(단위: m)입니다. |
| time | number | N | 40 | 통행 시간(단위: 초)입니다. |
| speed | number | N | 69 | 통행 속도(단위: km/h)입니다. |
| updateTime | date | N | 교통정보 최종 업데이트 일시입니다. - index=0일 때 응답되는 정보 입니다. - 형식 : YYYYMMDDHHMMSS | |
| type | String | N | Feature | 돌발 정보입니다. (geojson 표준 규격) |
| geometry | Node | N | 형상 정보 입니다. (geojson 표준 규격) | |
| type | String | N | Point | geometry의 type입니다. |
| coordinates | String | N | 좌표 정보입니다. - 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고 복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다. - 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]] | |
| properties | Node | N | 사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격) | |
| index | number | N | 1 | 전체 순번입니다. |
| pointIndex | Node | N | 1 | 포인트 노드의 순번입니다. |
| isAccidentNode | String | N | 돌발 정보 여부입니다. - Y: 돌발정보 노드 - N: 일반 노드 | |
| accidentUpperCode | String | N | 돌발 정보 분류 코드입니다. isAccidentNode=Y일 때 응답되는 정보입니다. - A: 사고 - B: 공사 - C: 행사 - D: 재해 - E: 통제 | |
| accidentUpperName | String | N | 돌발정보 분류 명칭입니다. | |
| accidentDetailCode | String | N | 돌발 정보 상세 분류 코드입니다. isAccidentNode=Y일 때 응답되는 정보입니다. - A00: 사고 - A01: 차량단독사고 - A02: 추돌사고 - A03: 충돌사고 - A04: 도로시설물추돌사고 - A05: 차량고장 - A06: 낙하물적하 - A07: 보행자사고 - A08: 추락사고 - A09: 차량화재사고 - A10: 신호등고장 - A11: 도로시설물파손잔해 - A12: 사고조사및처리 - A13: 사고구경 - A14: 무단횡단 - A15: 차량전복사고 - A99: 기타 - B00: 공사 - B01: 도로확장및연결공사 - B02: 노면포장및유지보수 - B03: 차선도색 - B04: 도로시설물공사 - B05: 교통시설물공사 - B06: 맨홀공사 - B07: 지하철공사 - B08: 도로청소작업 - B99: 기타 - C00: 행사 - C01: 행사 - C02: 집회 - C03: 민방위훈련 - C04: 군사훈련 - C05: 주요인사통과 - C99: 기타 - D00: 재해 - D01: 폭우 - D02: 폭설 - D03: 노면침수 - D04: 노면결빙 - D05: 도로파손 - D06: 낙석 - D07: 토사유출 - D08: 재해예방작업 - D09: 재해복구작업 - D10: 화재 - D11: 산사태 - D12: 눈사태 - D13: 지진 - D14: 안개 - D99: 기타 - E00: 차단및통제 - E01: 부분통제 - E02: 전면통제 - E03: 부분차단 - E04: 전면차단 - E05: 진입로통제 - E06: 진입로차단 - E07: 진출로통제 - E08: 진출로차단 - E99: 기타 | |
| accidentDetailName | String | N | 진출로차단 | 돌발 정보 상세 분류 명칭입니다. |
| description | String | N | 소통정보 원할 | 정보 내용입니다. - 돌발정보형태: 돌발 상세 정보. |
- 교통정보 RESPONSE ( type : json )
{
"type": "FeatureCollection",
"features": [
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [[126.9784884665,37.5744258358],[126.9777553529,37.5744231262],
[126.9765153724,37.5743138912],[126.9755996512,37.5742285106],[126.9744503678,37.5741368829]]
},
"properties":{
"index": 0,
"lineIndex": 0,
"id": "1008991",
"name": "내자동길/1008991/159762",
"description": "문화관광부 에서 중앙청사후문 방면 서행 / 24",
"congestion": 2,
"direction": 0,
"roadType": "004",
"startNodeName": "문화관광부",
"endNodeName": "중앙청사후문",
"distance": 357,
"time": 8.92,
"speed": 24
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [[126.9744647534,37.5740235391],[126.9756152415,37.574115263],[126.976531708,37.5742007132],
[126.9777636504,37.5743092403],[126.9784891367,37.5743119217]]
},
"properties":{
"index": 1,
"lineIndex": 1,
"id": "1008992",
"name": "내자동길/1008992/159763",
"description": "중앙청사후문 에서 문화관광부 방면 원활 / 31",
"congestion": 1,
"direction": 1,
"roadType": "004",
"startNodeName": "중앙청사후문",
"endNodeName": "문화관광부",
"distance": 357,
"time": 6.90,
"speed": 31
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [[126.9876086657,37.5726034034],[126.9874529785,37.5719362634],[126.9874459485,37.5718730774],
[126.9874391537,37.5717564377],[126.9874732062,37.5709210723],[126.9875109075,37.5703226513],[126.987515647,37.5701962681]]
},
"properties":{
"index": 2,
"lineIndex": 2,
"id": "1009341",
"name": "삼일로/1009341/159815",
"description": "낙원상가 에서 종로2가사거리 방면 서행 / 20",
"congestion": 2,
"direction": 0,
"roadType": "004",
"startNodeName": "낙원상가",
"endNodeName": "종로2가사거리",
"distance": 225,
"time": 6.75,
"speed": 20
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [[126.9878562838,37.5702038458],[126.9878478146,37.5703314102],[126.9877776215,37.5716386502],
[126.9877776189,37.5717270841],[126.9877903782,37.5718704555],[126.987945228,37.5725770816],[126.9879653828,37.572728049],
[126.9879754027,37.5728317586],[126.9879822111,37.5729207931],[126.9879787775,37.5730496945],[126.9879681938,37.5731246118],
[126.9879506052,37.5731964478],[126.987919802,37.5732845166],[126.9878044732,37.5735732019]]
},
"properties":{
"index": 3,
"lineIndex": 3,
"id": "1009342",
"name": "삼일로/1009342/159816",
"description": "종로2가사거리 에서 낙원상가 방면 원활 / 32",
"congestion": 1,
"direction": 1,
"roadType": "004",
"startNodeName": "종로2가사거리",
"endNodeName": "낙원상가",
"distance": 225,
"time": 4.21,
"speed": 32
}
} }
]
}
- 교통정보 RESPONSE ( type : javascript )
function (
{
"type": "FeatureCollection",
"features": [
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [[126.9784884665,37.5744258358],[126.9777553529,37.5744231262],
[126.9765153724,37.5743138912],[126.9755996512,37.5742285106],[126.9744503678,37.5741368829]]
},
"properties":{
"index": 0,
"lineIndex": 0,
"id": "1008991",
"name": "내자동길/1008991/159762",
"description": "문화관광부 에서 중앙청사후문 방면 서행 / 24",
"congestion": 2,
"direction": 0,
"roadType": "004",
"startNodeName": "문화관광부",
"endNodeName": "중앙청사후문",
"distance": 357,
"time": 8.92,
"speed": 24
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [[126.9744647534,37.5740235391],[126.9756152415,37.574115263],[126.976531708,37.5742007132],
[126.9777636504,37.5743092403],[126.9784891367,37.5743119217]]
},
"properties":{
"index": 1,
"lineIndex": 1,
"id": "1008992",
"name": "내자동길/1008992/159763",
"description": "중앙청사후문 에서 문화관광부 방면 원활 / 31",
"congestion": 1,
"direction": 1,
"roadType": "004",
"startNodeName": "중앙청사후문",
"endNodeName": "문화관광부",
"distance": 357,
"time": 6.90,
"speed": 31
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [[126.9876086657,37.5726034034],[126.9874529785,37.5719362634],[126.9874459485,37.5718730774],
[126.9874391537,37.5717564377],[126.9874732062,37.5709210723],[126.9875109075,37.5703226513],[126.987515647,37.5701962681]]
},
"properties":{
"index": 2,
"lineIndex": 2,
"id": "1009341",
"name": "삼일로/1009341/159815",
"description": "낙원상가 에서 종로2가사거리 방면 서행 / 20",
"congestion": 2,
"direction": 0,
"roadType": "004",
"startNodeName": "낙원상가",
"endNodeName": "종로2가사거리",
"distance": 225,
"time": 6.75,
"speed": 20
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [[126.9878562838,37.5702038458],[126.9878478146,37.5703314102],[126.9877776215,37.5716386502],
[126.9877776189,37.5717270841],[126.9877903782,37.5718704555],[126.987945228,37.5725770816],[126.9879653828,37.572728049],
[126.9879754027,37.5728317586],[126.9879822111,37.5729207931],[126.9879787775,37.5730496945],[126.9879681938,37.5731246118],
[126.9879506052,37.5731964478],[126.987919802,37.5732845166],[126.9878044732,37.5735732019]]
},
"properties":{
"index": 3,
"lineIndex": 3,
"id": "1009342",
"name": "삼일로/1009342/159816",
"description": "종로2가사거리 에서 낙원상가 방면 원활 / 32",
"congestion": 1,
"direction": 1,
"roadType": "004",
"startNodeName": "종로2가사거리",
"endNodeName": "낙원상가",
"distance": 225,
"time": 4.21,
"speed": 32
}
}
}
]
}
)
- Error code index
| 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.