경로 (결과 순위가 영향을 받는 경우) 및 결과에 대한 이동 시간 계산을 위해 응답의 장소에 대한 경로 계산을 구성하는 매개변수입니다.
JSON 표현 |
---|
{ "origin": { object ( |
필드 | |
---|---|
origin |
선택사항입니다. 다중선에 정의된 출발지를 재정의하는 명시적 경로 출발지입니다. 기본적으로 다중선 원점이 사용됩니다. |
travelMode |
선택사항입니다. 이동 수단입니다. |
routeModifiers |
선택사항입니다. 경로 수정자. |
routingPreference |
선택사항입니다. 라우팅 요약을 계산하는 방법을 지정합니다. 서버는 선택한 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 트래픽 인식 라우팅 환경설정은 |
TravelMode
이동 수단 옵션입니다. 이러한 옵션은 Routes API에서 제공하는 항목에 매핑됩니다.
열거형 | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
지정된 이동 수단이 없습니다. 기본값은 DRIVE 입니다. |
DRIVE |
승용차로 이동합니다. |
BICYCLE |
자전거로 이동합니다. searchAlongRouteParameters 에서 지원되지 않습니다. |
WALK |
도보 이동 searchAlongRouteParameters 에서는 지원되지 않습니다. |
TWO_WHEELER |
스쿠터, 오토바이 등 모든 종류의 이륜차 이는 인간 동력 운송을 다루는 BICYCLE 이동 수단과는 다릅니다. searchAlongRouteParameters 에서 지원되지 않습니다. 이륜차 지원 국가 및 지역에 나열된 국가에서만 지원됩니다. |
RouteModifiers
경로를 계산할 때 충족할 선택적 조건 집합을 캡슐화합니다.
JSON 표현 |
---|
{ "avoidTolls": boolean, "avoidHighways": boolean, "avoidFerries": boolean, "avoidIndoor": boolean } |
필드 | |
---|---|
avoidTolls |
선택사항입니다. true로 설정하면 합당한 경우 유료 도로를 제외하여 유료 도로가 포함되지 않은 경로를 우선 적용합니다. |
avoidHighways |
선택사항입니다. true로 설정하면 합당한 경우 고속도로를 제외하여 고속도로가 포함되지 않은 경로를 우선시합니다. |
avoidFerries |
선택사항입니다. true로 설정하면 합당한 경우 페리를 제외하여 페리가 포함되지 않은 경로를 우선 적용합니다. |
avoidIndoor |
선택사항입니다. true로 설정하면 합리적인 경우 실내 내비게이션을 사용하지 않고 실내 내비게이션이 포함되지 않은 경로를 우선 적용합니다. |
RoutingPreference
경로를 계산할 때 고려할 요소를 지정하는 값의 집합입니다.
열거형 | |
---|---|
ROUTING_PREFERENCE_UNSPECIFIED |
경로 환경설정이 지정되지 않았습니다. 기본값은 TRAFFIC_UNAWARE 입니다. |
TRAFFIC_UNAWARE |
실시간 교통상황을 고려하지 않고 경로를 계산합니다. 교통상황이 중요하지 않거나 관련이 없는 경우에 적합합니다. 이 값을 사용하면 지연 시간이 가장 짧아집니다. 참고: DRIVE 및 TWO_WHEELER 의 경우 선택한 경로와 소요 시간은 현재 도로 상황이 아닌 도로망 및 평균 시간과 무관한 교통상황을 기반으로 합니다. 따라서 일시적으로 폐쇄된 도로가 경로에 포함될 수 있습니다. 지정된 요청의 결과는 도로망의 변화, 평균 교통상황의 업데이트 및 분산된 서비스 특성으로 인해 시간이 지남에 따라 달라질 수 있습니다. 거의 동일한 경로 간에도 언제든지 또는 수시로 결과가 달라질 수 있습니다. |
TRAFFIC_AWARE |
실시간 교통상황을 고려하여 경로를 계산합니다. TRAFFIC_AWARE_OPTIMAL 와 달리 지연 시간을 크게 줄이기 위해 일부 최적화가 적용됩니다. |
TRAFFIC_AWARE_OPTIMAL |
대부분의 성능 최적화를 적용하지 않고 실시간 트래픽 상태를 고려하여 경로를 계산합니다. 이 값을 사용하면 가장 긴 지연 시간이 생성됩니다. |