타임머신 자동차 길 안내
- REQUEST ( 타임머신 자동차 길 안내 )
curl --request GET \
--url 'https://apis.openapi.sk.com/tmap/routes/prediction?version=1&resCoordType=WGS84GEO&reqCoordType=WGS84GEO&sort=index' \
--header 'Accept: application/json'
- REQUEST PAYLOAD ( 타임머신 자동차 길 안내 )
| Name | Date Type | Mandatory | Example | Default | Description |
|---|---|---|---|---|---|
| routesInfo | Node | Y | 길 안내 요청 정보 입니다. | ||
| departure | Node | Y | 출발지 정보 입니다. | ||
| name | String | Y | 출발지 명칭 입니다. | ||
| lon | Number | Y | 출발지 경도 좌표 입니다. | ||
| lat | Number | Y | 출발지 위도 좌표 입니다. | ||
| depSearchFlag | String | N | 출발지의 좌표를 획득한 방법을 선택하는 옵션 입니다. - 01 : 최근길 - 02 : 즐겨찾기 - 03 : 경위도검색(기본 값) - 04 : 명칭검색 - 05 : 주소검색 | ||
| destination | Node | Y | 도착지 정보 입니다. | ||
| name | String | Y | 도착지 명칭 입니다. | ||
| lon | Number | Y | 도착지 경도 좌표 입니다. | ||
| lat | Number | Y | 도착지 위도 좌표 입니다. | ||
| poiId | String | N | 도착지 POI ID(POI 검색 결과로 얻은 값)입니다. | ||
| rpFlag | String | N | 도착지 RP flag 입니다. 명칭(POI)통합 검색 사용시 결과로 리턴된 rpFlag를 사용하시면 됩니다. | ||
| destSearchFlag | String | N | 도착지의 좌표를 획득한 방법을 선택하는 옵션 입니다. - 01 : 최근길검색 - 02 : 즐겨찾기검색 - 03 : 경위도검색(기본 값) - 04 : 명칭검색 - 05 : 주소검색 - 06 : 통합검색 | ||
| wayPoints | Node | N | 경유지 정보 입니다. - 경유지 정보 요청 시 필수 입니다. | ||
| wayPoint | Node | N | 1 | 경유지 정보 입니다. - 경유지 정보 요청 시 필수 입니다. | |
| lon | String | Y | 경유지 경도 좌표 입니다. - 경유지 정보 요청 시 필수 입니다. | ||
| lat | String | Y | 경유지 위도 좌표 입니다. - 경유지 정보 요청 시 필수 입니다. | ||
| poiId | String | N | 경유지 POI ID 입니다. | ||
| predictionType | String | Y | 경로 서비스의 구분 입니다. - departure : 출발시간 예측 길 안내. - arrival : 도착시간 예측 길 안내 | ||
| predictionTime | String | Y | 길 안내의 기준이 되는 출발 혹은 도착 시간 입니다. - predictionType = departure 일 때는 “도착시간”을, predictionType = arrival 일 경우에는 “출발시간”을 입력해야 합니다. - 형태 : ISO-8601 표준. - 예) 2013-05-19T18:31:22+0900 | ||
| searchOption | String | N | 경로탐색 시 우선순위를 정하는 옵션입니다. - 00 : 교통최적+추천 (기본 값) - 01 : 교통최적+무료우선 - 02 : 교통최적+최소시간 - 03 : 교통최적+초보 - 04 : 교통최적+고속도로우선 - 10 : 최단거리+유/무료 - 19 : 교통최적+어린이보호구역 회피 | ||
| tollgateCarType | String | N | 톨게이트 요금의 기준이 되는 차량의 종류 입니다. - car : 승용차, 소형승합차(17인승이하), 소형화물차 (기본값) - mediumvan : 중형승합차(17인승초과~32인승이하), 중형화물차 - largevan : 대형승합차(33인승초과), 2축 대형화물차 - largetruck : 대형화물차(3축 대형화물차) - specialtruck : 특수화물차 (4축이상 특수화물차) - smallcar : 경차 (배기량 1000cc미만) - twowheel : 이륜차(오토바이) | ||
| trafficInfo | String | N | 교통정보 표출 옵션입니다. Y: 교통정보를 포함 N: 교통정보를 포함하지 않음 |
- REQUEST payload 셈플 코드
{
"routesInfo": {
"departure": {
"name": "test1",
"lon": "126.963936",
"lat": "37.536025",
"depSearchFlag": "05"
},
"destination": {
"name": "test2",
"lon": "129.071724",
"lat": "35.177188",
"poiId": "1000559885",
"rpFlag":"16",
"destSearchFlag": "03"
},
"predictionType": "departure",
"predictionTime": "2013-05-19T18:31:22+0900",
"wayPoints": {
"wayPoint": [
{
"lon": "126.814383",
"lat": "35.157242",
"poiId": "1000559888"
},
{
"lon": "128.565503",
"lat": "35.874493",
"poiId": "1000559886"
}
]
},
"searchOption": "00",
"tollgateCarType": "car",
"trafficInfo" : "N"
}
}
function (
{
"routesInfo": {
"departure": {
"name": "test1",
"lon": "126.963936",
"lat": "37.536025",
"depSearchFlag": "05"
},
"destination": {
"name": "test2",
"lon": "129.071724",
"lat": "35.177188",
"poiId": "1000559885",
"rpFlag":"16",
"destSearchFlag": "03"
},
"predictionType": "departure",
"predictionTime": "2013-05-19T18:31:22+0900",
"wayPoints": {
"wayPoint": [
{
"lon": "126.814383",
"lat": "35.157242",
"poiId": "1000559888"
},
{
"lon": "128.565503",
"lat": "35.874493",
"poiId": "1000559886"
}
]
},
"searchOption": "00",
"tollgateCarType": "car",
"trafficInfo" : "N"
}
}
)
- RESPONSE ( 타임머신 자동차 길 안내 )
| Name | Date Type | Mandatory | Example | Description |
|---|---|---|---|---|
| type | String | Y | FeatureCollection | geojson 표준 프로퍼티입니다. |
| features | Node | N | 포인트 및 라인의 형상 정보입니다. (geojson 표준 규격) | |
| type | String | N | Feature | 출발점, 안내점, 경유지, 도착점 정보입니다. |
| 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 | Number | N | 1 | 안내점 노드의 순번입니다. |
| name | String | N | 지점명칭 ? 서울시시청 | 안내지점의 명칭입니다. |
| description | String | N | 길 안내 정보입니다. | |
| nextRoadName | String | N | 다음 구간의 도로 명칭입니다. | |
| turnType | Number | N | 회전 정보입니다. - 0: 휴게소 - 1: 도곽에 의한 점 - 2: 타일에 의한 점 - 3: 고속도로에 의한 안내없음 - 4: 일반도로에 의한 안내없음 - 5: 특수한 경우 안내없음 - 6: Y자 오른쪽 안내없음 - 7: Y자 왼쪽 안내없음 - 11: 직진 - 12: 좌회전 - 13: 우회전 - 14: U턴 - 15: P턴 - 16: 8시 방향 좌회전 - 17: 10시 방향 좌회전 - 18: 2시 방향 우회전 - 19: 4시 방향 우회전 - 43: 오른쪽 - 44: 왼쪽 - 51: 직진 방향 - 52: 왼쪽 차선 - 53: 오른쪽 차선 - 54: 1차선 - 55: 2차선 - 56: 3차선 - 57: 4차선 - 58: 5차선 - 59: 6차선 - 60: 7차선 - 61: 8차선 - 62: 9차선 - 63: 10차선 - 71: 첫번째 출구 - 72: 두번째 출구 - 73: 첫번째 오른쪽 길 - 74: 두번째 오른쪽 길 - 75: 첫번째 왼쪽 길 - 76: 두번째 왼쪽 길 - 101: 오른쪽 고속도로 입구 - 102: 왼쪽 고속도로 입구 - 103: 전방 고속도로 입구 - 104: 오른쪽 고속도로 출구 - 105: 왼쪽 고속도로 출구 - 106: 전방 고속도로 출구 - 111: 오른쪽 도시고속도로 입구 - 112: 왼쪽 도시고속도로 입구 - 113: 전방 도시고속도로 입구 - 114: 오른쪽 도시고속도로 출구 - 115: 왼쪽 도시고속도로 출구 - 116: 전방 도시고속도로 출구 - 117: 오른쪽 방향 - 118: 왼쪽 방향 - 119: 지하차도 - 120: 고가도로 - 121: 터널 - 122: 교량 - 123: 지하차도옆 - 124: 고가도로옆 - 130: 토끼굴 진입 - 131: 1시 방향 - 132: 2시 방향 - 133: 3시 방향 - 134: 4시 방향 - 135: 5시 방향 - 136: 6시 방향 - 137: 7시 방향 - 138: 8시 방향 - 139: 9시 방향 - 140: 10시 방향 - 141: 11시 방향 - 142: 12시 방향 - 150: 졸음쉼터 - 151: 휴게소 - 182: 왼쪽방향 도착안내 - 183: 오른쪽방향 도착안내 - 184: 경유지 - 185: 첫번째경유지 - 186: 두번째경유지 - 187: 세번째경유지 - 188: 네번째경유지 - 189: 다섯번째경유지 - 191: 제한속도 - 192: 사고다발 - 193: 급커브 - 194: 낙석주의 - 200: 출발지 - 201: 도착지 - 203: 목적지건너편 - 233: 직진 임시 | |
| pointType | String | N | 안내지점의 구분입니다. - S: 출발지 - E: 도착지 - B1: 경유지1 - B2: 경유지2 - B3: 경유지3 - N: 일반 안내점 | |
| totalDistance | Number | N | 3000 | 경로 총 길이(단위: m)입니다. - pointType=S 일때 응답되는 정보입니다. |
| totalTime | Number | N | 600 | 경로 총 소요 시간(단위: 초)입니다. - pointType=S 일때 응답되는 정보입니다. |
| totalFare | Number | N | 1500 | 경로 총 요금 정보(단위:원)입니다. - pointType=S 일때 응답되는 정보입니다. |
| taxiFare | Number | N | 363000 | 택시 예상 요금 정보(단위:원)입니다. |
| departureTime | Date | N | 2013-05-19T18:31:22+00:00 | 출발 시간 입니다. - 형식 : ISO-8601 표준 |
| arrivalTime | Date | N | 2013-05-19T18:31:22+00:00 | 도착 시간 입니다. - 형식 : ISO-8601 표준 |
| type | String | N | Feature | 구간의 정보입니다. |
| geometry | Node | N | 형상 정보 입니다. (geojson 표준 규격) | |
| type | String | N | LineString | geometry의 type입니다. |
| coordinates | String | N | 좌표 정보입니다. - 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고 복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다. - 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]] | |
| properties | Node | N | 사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격) | |
| index | Number | N | 1 | 경로 순번입니다. |
| lineIndex | String | N | 링크의 순번입니다. | |
| name | String | N | 구간명칭- 동일로 | 구간 명칭 또는 안내지점의 명칭입니다. |
| description | String | N | 길 안내 정보입니다. | |
| distance | Number | N | 구간 거리(단위: m)입니다. | |
| time | Number | N | 구간 통과 시간(단위:초) 입니다. | |
| roadType | Number | N | 도로 타입 정보입니다. <도로 타입 코드(상세 위치 구분)> - 0: 고속국도 - 1: 자동차전용 - 2: 국도 - 3: 국가지원 지방도 - 4: 지방도 - 5: 주요도로1(일반도로 1중 6,5차로) - 6: 주요도로2(일반도로 1 중 4,3 차로) - 7: 주요도로3(일반도로 1 중 2차로) - 8: 기타도로1(일반도로 1 중 1차로) - 9: 기타도로2(이면도로) - 10: 페리항로 - 11: 단지내도로(아파트단지내 도로) - 12: 단지 내 도로(시장내 도로) - 16: 일반도로 - 20: 번화가링크 | |
| facilityType | Number | N | 구간의 시설물 타입 정보입니다. <구간의 시설물 타입> - 0: 일반도로 - 1: 교량 - 2: 터널 - 3: 고가도로 - 4: 지하도로 - 5: 교차로통과 - 6: 철도건널목 - 7: 댐/방파제 - 13: 토끼굴 - 90: 한강교량 |
- 타임머신 자동차 길 안내 RESPONSE ( type : json )
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
126.9823439963945,
37.56461982743129
]
},
"properties": {
"totalDistance": 421057,
"totalTime": 18720,
"totalFare": 0,
"taxiFare": 34210,
"departureTime": "2013-05-19T18:31:22+00:00",
"arrivalTime": "2013-05-19T18:31:22+00:00",
"index": 1,
"pointIndex": 1,
"name": "출발지",
"description": "소공로 을 따라 소공로 방면으로 310m 이동",
"nextRoadName": "소공로",
"turnType": 200,
"pointType": "S"
}
},
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[
126.9823439963945,
37.56461982743129
],
[
126.98230789017299,
37.564453179812105
],
[
126.98210513804034,
37.563703265276516
],
[
126.98207180945346,
37.56352550784786
],
[
126.9817857308457,
37.56284502921221
],
[
126.98166907678578,
37.562633941789535
],
[
126.98157186492477,
37.56247284870586
],
[
126.98128300624569,
37.56205345097403
],
[
126.98124689891416,
37.56200067907546
]
]
},
"properties": {
"index": 2,
"lineIndex": 1,
"name": "소공로",
"description": "소공로, 310m",
"distance": 310,
"roadType": 0,
"facilityType": 0
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
126.98124689891416,
37.56200067907546
]
},
"properties": {
"index": 3,
"pointIndex": 2,
"name": "",
"description": "남산3호터널/ /반포대교 방면으로 좌회전 후 소공로 을 따라 190m 이동 ",
"nextRoadName": "소공로",
"turnType": 12,
"pointType": "N"
}
},
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[
126.98124689891416,
37.56200067907546
],
[
126.98156909903298,
37.561278542345434
],
[
126.98159131967861,
37.561234103176794
],
[
126.98162742833591,
37.5611507797013
],
[
126.98175797500768,
37.560850815192815
],
[
126.9819857366794,
37.56038975880062
]
]
},
"properties": {
"index": 4,
"lineIndex": 2,
"name": "소공로",
"description": "소공로, 190m",
"distance": 190,
"roadType": 0,
"facilityType": 0
}
}
]
}
- 타임머신 자동차 길 안내 RESPONSE ( type : javascript )
function (
{
"type": "FeatureCollection",
"features": [
{"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [126.9823439963945,37.56461982743129 ]
},
"properties":{
"totalDistance": 421057,
"totalTime": 18720,
"totalFare": 0,
"taxiFare": 34210,
"departureTime": "2013-05-19T18:31:22+00:00",
"arrivalTime": "2013-05-19T18:31:22+00:00",
"index": 1,
"pointIndex": 1,
"name": "출발지",
"description": "소공로 을 따라 소공로 방면으로 310m 이동",
"nextRoadName": "소공로",
"turnType": 200,
"pointType": "S"
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [
[126.9823439963945,37.56461982743129 ],[126.98230789017299,37.564453179812105 ],[126.98210513804034,37.563703265276516 ],
[126.98207180945346,37.56352550784786 ],[126.9817857308457,37.56284502921221 ],[126.98166907678578,37.562633941789535 ],
[126.98157186492477,37.56247284870586 ],[126.98128300624569,37.56205345097403 ],[126.98124689891416,37.56200067907546 ]
]
},
"properties":{
"index": 2,
"lineIndex": 1,
"name": "소공로",
"description": "소공로, 310m",
"distance": 310,
"roadType": 0,
"facilityType": 0
}
},
{"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [126.98124689891416,37.56200067907546 ]
},
"properties":{
"index": 3,
"pointIndex": 2,
"name": "",
"description": "남산3호터널/ /반포대교 방면으로 좌회전 후 소공로 을 따라 190m 이동 ",
"nextRoadName": "소공로",
"turnType": 12,
"pointType": "N"
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [
[126.98124689891416,37.56200067907546 ],[126.98156909903298,37.561278542345434 ],[126.98159131967861,37.561234103176794 ],
[126.98162742833591,37.5611507797013 ],[126.98175797500768,37.560850815192815 ],[126.9819857366794,37.56038975880062 ]
]
},
"properties":{
"index": 4,
"lineIndex": 2,
"name": "소공로",
"description": "소공로, 190m",
"distance": 190,
"roadType": 0,
"facilityType": 0
}
}
]
}
)
- 타임머신 자동차 길 안내 RESPONSE ( type : json - totalValue=2 로 요청시 간소화 예제 )
{
"type": "FeatureCollection",
"features":[
{
"type": "Feature",
"properties":{
"totalDistance": 421057,
"totalTime": 18720,
"totalFare": 0,
"taxiFare": 34210,
"departureTime": "2013-05-19T10:58:46+0900",
"arrivalTime": "2013-05-19T18:31:22+00:00"
}
}
]
}
- Error code index
| 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.
직선 거리 계산
- REQUEST ( 직선 거리 계산 )
curl --request GET \
--url 'https://apis.openapi.sk.com/tmap/routes/distance?version=1&startX=126.926139&startY=37.557495&endX=126.82613&endY=37.657495&reqCoordType=WGS84GEO&callback=function' \
--header 'Accept: application/json'
- RESPONSE ( 직선 거리 계산 )
| Name | Date Type | Mandatory | Example | Description |
|---|---|---|---|---|
| distanceInfo | Node | Y | ||
| distance | String | Y | 좌표 간 직선거리(단위: m)입니다. |
- 직선 거리 계산 RESPONSE ( type : javascript )
function (
{"distanceInfo": {
"distance": 363856
}}
)
- 직선 거리 계산 RESPONSE ( type : json )
{"distanceInfo": {
"distance": 363856
}}
- Error code index
| 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.
보행자 경로안내
- REQUEST ( 보행자 경로안내 )
curl --request POST \
--url 'https://apis.openapi.sk.com/tmap/routes/pedestrian?version=1' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '
{
"angle": 0,
"speed": 0,
"reqCoordType": "WGS84GEO",
"searchOption": "0",
"resCoordType": "WGS84GEO",
"sort": "index",
"startX": 126.92365493654832,
"startY": 37.556770374096615,
"startName": "%EB%B3%B4%ED%96%89%EC%9E%90-%EA%B2%BD%EB%A1%9C%EC%95%88%EB%82%B4",
"endName": "%EB%B3%B4%ED%96%89%EC%9E%90-%EA%B2%BD%EB%A1%9C%EC%95%88%EB%82%B4"
}
'
- RESPONSE ( 보행자 경로안내 )
| Name | Date Type | Mandatory | Example | Description |
|---|---|---|---|---|
| type | String | Y | FeatureCollection | geojson 표준 프로퍼티입니다. |
| features | Node | N | 포인트 및 라인의 형상 정보입니다. (geojson 표준 규격) | |
| type | String | N | Feature | 출발점, 안내점, 경유지, 도착점 정보입니다. |
| geometry | Node | N | 형상 정보 입니다. (geojson 표준 규격) | |
| type | String | N | Point | 형상 정보 데이터의 종류입니다.(geojson 표준 규격) |
| coordinates | String | N | 좌표 정보입니다. - 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고 복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다. -형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]] | |
| properties | Node | N | 사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격) | |
| index | String | N | 경로 순번입니다. | |
| pointIndex | Node | N | 1 | 안내점 노드의 순번입니다. |
| name | String | N | 서울시시청 | 안내지점의 명칭입니다. |
| description | String | N | 길 안내 정보입니다. | |
| direction | String | N | 방면 명칭입니다. | |
| intersectionName | String | N | 교차로 명칭입니다. | |
| nearPoiX | String | N | 안내지점 근방 poi X좌표 입니다. | |
| nearPoiY | String | N | 안내지점 근방 poi Y좌표 입니다. | |
| nearPoiName | String | N | 안내지점 근방 poi 입니다. | |
| turnType | Number | N | 회전 정보입니다. - 1~7: 안내 없음 - 11: 직진 - 12: 좌회전 - 13: 우회전 - 14: U-turn - 16: 8시 방향 좌회전 - 17: 10시 방향 좌회전 - 18: 2시 방향 우회전 - 19: 4시 방향 우회전 - 184: 경유지 - 185: 첫번째 경유지 - 186: 두번째 경유지 - 187: 세번째 경유지 - 188: 네번째 경유지 - 189: 다섯번째 경유지 - 125: 육교 - 126: 지하보도 - 127: 계단 진입 - 128: 경사로 진입 - 129: 계단+경사로 진입 - 200: 출발지 - 201: 목적지 - 211: 횡단보도 - 212: 좌측 횡단보도 - 213: 우측 횡단보도 - 214: 8시 방향 횡단보도 - 215: 10시 방향 횡단보도 - 216: 2시 방향 횡단보도 - 217: 4시 방향 횡단보도 - 218: 엘리베이터 - 233: 직진 임시 | |
| pointType | String | N | 안내지점의 구분입니다. - SP: 출발지 - EP: 도착지 - PP: 경유지 - PP1: 경유지1 - PP2: 경유지2 - PP3: 경유지3 - PP4: 경유지4 - PP5: 경유지5 - GP: 일반 안내점 | |
| facilityType | String | N | 구간의 시설물 정보입니다. <구간의 시설물 타입> - 1: 교량 - 2: 터널 - 3: 고가도로 - 11: 일반보행자도로 - 12: 육교 - 14: 지하보도 - 15: 횡단보도 - 16: 대형시설물이동통로 - 17: 계단 | |
| facilityName | String | N | 교량 | 구간 시설물 타입의 명칭입니다. |
| totalDistance | Number | N | 3000 | 경로 총 길이(단위:m)입니다. - pointType=SP 일때 응답되는 정보입니다 |
| totalTime | Number | N | 600 | 경로 총 소요시간(단위: 초)입니다. - pointType=SP 일때 응답되는 정보입니다 |
| type | String | N | Feature 도로 구간의 정보입니다. | |
| geometry | Node | N | 형상 정보 입니다.(geojson 표준 규격) | |
| type | String | N | LineString | 형상 정보 데이터의 종류입니다.(geojson 표준 규격) |
| coordinates | String | N | 좌표 정보입니다. - 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고 복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다. - 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]] | |
| properties | Node | N | 사용자 정의 프로퍼티 정보입니다.(geojson 표준 규격) | |
| index | Number | N | 1 | 경로 순번입니다. |
| lineIndex | Number | N | 1 | 구간의 순번입니다. |
| name | String | N | 동일로 | 도로 명칭 입니다. |
| description | String | N | 길 안내 정보입니다. | |
| time | Number | N | 구간의 소요 시간(단위 : 초)입니다. | |
| distance | Number | N | 구간 거리(단위 : m)입니다. | |
| roadType | Number | N | 도로 타입 정보입니다. <도로 타입 코드(상세 위치 구분)> - 21: 보행자도로 1 (차도와 인도가 분리되어 있으며 정해진 횡단구역으로만 횡단 가능한 보행자 도로 ) - 22: 보행자도로 2 (차도와 인도가 분리되어 있지 않거나, 보행자 횡단에 제약이 없는 보행자도로 ) - 23: 보행자도로 3 (차량 통행이 불가능한 보행자도로 ) - 24: 보행자도로 4 (쾌적하지 않은 도로 ) | |
| categoryRoadType | Number | N | 특화거리 정보입니다. <특화거리 코드> - 0: 미분류 - 1: 특화거리 - 2: 테마거리 - 3: 청소년출입금지 |
- 보행자 경로 안내 RESPONSE ( type : json )
{
"type": "FeatureCollection",
"features": [
{"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [126.92364104902308,37.556759264185274 ]
},
"properties":{
"index": 1,
"pointIndex": 1,
"name": "",
"guidePointName": "",
"description": "양화로 을 따라 양화로 방면으로 6m 이동",
"direction": "",
"intersectionName": "",
"nearPoiName": "",
"nearPoiX": "0.0",
"nearPoiY": "0.0",
"crossName": "",
"turnType": 200,
"pointType": "SP"
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [
[126.92364104902308,37.556759264185274 ],[126.92359383142113,37.55672315696065 ]
]
},
"properties":{
"index": 2,
"lineIndex": 1,
"name": "양화로",
"roadName": "양화로",
"description": "양화로, 6m",
"distance": 6,
"time": 5,
"roadType": 23,
"categoryRoadType": 0,
"facilityType": 17,
"facilityName": "일반보행자도로"
}
},
{"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [126.92359383142113,37.55672315696065 ]
},
"properties":{
"index": 3,
"pointIndex": 2,
"name": "",
"guidePointName": "",
"description": "양화로 방면으로 좌측 횡단보도 후 양화로 을 따라 19m 이동 ",
"direction": "",
"intersectionName": "",
"nearPoiName": "",
"nearPoiX": "0.0",
"nearPoiY": "0.0",
"crossName": "",
"turnType": 212,
"pointType": "GP"
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [
[126.92359383142113,37.55672315696065 ],[126.92372993148247,37.55659261733597 ]
]
},
"properties":{
"index": 4,
"lineIndex": 2,
"name": "양화로",
"roadName": "양화로",
"description": "양화로, 19m",
"distance": 19,
"time": 73,
"roadType": 23,
"categoryRoadType": 0,
"facilityType": 17,
"facilityName": "일반보행자도로"
}
},
{"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [126.92372993148247,37.55659261733597 ]
},
"properties":{
"index": 5,
"pointIndex": 3,
"name": "대한생명 홍익BRANCH",
"guidePointName": "대한생명 홍익BRANCH",
"description": "대한생명 홍익BRANCH 에서 대한생명 홍익BRANCH 방면으로 우회전 후 양화로 을 따라 94m 이동 ",
"direction": "",
"intersectionName": "",
"nearPoiName": "",
"nearPoiX": "0.0",
"nearPoiY": "0.0",
"crossName": "",
"turnType": 13,
"pointType": "GP"
}
}
]
}
- 보행자 경로 안내 RESPONSE ( type : javascript )
function (
{
"type": "FeatureCollection",
"features": [
{"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [126.92365493681676,37.55674259953098]
},
"properties":{
"index": 0,
"pointIndex": 0,
"name": "test",
"description": "양화로 방면으로 3m 이동",
"pointType": "SP"
}
},
{"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [126.92364104902308,37.556759264185274 ]
},
"properties":{
"index": 1,
"pointIndex": 1,
"name": "",
"guidePointName": "",
"description": "양화로 을 따라 양화로 방면으로 6m 이동",
"direction": "",
"intersectionName": "",
"nearPoiName": "",
"nearPoiX": "0.0",
"nearPoiY": "0.0",
"crossName": "",
"turnType": 200,
"pointType": "GP"
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [
[126.92364104902308,37.556759264185274 ],[126.92359383142113,37.55672315696065 ]
]
},
"properties":{
"index": 2,
"lineIndex": 1,
"name": "양화로",
"roadName": "양화로",
"description": "양화로, 6m",
"distance": 6,
"time": 5,
"roadType": 23,
"categoryRoadType": 0,
"facilityType": 17,
"facilityName": "일반보행자도로"
}
},
{"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [126.92359383142113,37.55672315696065 ]
},
"properties":{
"index": 3,
"pointIndex": 2,
"name": "",
"guidePointName": "",
"description": "양화로 방면으로 좌측 횡단보도 후 양화로 을 따라 19m 이동 ",
"direction": "",
"intersectionName": "",
"nearPoiName": "",
"nearPoiX": "0.0",
"nearPoiY": "0.0",
"crossName": "",
"turnType": 212,
"pointType": "GP"
}
},
{"type": "Feature",
"geometry":
{
"type": "LineString",
"coordinates": [
[126.92359383142113,37.55672315696065 ],[126.92372993148247,37.55659261733597 ]
]
},
"properties":{
"index": 4,
"lineIndex": 2,
"name": "양화로",
"roadName": "양화로",
"description": "양화로, 19m",
"distance": 19,
"time": 73,
"roadType": 23,
"categoryRoadType": 0,
"facilityType": 17,
"facilityName": "일반보행자도로"
}
},
{"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [126.92372993148247,37.55659261733597 ]
},
"properties":{
"index": 5,
"pointIndex": 3,
"name": "대한생명 홍익BRANCH",
"guidePointName": "대한생명 홍익BRANCH",
"description": "대한생명 홍익BRANCH 에서 대한생명 홍익BRANCH 방면으로 우회전 후 양화로 을 따라 94m 이동 ",
"direction": "",
"intersectionName": "",
"nearPoiName": "",
"nearPoiX": "0.0",
"nearPoiY": "0.0",
"crossName": "",
"turnType": 13,
"pointType": "GP"
}
}
]
}
)
- Error code index
| 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.
자동차 경로안내
- REQUEST ( 자동차 경로안내 )
curl --request POST \
--url 'https://apis.openapi.sk.com/tmap/tmap/routes?version=1' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '
{
"endRpFlag": "G",
"reqCoordType": "WGS84GEO",
"carType": 0,
"detailPosFlag": "2",
"resCoordType": "WGS84GEO",
"sort": "index",
"endX": 14368651.605895586,
"endY": 4188210.3283031476,
"startX": 14135591.321771959,
"startY": 4518111.822510956
}
'
- RESPONSE ( 자동차 경로안내 )
| Name | Date Type | Mandatory | Example | Description |
|---|---|---|---|---|
| type | String | Y | FeatureCollection | geojson 표준 프로퍼티입니다. |
| features | Node | N | 포인트 및 라인의 형상 정보입니다. (geojson 표준 규격) | |
| type | String | N | Feature | 출발점, 안내점, 경유지, 도착점 정보입니다. |
| geometry | Node | N | 형상 정보 입니다. (geojson 표준 규격) | |
| type | String | N | Point | geometry의 type입니다. |
| coordinates | String | N | 좌표 정보입니다. - 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고 복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다. -형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]] | |
| properties | Node | N | 사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격) | |
| index | String | N | 경로 순번입니다. | |
| lineIndex | String | N | 링크의 순번입니다. | |
| pointIndex | Node | N | 아이콘 노드입니다. | |
| name | String | N | 지점명칭 ? 서울시시청 | 안내지점의 명칭입니다. |
| description | String | N | 길 안내 정보입니다. | |
| nextRoadName | String | N | 다음 구간의 도로 명칭입니다. | |
| turnType | Number | N | 회전 정보입니다. - 0: 휴게소 - 1: 도곽에 의한 점 - 2: 타일에 의한 점 - 3: 고속도로에 의한 안내없음 - 4: 일반도로에 의한 안내없음 - 5: 특수한 경우 안내없음 - 6: Y자 오른쪽 안내없음 - 7: Y자 왼쪽 안내없음 - 11: 직진 - 12: 좌회전 - 13: 우회전 - 14: U턴 - 15: P턴 - 16: 8시 방향 좌회전 - 17: 10시 방향 좌회전 - 18: 2시 방향 우회전 - 19: 4시 방향 우회전 - 43: 오른쪽 - 44: 왼쪽 - 51: 직진 방향 - 52: 왼쪽 차선 - 53: 오른쪽 차선 - 54: 1차선 - 55: 2차선 - 56: 3차선 - 57: 4차선 - 58: 5차선 - 59: 6차선 - 60: 7차선 - 61: 8차선 - 62: 9차선 - 63: 10차선 - 71: 첫번째 출구 - 72: 두번째 출구 - 73: 첫번째 오른쪽 길 - 74: 두번째 오른쪽 길 - 75: 첫번째 왼쪽 길 - 76: 두번째 왼쪽 길 - 101: 오른쪽 고속도로 입구 - 102: 왼쪽 고속도로 입구 - 103: 전방 고속도로 입구 - 104: 오른쪽 고속도로 출구 - 105: 왼쪽 고속도로 출구 - 106: 전방 고속도로 출구 - 111: 오른쪽 도시고속도로 입구 - 112: 왼쪽 도시고속도로 입구 - 113: 전방 도시고속도로 입구 - 114: 오른쪽 도시고속도로 출구 - 115: 왼쪽 도시고속도로 출구 - 116: 전방 도시고속도로 출구 - 117: 오른쪽 방향 - 118: 왼쪽 방향 - 119: 지하차도 - 120: 고가도로 - 121: 터널 - 122: 교량 - 123: 지하차도옆 - 124: 고가도로옆 - 130: 토끼굴 진입 - 131: 1시 방향 - 132: 2시 방향 - 133: 3시 방향 - 134: 4시 방향 - 135: 5시 방향 - 136: 6시 방향 - 137: 7시 방향 - 138: 8시 방향 - 139: 9시 방향 - 140: 10시 방향 - 141: 11시 방향 - 142: 12시 방향 - 150: 졸음쉼터 - 151: 휴게소 - 182: 왼쪽방향 도착안내 - 183: 오른쪽방향 도착안내 - 184: 경유지 - 185: 첫번째경유지 - 186: 두번째경유지 - 187: 세번째경유지 - 188: 네번째경유지 - 189: 다섯번째경유지 - 191: 제한속도 - 192: 사고다발 - 193: 급커브 - 194: 낙석주의 - 200: 출발지 - 201: 도착지 - 203: 목적지건너편 - 211: 횡단보도 - 212: 좌측 횡단보도 - 213: 우측 횡단보도 - 214: 8시 방향 횡단보도 - 215: 10시 방향 횡단보도 - 216: 2시 방향 횡단보도 - 217: 4시 방향 횡단보도 - 218: 엘리베이터 - 233: 직진 임시 | |
| pointType | String | N | 안내지점의 구분입니다. - S: 출발지 - E: 도착지 - B1: 경유지1 - B2: 경유지2 - B3: 경유지3 - N: 일반 안내점 | |
| totalDistance | Number | N | 3000 | 경로 총 길이(단위: m)입니다. - pointType=S 일때 응답되는 정보입니다. |
| totalTime | Number | N | 600 | 경로 총 소요 시간(단위: 초)입니다. - pointType=S 일때 응답되는 정보입니다. |
| totalFare | Number | N | 1500 | 경로 총 요금 정보(단위:원)입니다. - pointType=S 일때 응답되는 정보입니다. |
| taxiFare | Number | N | 363000 | 택시 예상 요금 정보(단위:원)입니다. |
| type | String | N | Feature | 구간의 정보입니다. |
| geometry | Node | N | 형상 정보 입니다. (geojson 표준 규격) | |
| type | String | N | LineString | geometry의 type입니다. |
| coordinates | String | N | 좌표 정보입니다. - 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고 복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다. - 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]] | |
| traffic | String | N | 교통 정보입니다. [시작index, 마지막index, 혼잡도, 속도] < 혼잡도 > - 0: 정보없음 - 1: 원할 - 2: 서행 - 3: 지체 - 4: 정체 | |
| properties | Node | N | 사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격) | |
| index | Number | N | 경로 순번입니다. | |
| name | String | N | 1 | 구간 명칭 또는 안내지점의 명칭입니다. |
| description | String | N | 구간명칭- 동일로 | 길 안내 정보입니다. |
| distance | Number | N | 구간 거리(단위: m)입니다. | |
| time | Number | N | 구간 통과 시간(단위:초) 입니다. | |
| roadType | Number | N | 도로 타입 정보입니다. <도로 타입 코드(상세 위치 구분)> - 0: 고속도로 - 1: 자동차전용 - 2: 국도 - 3: 국가지원 지방도 - 4: 지방도 - 5: 주요도로1(일반도로 1중 6,5차로) - 6: 주요도로2(일반도로 1 중 4,3 차로) - 7: 주요도로3(일반도로 1 중 2차로) - 8: 기타도로1(일반도로 1 중 1차로) - 9: 기타도로2(이면도로) - 10: 페리항로 - 11: 단지내도로(아파트단지내 도로) - 12: 단지 내 도로(시장내 도로) - 16: 일반도로 - 20: 번화가링크 | |
| facilityType | Number | N | 구간의 시설물 타입 정보입니다. <구간의 시설물 타입> - 0: 일반도로 - 1: 교량 - 2: 터널 - 3: 고가도로 - 4: 지하도로 - 5: 교차로통과 - 6: 철도건널목 - 7: 댐/방파제 - 13: 토끼굴 - 90: 한강교량 |
- 자동차 경로안내 RESPONSE ( type : json )
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
126.9823439963945,
37.56461982743129
]
},
"properties": {
"totalDistance": 421057,
"totalTime": 18720,
"totalFare": 0,
"taxiFare": 31420,
"index": 1,
"pointIndex": 1,
"name": "출발지",
"description": "소공로 을 따라 소공로 방면으로 310m 이동",
"nextRoadName": "소공로",
"turnType": 200,
"pointType": "S"
}
},
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[
126.9823439963945,
37.56461982743129
],
[
126.98230789017299,
37.564453179812105
],
[
126.98210513804034,
37.563703265276516
],
[
126.98207180945346,
37.56352550784786
],
[
126.9817857308457,
37.56284502921221
],
[
126.98166907678578,
37.562633941789535
],
[
126.98157186492477,
37.56247284870586
],
[
126.98128300624569,
37.56205345097403
],
[
126.98124689891416,
37.56200067907546
]
],
"traffic": [0, 8, 4, 12]
},
"properties": {
"index": 2,
"lineIndex": 1,
"name": "소공로",
"description": "소공로, 310m",
"distance": 310,
"roadType": 0,
"facilityType": 0
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
126.98124689891416,
37.56200067907546
]
},
"properties": {
"index": 3,
"pointIndex": 2,
"name": "",
"description": "남산3호터널/ /반포대교 방면으로 좌회전 후 소공로 을 따라 190m 이동 ",
"nextRoadName": "소공로",
"turnType": 12,
"pointType": "N"
}
},
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[
126.98124689891416,
37.56200067907546
],
[
126.98156909903298,
37.561278542345434
],
[
126.98159131967861,
37.561234103176794
],
[
126.98162742833591,
37.5611507797013
],
[
126.98175797500768,
37.560850815192815
],
[
126.9819857366794,
37.56038975880062
]
],
"traffic": [0, 5, 2, 17]
},
"properties": {
"index": 4,
"lineIndex": 2,
"name": "소공로",
"description": "소공로, 190m",
"distance": 190,
"roadType": 0,
"facilityType": 0
}
}
]
}
- 자동차 경로안내 RESPONSE ( type : javascript )
{
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
126.9823439963945,
37.56461982743129
]
},
"properties": {
"totalDistance": 421057,
"totalTime": 18720,
"totalFare": 0,
"taxiFare": 34300,
"index": 1,
"pointIndex": 1,
"name": "출발지",
"description": "소공로 을 따라 소공로 방면으로 310m 이동",
"nextRoadName": "소공로",
"turnType": 200,
"pointType": "S"
}
},
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[
126.9823439963945,
37.56461982743129
],
[
126.98230789017299,
37.564453179812105
],
[
126.98210513804034,
37.563703265276516
],
[
126.98207180945346,
37.56352550784786
],
[
126.9817857308457,
37.56284502921221
],
[
126.98166907678578,
37.562633941789535
],
[
126.98157186492477,
37.56247284870586
],
[
126.98128300624569,
37.56205345097403
],
[
126.98124689891416,
37.56200067907546
]
],
"traffic": [0, 8, 4, 12]
},
"properties": {
"index": 2,
"lineIndex": 1,
"name": "소공로",
"description": "소공로, 310m",
"distance": 310,
"roadType": 0,
"facilityType": 0
}
},
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [
126.98124689891416,
37.56200067907546
]
},
"properties": {
"index": 3,
"pointIndex": 2,
"name": "",
"description": "남산3호터널/ /반포대교 방면으로 좌회전 후 소공로 을 따라 190m 이동 ",
"nextRoadName": "소공로",
"turnType": 12,
"pointType": "N"
}
},
{
"type": "Feature",
"geometry": {
"type": "LineString",
"coordinates": [
[
126.98124689891416,
37.56200067907546
],
[
126.98156909903298,
37.561278542345434
],
[
126.98159131967861,
37.561234103176794
],
[
126.98162742833591,
37.5611507797013
],
[
126.98175797500768,
37.560850815192815
],
[
126.9819857366794,
37.56038975880062
]
],
"traffic": [0, 5, 2, 17]
},
"properties": {
"index": 4,
"lineIndex": 2,
"name": "소공로",
"description": "소공로, 190m",
"distance": 190,
"roadType": 0,
"facilityType": 0
}
}
]
}
- 자동차 경로안내 RESPONSE ( type : json - totalValue="2"로 요청시 간소화)
{
"type": "FeatureCollection",
"features":[
{
"type": "Feature",
"properties":{
"totalDistance": 421057,
"totalTime": 18720,
"totalFare": 0,
"taxiFare": 34300
}
}
]
}
- Error code index
| 에러코드 목록은 Web service에서 Guide API의 console에서 확인 할 수 있습니다.