Sign in

v1

latestOpenAPI 3.1.02026-07-14320308.9 KB

타임머신 자동차 길 안내

post/routes/prediction

Query parameters

versionstring required

API 버전정보입니다.

resCoordTypestring

받고자 하는 응답 좌표계 유형을 지정합니다. <br>지구 위의 위치를 나타내는 좌표 타입 종류로, 투영 방법에 따라 다음과 같이 나뉩니다. <br><br>1) EPSG3857 <br>- Google Mercator<br><br> 2) WGS84GEO(기본값) <br>- 경위도 <br><br>3) KATECH <br>- TM128(Transverse Mercator:횡메카토르): 한국 표준

reqCoordTypestring

요청 좌표계 유형을 지정합니다. <br>지구 위의 위치를 나타내는 좌표 타입입니다. <br><br>1) EPSG3857 <br>- Google Mercator <br><br>2) WGS84GEO(기본값) <br>- 경위도 <br><br>3) KATECH <br>- TM128(Transverse Mercator:횡메카토르): 한국 표준

sortstring

지리정보 개체의 정렬 순서를 지정합니다. <br><br>1) index(기본값) <br>- 노드의 종류에 상관없이 인덱스의 순서로 정렬을 합니다. <br><br>2) custom <br>- 라인노드, 포인트노드의 순서로 정렬을 합니다.

callbackstring

jsonp 포맷에서 사용하는 callback 함수명 정보입니다. <br>- format=javascript 일 때 필수로 입력해야 합니다.

totalValueinteger

응답결과를 선택합니다. <br><br>1: <br>타임머신 자동차 길 안내 API의 전체 응답 데이터를 받을 경우<br><br> 2:<br> totalDistance(총 길이), <br>totalTime(총 소요 시간), <br>totalFare(총 요금 정보), <br>taxiFare(택시 예상 요금 정보), <br>departureTime(출발시간), <br>arrivalTime(도착시간)의 정보만 받을 경우

Headers

appKeystring required

<a href="https://openapi.sk.com/mypage/project/" target="_blank">마이페이지>앱</a>>앱키(appKey) 탭에서 확인 가능

Request body

RAW_BODYstring json required

{ <br>   "routesInfo": //길 안내 요청 정보 입니다. { <br>       "departure": //출발지 정보 입니다.{ <br>           "name": "test1"//출발지 명칭 입니다.,<br>           "lon": "126.963936"//출발지 경도 좌표 입니다.,<br>           "lat": "37.536025"//출발지 위도 좌표 입니다.,<br>           "depSearchFlag": "05"//출발지의 좌표를 획득한 방법을 선택하는 옵션 입니다. - 01 : 최근길, - 02 : 즐겨찾기, - 03 : 경위도검색(기본 값), - 04 : 명칭검색, - 05 : 주소검<br>       },<br>       "destination"://도착지 정보 입니다. {<br>           "name": "test2"//도착지 명칭 입니다.,<br>           "lon": "129.071724"//도착지 경도 좌표 입니다.,<br>           "lat": "35.177188"//도착지 위도 좌표 입니다.,<br>           "poiId": "1000559885"//도착지 POI ID(POI 검색 결과로 얻은 값)입니다.,<br>           "rpFlag":"16"//도착지 RP flag 입니다. 명칭(POI)통합 검색 사용시 결과로 리턴된 rpFlag를 사용하시면 됩니다.,<br>           "destSearchFlag": "03"//도착지의 좌표를 획득한 방법을 선택하는 옵션 입니다.- 01 : 최근길검색,- 02 : 즐겨찾기검색,- 03 : 경위도검색(기본 값),- 04 : 명칭검색,- 05 : 주소검색,- 06 : 통합검색<br>       },<br>     "predictionType":"departure"//경로 서비스의 구분 입니다. - departure : 출발시간 예측 길 안내. - arrival : 도착시간 예측 길 안내 ,<br>     "predictionTime": "2013-05-19T18:31:22+0900"//길 안내의 기준이 되는 출발 혹은 도착 시간 입니다. - predictionType = departure 일 때는 “도착시간”을, predictionType = arrival 일 경우에는 “출발시간”을 입력해야 합니다. - 형태 : ISO-8601 표준. - 예) 2013-05-19T18:31:22+0900,<br>     "wayPoints": //경유지 정보 입니다. - 경유지 정보 요청 시 필수 입니다.{<br>             "wayPoint"://경유지 정보 입니다. - 경유지 정보 요청 시 필수 입니다. [<br>                 {<br>                     "lon": "126.814383"//경유지 경도 좌표 입니다. - 경유지 정보 요청 시 필수 입니다.,<br>                     "lat": "35.157242"//경유지 위도 좌표 입니다. - 경유지 정보 요청 시 필수 입니다.,<br>                     "poiId": "1000559888"//경유지 POI ID 입니다.<br>                 },<br>                 {<br>                     "lon": "128.565503"//경유지 경도 좌표 입니다. - 경유지 정보 요청 시 필수 입니다.,<br>                     "lat": "35.874493"//경유지 위도 좌표 입니다. - 경유지 정보 요청 시 필수 입니다.,<br>                     "poiId": "1000559886"//경유지 POI ID 입니다.<br>                 }<br>             ]<br>         },<br>         "searchOption": "00"//경로탐색 시 우선순위를 정하는 옵션입니다. - 00 : 교통최적+추천 (기본 값) ,- 01 : 교통최적+무료우선 ,- 02 : 교통최적+최소시간 ,- 03 : 교통최적+초보 ,- 04 : 교통최적+고속도로우선 ,- 10 : 최단거리+유/무료 ,- 19 : 교통최적+어린이보호구역 회피,<br>         "tollgateCarType": "car"//톨게이트 요금의 기준이 되는 차량의 종류 입니다. - car : 승용차, 소형승합차(17인승이하), 소형화물차 (기본값) - mediumvan : 중형승합차(17인승초과~32인승이하), 중형화물차 - largevan : 대형승합차(33인승초과), 2축 대형화물차 - largetruck : 대형화물차(3축 대형화물차) - specialtruck : 특수화물차 (4축이상 특수화물차) - smallcar : 경차 (배기량 1000cc미만) - twowheel : 이륜차(오토바이),<br>         "trafficInfo" : "N"//교통정보 표출 옵션입니다.Y: 교통정보를 포함 N: 교통정보를 포함하지 않음<br>     }<br>}

Response

200

object required