inavi

모빌리티를 위한 다중 경유지 추가 100

다수의 경유지를 추가로 반영하여 경로 탐색이 가능한 다중 경유지 추가 기능을 활용해보세요.
- 다수의 경유지 추가 지정이 발생할 수 있는 딜리버리 및 모빌리티 서비스에 적합합니다.
- 최대 100개의 다중 경유지를 추가할 수 있어 운영 효율성을 극대화할 수 있습니다.

Request URL

Http MethodURL
POSThttps://imaps.inavi.com/maps/v3.0/appkeys/{appkey}/route-normal-via

Request Path Parameter

타입설명
appKeyString고유의 appKey

Request Body Parameter

타입필수설명
startXString출발지 X좌표
startYString출발지 Y좌표
endXString목적지 X좌표
endYString목적지 Y좌표
optionString경로 탐색 옵션
  • 탐색 option 하나만 가능
  • ex) option=real_traffic
  • real_traffic : 실시간 추천1
  • real_traffic2 : 실시간 추천2
  • real_traffic_freeroad : 실시간 (무료)
  • short_distance_priority : 최단거리
  • motorcycle : 이륜차
  • recommendation : 추천
  • highway_priority : 고속도로 우선
coordTypeString좌표 타입
  • Default : wgs84
  • tw : 팅크웨어 좌표
  • wgs84 : 세계 표준 좌표
viaList
(Object Array)
경유지 정보
viaXString경유지 X좌표
viaYString경유지 Y좌표
useAngleBoolean출발 지점의 주행 방향 옵션
  • Default: false
  • true : 주행 방향 우선
  • false : 주행 방향 비우선
angleInteger각도
  • Default: 0
  • useAngle 이 true 일 때만 동작, 0 ˚~ 359 ˚ 까지 사용 가능
carTypeInt톨게이트비 계산을 위한 차종
  • Default : 1
  • ex) carType=1
  • 1 : 1종 (소형차)
  • 2 : 2종 (중형차)
  • 3 : 3종 (대형차)
  • 4 : 4종 (대형화물차)
  • 5 : 5종 (특수화물차)
  • 6 : 경차 (통행료할인적용)
groupByTrafficColorBoolean세부 경로 목록 (paths) 정보를 교통색상별로 그룹핑하여 반환할지 여부
Default : false
useTaxifareString예상 택시 요금 조회 여부
  • Default : 0
  • 0 : 미사용
  • 1 : 사용
useStartDirectionBoolean출발지 좌표 기준 탐색 방향 지정 프로젝션 기능 여부
  • Default : false
searchByAddressBoolean주소 기반 경로 탐색 여부
  • Default : false
usageTypeInt차량 용도
  • Default : 0
  • 일반 : 0
  • 택시 : 1 (탐색 옵션이 recommendation 일 경우에만 적용)
carWeightInt차량 무게 (kg)
  • Default : 0
  • carType 이 4 혹은 5일 경우에 적용
carHeightInt차량 높이 (cm)
  • Default : 0
  • carType 이 4 혹은 5일 경우에 적용
avoidWaterSourceAreaBoolean상수원 보호구역 진입 제한 여부 (위험물 적재 여부)
  • Default : false
avoidNarrowRoadInt좁은 길 회피 차선 개수 정보
  • Default : 0
  • ( ex. 값이 6 일 경우, 왕복 6차선이하 도로에서는 차종에 관계 없이 모두 회피 )
avoidUTurnInt유턴 회피 차선 개수 정보
  • Default : 0
  • ( ex. 값이 6 일 경우, 왕복 6차선이하 도로에서는 차종에 관계 없이 모두 회피 )

Response Field

타입설명
header
(Object)
isSuccessfulBoolean성공 여부
resultCodeInteger실패 코드
resultMessageString실패 메시지
route
(Object)
data
(Array)
경로 정보
optionString탐색 옵션
spend_timeInt소요 시간 (초)
distanceInt거리 (m)
toll_feeInt톨게이트 요금
taxiFareInt예상 택시 요금
useTaxifare값이 1,2 일때만 결과값 표출, totalTaxiFare 사용 권장
totalTaxiFareString예상 택시 요금
(모든 useTaxifare 값에 사용)useTaxifare값이 3 일때 일반택시, 모범택시 요금 표출
paths
(Object Array)
세부 경로 목록
coords
(Object Array)
상세 좌표 목록
xDoubleX좌표
  • (coordType에 따라 tw 또는 wgs84 좌표로 반환가능)
yDoubleY좌표
  • (coordType에 따라 tw 또는 wgs84 좌표로 반환가능)
speedInt속도 (km)
spend_timeInt소요 시간 (초)
distanceInt거리 (m)
road_codeInt도로 종별 코드
  • 0 : 페리항로
  • 1 : 고속도로
  • 2 : 도시고속
  • 3 : 국도
  • 4 : 지방도
  • 5 : 일반도로
traffic_colorString도로 교통 색상
point_typeString경로 타입
  • S : 출발지
  • V : 경유지
  • E : 도착지