경로안내 샘플예제

타임머신 자동차 길 안내

  • 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 ( 타임머신 자동차 길 안내 )
NameDate TypeMandatoryExampleDefaultDescription
routesInfoNodeY길 안내 요청 정보 입니다.
departureNodeY출발지 정보 입니다.
nameStringY출발지 명칭 입니다.
lonNumberY출발지 경도 좌표 입니다.
latNumberY출발지 위도 좌표 입니다.
depSearchFlagStringN출발지의 좌표를 획득한 방법을 선택하는 옵션 입니다.
- 01 : 최근길
- 02 : 즐겨찾기
- 03 : 경위도검색(기본 값)
- 04 : 명칭검색
- 05 : 주소검색
destinationNodeY도착지 정보 입니다.
nameStringY도착지 명칭 입니다.
lonNumberY도착지 경도 좌표 입니다.
latNumberY도착지 위도 좌표 입니다.
poiIdStringN도착지 POI ID(POI 검색 결과로 얻은 값)입니다.
rpFlagStringN도착지 RP flag 입니다.
명칭(POI)통합 검색 사용시
결과로 리턴된 rpFlag를
사용하시면 됩니다.
destSearchFlagStringN도착지의 좌표를 획득한 방법을 선택하는 옵션 입니다.
- 01 : 최근길검색
- 02 : 즐겨찾기검색
- 03 : 경위도검색(기본 값)
- 04 : 명칭검색
- 05 : 주소검색
- 06 : 통합검색
wayPointsNodeN경유지 정보 입니다.
- 경유지 정보 요청 시 필수 입니다.
wayPointNodeN1경유지 정보 입니다.
- 경유지 정보 요청 시 필수 입니다.
lonStringY경유지 경도 좌표 입니다.
- 경유지 정보 요청 시 필수 입니다.
latStringY경유지 위도 좌표 입니다.
- 경유지 정보 요청 시 필수 입니다.
poiIdStringN경유지 POI ID 입니다.
predictionTypeStringY경로 서비스의 구분 입니다.
- departure : 출발시간 예측 길 안내.
- arrival : 도착시간 예측 길 안내
predictionTimeStringY길 안내의 기준이 되는 출발 혹은 도착 시간 입니다.
- predictionType = departure 일 때는 “도착시간”을, predictionType = arrival 일 경우에는 “출발시간”을 입력해야 합니다.
- 형태 : ISO-8601 표준.
- 예) 2013-05-19T18:31:22+0900
searchOptionStringN경로탐색 시 우선순위를 정하는 옵션입니다.
- 00 : 교통최적+추천 (기본 값)
- 01 : 교통최적+무료우선
- 02 : 교통최적+최소시간
- 03 : 교통최적+초보
- 04 : 교통최적+고속도로우선
- 10 : 최단거리+유/무료
- 19 : 교통최적+어린이보호구역 회피
tollgateCarTypeStringN톨게이트 요금의 기준이 되는 차량의 종류 입니다.
- car : 승용차, 소형승합차(17인승이하), 소형화물차 (기본값)
- mediumvan : 중형승합차(17인승초과~32인승이하), 중형화물차
- largevan : 대형승합차(33인승초과), 2축 대형화물차
- largetruck : 대형화물차(3축 대형화물차)
- specialtruck : 특수화물차 (4축이상 특수화물차)
- smallcar : 경차 (배기량 1000cc미만)
- twowheel : 이륜차(오토바이)
trafficInfoStringN교통정보 표출 옵션입니다.
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 ( 타임머신 자동차 길 안내 )
NameDate TypeMandatoryExampleDescription
typeStringYFeatureCollectiongeojson 표준 프로퍼티입니다.
featuresNodeN포인트 및 라인의 형상 정보입니다. (geojson 표준 규격)
typeStringNFeature출발점, 안내점, 경유지, 도착점 정보입니다.
geometryNodeN형상 정보 입니다. (geojson 표준 규격)
typeStringNPointgeometry의 type입니다.
coordinatesStringN좌표 정보입니다.
- 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
-형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]
propertiesNodeN사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격)
indexNumberN1경로 순번입니다.
pointIndexNumberN1안내점 노드의 순번입니다.
nameStringN지점명칭 ? 서울시시청안내지점의 명칭입니다.
descriptionStringN길 안내 정보입니다.
nextRoadNameStringN다음 구간의 도로 명칭입니다.
turnTypeNumberN회전 정보입니다.

- 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: 직진 임시
pointTypeStringN안내지점의 구분입니다.

- S: 출발지
- E: 도착지
- B1: 경유지1
- B2: 경유지2
- B3: 경유지3
- N: 일반 안내점
totalDistanceNumberN3000경로 총 길이(단위: m)입니다.

- pointType=S 일때 응답되는 정보입니다.
totalTimeNumberN600경로 총 소요 시간(단위: 초)입니다.
- pointType=S 일때 응답되는 정보입니다.
totalFareNumberN1500경로 총 요금 정보(단위:원)입니다.
- pointType=S 일때 응답되는 정보입니다.
taxiFareNumberN363000택시 예상 요금 정보(단위:원)입니다.
departureTimeDateN2013-05-19T18:31:22+00:00출발 시간 입니다.
- 형식 : ISO-8601 표준
arrivalTimeDateN2013-05-19T18:31:22+00:00도착 시간 입니다.
- 형식 : ISO-8601 표준
typeStringNFeature구간의 정보입니다.
geometryNodeN형상 정보 입니다. (geojson 표준 규격)
typeStringNLineStringgeometry의 type입니다.
coordinatesStringN좌표 정보입니다.

- 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
- 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]
propertiesNodeN사용자 정의 프로퍼티 정보입니다. (geojson 표준 규격)
indexNumberN1경로 순번입니다.
lineIndexStringN링크의 순번입니다.
nameStringN구간명칭- 동일로구간 명칭 또는 안내지점의 명칭입니다.
descriptionStringN길 안내 정보입니다.
distanceNumberN구간 거리(단위: m)입니다.
timeNumberN구간 통과 시간(단위:초) 입니다.
roadTypeNumberN도로 타입 정보입니다.
<도로 타입 코드(상세 위치 구분)>
- 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: 번화가링크
facilityTypeNumberN구간의 시설물 타입 정보입니다.

<구간의 시설물 타입>
- 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 ( 직선 거리 계산 )
NameDate TypeMandatoryExampleDescription
distanceInfoNodeY
distanceStringY좌표 간 직선거리(단위: 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 ( 보행자 경로안내 )
NameDate TypeMandatoryExampleDescription
typeStringYFeatureCollectiongeojson 표준 프로퍼티입니다.
featuresNodeN포인트 및 라인의 형상 정보입니다.
(geojson 표준 규격)
typeStringNFeature출발점, 안내점, 경유지, 도착점 정보입니다.
geometryNodeN형상 정보 입니다. (geojson 표준 규격)
typeStringNPoint형상 정보 데이터의 종류입니다.(geojson 표준 규격)
coordinatesStringN좌표 정보입니다.
- 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
-형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]
propertiesNodeN사용자 정의 프로퍼티 정보입니다.
(geojson 표준 규격)
indexStringN경로 순번입니다.
pointIndexNodeN1안내점 노드의 순번입니다.
nameStringN서울시시청안내지점의 명칭입니다.
descriptionStringN길 안내 정보입니다.
directionStringN방면 명칭입니다.
intersectionNameStringN교차로 명칭입니다.
nearPoiXStringN안내지점 근방 poi X좌표 입니다.
nearPoiYStringN안내지점 근방 poi Y좌표 입니다.
nearPoiNameStringN안내지점 근방 poi 입니다.
turnTypeNumberN회전 정보입니다.

- 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: 직진 임시
pointTypeStringN안내지점의 구분입니다.

- SP: 출발지
- EP: 도착지
- PP: 경유지
- PP1: 경유지1
- PP2: 경유지2
- PP3: 경유지3
- PP4: 경유지4
- PP5: 경유지5
- GP: 일반 안내점
facilityTypeStringN구간의 시설물 정보입니다.

<구간의 시설물 타입>
- 1: 교량
- 2: 터널
- 3: 고가도로
- 11: 일반보행자도로
- 12: 육교
- 14: 지하보도
- 15: 횡단보도
- 16: 대형시설물이동통로
- 17: 계단
facilityNameStringN교량구간 시설물 타입의 명칭입니다.
totalDistanceNumberN3000경로 총 길이(단위:m)입니다.
- pointType=SP 일때 응답되는 정보입니다
totalTimeNumberN600경로 총 소요시간(단위: 초)입니다.
- pointType=SP 일때 응답되는 정보입니다
typeStringNFeature 도로 구간의 정보입니다.
geometryNodeN형상 정보 입니다.(geojson 표준 규격)
typeStringNLineString형상 정보 데이터의 종류입니다.(geojson 표준 규격)
coordinatesStringN좌표 정보입니다.

- 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
- 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]
propertiesNodeN사용자 정의 프로퍼티 정보입니다.(geojson 표준 규격)
indexNumberN1경로 순번입니다.
lineIndexNumberN1구간의 순번입니다.
nameStringN동일로도로 명칭 입니다.
descriptionStringN길 안내 정보입니다.
timeNumberN구간의 소요 시간(단위 : 초)입니다.
distanceNumberN구간 거리(단위 : m)입니다.
roadTypeNumberN도로 타입 정보입니다.

<도로 타입 코드(상세 위치 구분)>
- 21: 보행자도로 1 (차도와 인도가 분리되어 있으며 정해진 횡단구역으로만 횡단 가능한 보행자 도로 )
- 22: 보행자도로 2 (차도와 인도가 분리되어 있지 않거나, 보행자 횡단에 제약이 없는 보행자도로 )
- 23: 보행자도로 3 (차량 통행이 불가능한 보행자도로 )
- 24: 보행자도로 4 (쾌적하지 않은 도로 )
categoryRoadTypeNumberN특화거리 정보입니다.

<특화거리 코드>
- 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 ( 자동차 경로안내 )
NameDate TypeMandatoryExampleDescription
typeStringYFeatureCollectiongeojson 표준 프로퍼티입니다.
featuresNodeN포인트 및 라인의 형상 정보입니다.
(geojson 표준 규격)
typeStringNFeature출발점, 안내점, 경유지, 도착점 정보입니다.
geometryNodeN형상 정보 입니다. (geojson 표준 규격)
typeStringNPointgeometry의 type입니다.
coordinatesStringN좌표 정보입니다.
- 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
-형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]
propertiesNodeN사용자 정의 프로퍼티 정보입니다.
(geojson 표준 규격)
indexStringN경로 순번입니다.
lineIndexStringN링크의 순번입니다.
pointIndexNodeN아이콘 노드입니다.
nameStringN지점명칭 ? 서울시시청안내지점의 명칭입니다.
descriptionStringN길 안내 정보입니다.
nextRoadNameStringN다음 구간의 도로 명칭입니다.
turnTypeNumberN회전 정보입니다.

- 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: 직진 임시
pointTypeStringN안내지점의 구분입니다.

- S: 출발지
- E: 도착지
- B1: 경유지1
- B2: 경유지2
- B3: 경유지3
- N: 일반 안내점
totalDistanceNumberN3000경로 총 길이(단위: m)입니다.
- pointType=S 일때 응답되는 정보입니다.
totalTimeNumberN600경로 총 소요 시간(단위: 초)입니다.
- pointType=S 일때 응답되는 정보입니다.
totalFareNumberN1500경로 총 요금 정보(단위:원)입니다.
- pointType=S 일때 응답되는 정보입니다.
taxiFareNumberN363000택시 예상 요금 정보(단위:원)입니다.
typeStringNFeature구간의 정보입니다.
geometryNodeN형상 정보 입니다. (geojson 표준 규격)
typeStringNLineStringgeometry의 type입니다.
coordinatesStringN좌표 정보입니다.

- 경도와 위도는 콤마(,)로 구분하여 '[',']'으로 묶어주고
복수 좌표 역시 콤마로 구분하여 '[',']'으로 묶어줍니다.
- 형식: [[x1좌표, y1좌표], [x2좌표, y2좌표]]
trafficStringN교통 정보입니다.
[시작index, 마지막index,
혼잡도, 속도]

< 혼잡도 >
- 0: 정보없음
- 1: 원할
- 2: 서행
- 3: 지체
- 4: 정체
propertiesNodeN사용자 정의 프로퍼티 정보입니다.
(geojson 표준 규격)
indexNumberN경로 순번입니다.
nameStringN1구간 명칭 또는 안내지점의 명칭입니다.
descriptionStringN구간명칭- 동일로길 안내 정보입니다.
distanceNumberN구간 거리(단위: m)입니다.
timeNumberN구간 통과 시간(단위:초) 입니다.
roadTypeNumberN도로 타입 정보입니다.
<도로 타입 코드(상세 위치 구분)>
- 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: 번화가링크
facilityTypeNumberN구간의 시설물 타입 정보입니다.

<구간의 시설물 타입>
- 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에서 확인 할 수 있습니다.