---
title: "타임머신 자동차 길 안내"
method: POST
path: "/routes/prediction"
---

# 타임머신 자동차 길 안내

`POST /routes/prediction`

## Query parameters

- `version` string, required
- `resCoordType` string
- `reqCoordType` string
- `sort` string
- `callback` string
- `totalValue` integer

## Headers

- `appKey` string, required

## Request body

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

## Response `200`

200

- object

## Other responses

- `401` — 401

---

[API](https://skmtc.net/sk/apis/tmap-api-2.md) · [All operations](https://skmtc.net/sk/apis/tmap-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sk/tmap-api-2/versions/2539b7eaa35a/schema)