경로안내 샘플예제

타임머신 자동차 길 안내

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	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에서 확인 할 수 있습니다.

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에서 확인 할 수 있습니다.

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에서 확인 할 수 있습니다.

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에서 확인 할 수 있습니다.

API Console로 이동하기