자동차 경로안내

post https://apis.openapi.sk.com/tmap/routes

Query Params

version

string

required

Defaults to 1

API의 버전 정보입니다.

callback

string

Defaults to function

jsonp 포맷에서 사용하는 callback 함수명 정보입니다.
application/javascript 일 때 필수로 입력해야 합니다.

Body Params

tollgateFareOption

int32

Defaults to 16

요금 가중치 정보입니다.

<요금 가중치 옵션>
- 1: 유/무료
- 2: 최적 요금
- 8: 무료 우선
-16: 로직판단(기본값)

roadType

int32

Defaults to 32

출발 지점의 도로 타입 정보입니다.
<출발 지점 도로 타입(상세위치 구분)>
- 32:가까운 도로(기본값)
- 16: 일반도로
- 8: 지하도
- 4: 고가도
- 2: 도시 고속도로
- 1: 고속도로
- 0: 미선택

directionOption

int32

Defaults to 1

출발 지점의 주행 방향입니다.

<출발 지점 주행 방향(우선/비우선 옵션)>
- 0: 주행 방향 비우선(기본값)
- 1: 주행 방향 우선

endX

float

required

Defaults to 129.07579349764512

목적지 X좌표입니다.
- 경도를 의미합니다.

[Example] EPSG3857 : 14368651.605895586
WGS84GEO :129.07579349764512
KATECH : 498181.0591427401

endY

float

required

Defaults to 35.17883196265564

목적지 Y좌표입니다.
- 위도를 의미합니다.

[Example]
EPSG3857 : 4188210.3283031476
WGS84GEO : 35.17883196265564
KATECH : 287188.0233151837

endPoiId

string

목적지 POI ID(POI 검색 결과로 얻은 값)입니다.

endRpFlag

string

Defaults to G

목적지의 RP Flag 정보입니다.
명칭(POI)통합 검색 사용시 결과로 리턴된 rpFlag를 사용하시면 됩니다.

reqCoordType

string

Defaults to WGS84GEO

출발지, 경유지, 목적지 좌표계 유형을 지정합니다.

지구 위의 위치를 나타내는 좌표 타입입니다.
EPSG3857
- Google Mercator

WGS84GEO(기본값)
- 경위도

KATECH
- TM128(Transverse Mercator:횡메카토르): 한국 표준

startX

float

required

Defaults to 126.98217734415019

출발지 X좌표입니다.
- 경도를 의미합니다.

[Example]
EPSG3857 : 14135591.321771959
WGS84GEO : 126.98217734415019
KATECH : 310278.5350755865

startY

float

required

Defaults to 37.56468648536046

출발지 Y좌표입니다.
- 위도를 의미합니다.

[Example]
EPSG3857 : 4518111.822510956
WGS84GEO : 37.56468648536046
KATECH : 551869.0243206669

gpsTime

string

Defaults to 20191125153000

GPS 시각입니다.
- 년월일시분초 : YYYYMMDDhhmmss

angle

int32

각도입니다.
- 0~359

speed

int32

Defaults to 10

속도(차량 진행 속도 km/h)입니다.
- 0이상

uncetaintyP

int32

Defaults to 1

위성수입니다.
- 0~12

uncetaintyA

int32

Defaults to 1

측위 방법입니다.
- 1: 측위 불량
- 2: 2차원 측위
- 3: 3차원 측위

uncetaintyAP

int32

Defaults to 1

HDOP(Horizontal Dilution of Precision: 0.1단위로 정수화)입니다.
- 0 이상
예) 1.2 -> 12로 표기

carType

int32

Defaults to 0

톨게이트 요금에 대한 차종을 지정합니다.
- 0: 미선택(기본값)
- 1: 승용차
- 2: 중형승합차
- 3: 대형승합차
- 4: 대형화물차
- 5: 특수화물차
- 6: 경차
- 7: 이륜차

startName

string

Defaults to %EC%9D%84%EC%A7%80%EB%A1%9C%20%EC%9E%85%EA%B5%AC%EC%97%AD

출발지 명칭입니다.
- UTF-8 기반 URL 인코딩 처리를 해야 합니다.

endName

string

Defaults to %ED%97%A4%EC%9D%B4%EB%A6%AC

목적지 명칭입니다.
- UTF-8 기반 URL 인코딩 처리를 해야 합니다.

searchOption

int32

경로 탐색 옵션 입니다.
- 0: 교통최적+추천(기본값)
- 1: 교통최적+무료우선
- 2: 교통최적+최소시간
- 3: 교통최적+초보
- 4: 교통최적+고속도로우선
- 10: 최단거리+유/무료
- 12: 이륜차도로우선 (일반도로가 없는 경우 자동차 전용도로로 안내 할 수 있습니다.)
- 19: 교통최적+어린이보호구역 회피

passList

string

Defaults to 127.38454163183215,36.35127257501252

경유지들의 X 좌표, Y 좌표를 콤마(,)와 밑줄()로 구분하여 순서대로 나열합니다. 경유지는 최대 5개 까지 지원합니다.

- 형식: 경유지1 X 좌표,경유지1 Y 좌표경유지2 X 좌표,경유지2 Y 좌표_...

[Example]
EPSG3857 : 14180382.309390113,4349064.210998647
WGS84GEO : 127.38454163183215,36.35127257501252
KATECH : 344955.1840998584,416909.51311973063

gpsInfoList

string

Defaults to 126.939376564495,37.470947057194365,120430,20,50,5,2,12,1_126.939376564495,37.470947057194365,120430,20,50,5,2,12,1

GPS 궤적 정보 목록(passList와 같이 콤마와 밑줄로 구분하여 순서대로 나열)입니다.
- 형식: 경도좌표,위도좌표,시각(hhmmss),각도(0~359),차량진행속도(km/h),위성수,측위방법(1:측위불량, 2: 2차원측위, 3: 3차원측위),HDOP(0.1단위로정수화),맵매칭코드(0:없음,1:성공,2:실패)

detailPosFlag

string

Defaults to 2

상세 위치를 확인합니다.

<상세 위치 확인 코드>
- 0: 고객의 상세 위치를 확인 안하는 경우
- 1: 고객의 상세 위치를 확인하는 경우
- 2: 상세 위치를 확인 안하는 서비스인 경우(기본값)

resCoordType

string

Defaults to WGS84GEO

받고자 하는 응답 좌표계 유형을 지정합니다.
지구위의 위치를 나타내는 좌표 타입입니다.
EPSG3857
- Google Mercator

WGS84GEO(기본값)
- 경위도

KATECH
- TM128(Transverse Mercator:횡메카토르): 한국 표준

sort

string

Defaults to index

지리정보 개체의 정렬 순서를 지정합니다.
index(기본값)
- 노드의 종류에 상관없이 인덱스의 순서로 정렬을 합니다.

custom
- 라인노드, 포인트노드의 순서로 정렬을 합니다.

totalValue

int32

응답결과를 선택합니다.
1: 자동차 경로안내 API의 전체 응답 데이터를 받을 경우
2: totalDistance(총 길이),
totalTime(총 소요 시간),
totalFare(총 요금 정보),
taxiFare(택시 예상 요금 정보)의 정보만 받을 경우

trafficInfo

string

교통정보 표출 옵션입니다.
Y: 교통정보를 포함
N: 교통정보를 포함하지 않음

mainRoadInfo

string

경로상 주요도로 정보 표출 옵션입니다.
Y: 주요도로 정보 표출
N: 주요도로 정보 표출하지 않음

Headers

Responses

Language

Credentials

Header


xxxxxxxxxx
31
1
curl --request POST \
2
     --url 'https://apis.openapi.sk.com/tmap/routes?version=1&callback=function' \
3
     --header 'accept: application/json' \
4
     --header 'appKey: e8wHh2tya84M88aReEpXCa5XTQf3xgo01aZG39k5' \
5
     --header 'content-type: application/json' \
6
     --data '
7
{
8
  "tollgateFareOption": 16,
9
  "roadType": 32,
10
  "directionOption": 1,
11
  "endX": 129.07579349764512,
12
  "endY": 35.17883196265564,
13
  "endRpFlag": "G",
14
  "reqCoordType": "WGS84GEO",
15
  "startX": 126.98217734415019,
16
  "startY": 37.56468648536046,
17
  "gpsTime": "20191125153000",
18
  "speed": 10,
19
  "uncetaintyP": 1,
20
  "uncetaintyA": 1,
21
  "uncetaintyAP": 1,
22
  "carType": 0,
23
  "startName": "%EC%9D%84%EC%A7%80%EB%A1%9C%20%EC%9E%85%EA%B5%AC%EC%97%AD",
24
  "endName": "%ED%97%A4%EC%9D%B4%EB%A6%AC",
25
  "passList": "127.38454163183215,36.35127257501252",
26
  "gpsInfoList": "126.939376564495,37.470947057194365,120430,20,50,5,2,12,1_126.939376564495,37.470947057194365,120430,20,50,5,2,12,1",
27
  "detailPosFlag": "2",
28
  "resCoordType": "WGS84GEO",
29
  "sort": "index"

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200200

401401