v1
latestOpenAPI 3.1.02026-07-14320308.9 KB자동차 경로안내
Query parameters
API의 버전 정보입니다.
jsonp 포맷에서 사용하는 callback 함수명 정보입니다. <br>application/javascript 일 때 필수로 입력해야 합니다.
Headers
<a href="https://openapi.sk.com/mypage/project/" target="_blank">마이페이지>앱</a>>앱키(appKey) 탭에서 확인 가능
Request body
요금 가중치 정보입니다.<br><br><요금 가중치 옵션><br>- 1: 유/무료<br>- 2: 최적 요금<br>- 8: 무료 우선<br>-16: 로직판단(기본값)
출발 지점의 도로 타입 정보입니다. <br><출발 지점 도로 타입(상세위치 구분)><br>- 32:가까운 도로(기본값)<br>- 16: 일반도로<br>- 8: 지하도<br>- 4: 고가도<br>- 2: 도시 고속도로<br>- 1: 고속도로<br>- 0: 미선택
출발 지점의 주행 방향입니다.<br><br><출발 지점 주행 방향(우선/비우선 옵션)><br>- 0: 주행 방향 비우선(기본값)<br>- 1: 주행 방향 우선
목적지 X좌표입니다.<br>- 경도를 의미합니다.<br><br>[Example] EPSG3857 : 14368651.605895586<br>WGS84GEO :129.07579349764512<br>KATECH : 498181.0591427401
목적지 Y좌표입니다.<br>- 위도를 의미합니다.<br><br>[Example]<br>EPSG3857 : 4188210.3283031476<br>WGS84GEO : 35.17883196265564<br>KATECH : 287188.0233151837
목적지 POI ID(POI 검색 결과로 얻은 값)입니다.
목적지의 RP Flag 정보입니다.<br>명칭(POI)통합 검색 사용시 결과로 리턴된 rpFlag를 사용하시면 됩니다.
출발지, 경유지, 목적지 좌표계 유형을 지정합니다.<br><br>지구 위의 위치를 나타내는 좌표 타입입니다.<br>EPSG3857<br>- Google Mercator<br><br>WGS84GEO(기본값)<br>- 경위도<br><br>KATECH<br>- TM128(Transverse Mercator:횡메카토르): 한국 표준
출발지 X좌표입니다.<br>- 경도를 의미합니다.<br><br>[Example]<br>EPSG3857 : 14135591.321771959<br>WGS84GEO : 126.98217734415019<br>KATECH : 310278.5350755865
출발지 Y좌표입니다.<br>- 위도를 의미합니다.<br><br>[Example]<br>EPSG3857 : 4518111.822510956<br>WGS84GEO : 37.56468648536046<br>KATECH : 551869.0243206669
GPS 시각입니다.<br>- 년월일시분초 : YYYYMMDDhhmmss
각도입니다.<br>- 0~359
속도(차량 진행 속도 km/h)입니다.<br>- 0이상
위성수입니다.<br>- 0~12
측위 방법입니다.<br>- 1: 측위 불량<br>- 2: 2차원 측위<br>- 3: 3차원 측위
HDOP(Horizontal Dilution of Precision: 0.1단위로 정수화)입니다.<br>- 0 이상<br>예) 1.2 -> 12로 표기
톨게이트 요금에 대한 차종을 지정합니다.<br>- 0: 미선택(기본값)<br>- 1: 승용차<br>- 2: 중형승합차<br>- 3: 대형승합차<br>- 4: 대형화물차<br>- 5: 특수화물차<br>- 6: 경차<br>- 7: 이륜차
출발지 명칭입니다.<br>- UTF-8 기반 URL 인코딩 처리를 해야 합니다.
목적지 명칭입니다.<br>- UTF-8 기반 URL 인코딩 처리를 해야 합니다.
경로 탐색 옵션 입니다.<br>- 0: 교통최적+추천(기본값)<br>- 1: 교통최적+무료우선<br>- 2: 교통최적+최소시간<br>- 3: 교통최적+초보<br>- 4: 교통최적+고속도로우선<br>- 10: 최단거리+유/무료<br>- 12: 이륜차도로우선 (일반도로가 없는 경우 자동차 전용도로로 안내 할 수 있습니다.)<br>- 19: 교통최적+어린이보호구역 회피
경유지들의 X 좌표, Y 좌표를 콤마(,)와 밑줄()로 구분하여 순서대로 나열합니다. 경유지는 최대 5개 까지 지원합니다.<br><br>- 형식: 경유지1 X 좌표,경유지1 Y 좌표_경유지2 X 좌표,경유지2 Y 좌표...<br><br>[Example]<br>EPSG3857 : 14180382.309390113,4349064.210998647<br>WGS84GEO : 127.38454163183215,36.35127257501252<br>KATECH : 344955.1840998584,416909.51311973063
GPS 궤적 정보 목록(passList와 같이 콤마와 밑줄로 구분하여 순서대로 나열)입니다.<br>- 형식: 경도좌표,위도좌표,시각(hhmmss),각도(0~359),차량진행속도(km/h),위성수,측위방법(1:측위불량, 2: 2차원측위, 3: 3차원측위),HDOP(0.1단위로정수화),맵매칭코드(0:없음,1:성공,2:실패)
상세 위치를 확인합니다.<br><br><상세 위치 확인 코드><br>- 0: 고객의 상세 위치를 확인 안하는 경우<br>- 1: 고객의 상세 위치를 확인하는 경우<br>- 2: 상세 위치를 확인 안하는 서비스인 경우(기본값)
받고자 하는 응답 좌표계 유형을 지정합니다.<br> 지구위의 위치를 나타내는 좌표 타입입니다.<br>EPSG3857<br>- Google Mercator<br><br>WGS84GEO(기본값)<br>- 경위도<br><br>KATECH<br>- TM128(Transverse Mercator:횡메카토르): 한국 표준
지리정보 개체의 정렬 순서를 지정합니다.<br>index(기본값)<br>- 노드의 종류에 상관없이 인덱스의 순서로 정렬을 합니다.<br><br>custom<br>- 라인노드, 포인트노드의 순서로 정렬을 합니다.
응답결과를 선택합니다.<br>1: 자동차 경로안내 API의 전체 응답 데이터를 받을 경우<br>2: totalDistance(총 길이),<br>totalTime(총 소요 시간),<br>totalFare(총 요금 정보),<br>taxiFare(택시 예상 요금 정보)의 정보만 받을 경우
교통정보 표출 옵션입니다.<br>Y: 교통정보를 포함<br>N: 교통정보를 포함하지 않음
경로상 주요도로 정보 표출 옵션입니다.<br>Y: 주요도로 정보 표출<br>N: 주요도로 정보 표출하지 않음
Response
200