RoutingParameters

경로 (결과 순위가 영향을 받는 경우) 및 결과에 대한 이동 시간 계산을 위해 응답의 장소에 대한 경로 계산을 구성하는 매개변수입니다.

JSON 표현
{
  "origin": {
    object (LatLng)
  },
  "travelMode": enum (TravelMode),
  "routeModifiers": {
    object (RouteModifiers)
  },
  "routingPreference": enum (RoutingPreference)
}
필드
origin

object (LatLng)

선택사항입니다. 다중선에 정의된 출발지를 재정의하는 명시적 라우팅 출발지입니다. 기본적으로 다중선 원점이 사용됩니다.

travelMode

enum (TravelMode)

선택사항입니다. 이동 수단입니다.

routeModifiers

object (RouteModifiers)

선택사항입니다. 경로 수정자.

routingPreference

enum (RoutingPreference)

선택사항입니다. 라우팅 요약을 계산하는 방법을 지정합니다. 서버는 선택된 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 트래픽 인식 라우팅 환경설정은 DRIVE 또는 TWO_WHEELER travelMode에만 사용할 수 있습니다.

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

boolean

선택사항입니다. true로 설정하면 합리적인 경우 유료 도로를 피하고 유료 도로가 포함되지 않은 경로를 우선합니다. DRIVETWO_WHEELER TravelMode에만 적용됩니다.

avoidHighways

boolean

선택사항입니다. true로 설정하면 합당한 경우 고속도로를 제외하여 고속도로가 포함되지 않은 경로를 우선시합니다. DRIVETWO_WHEELER TravelMode에만 적용됩니다.

avoidFerries

boolean

선택사항입니다. true로 설정하면 합리적인 경우 페리를 피하고 페리가 포함되지 않은 경로를 우선합니다. DRIVETWO_WHEELER TravelMode에만 적용됩니다.

avoidIndoor

boolean

선택사항입니다. true로 설정하면 합리적인 경우 실내에서 탐색하지 않고 실내 탐색이 포함되지 않은 경로를 우선합니다. WALK TravelMode에만 적용됩니다.

RoutingPreference

경로를 계산할 때 고려할 요소를 지정하는 값 집합입니다.

열거형
ROUTING_PREFERENCE_UNSPECIFIED 경로 환경설정이 지정되지 않았습니다. 기본값은 TRAFFIC_UNAWARE입니다.
TRAFFIC_UNAWARE 실시간 교통 상황을 고려하지 않고 경로를 계산합니다. 트래픽 상황이 중요하지 않거나 적용되지 않는 경우에 적합합니다. 이 값을 사용하면 지연 시간이 가장 짧아집니다. 참고: TravelMode DRIVETWO_WHEELER의 경우 선택한 경로와 소요 시간은 현재 도로 상황이 아닌 도로망 및 평균 시간과 무관한 교통상황을 기반으로 합니다. 따라서 경로에는 일시적으로 폐쇄된 도로가 포함될 수 있습니다. 지정된 요청의 결과는 도로망의 변화, 업데이트된 평균 교통상황, 분산된 서비스 특성으로 인해 시간이 지남에 따라 달라질 수 있습니다. 거의 동일한 경로 간에도 언제든지 또는 수시로 결과가 다를 수도 있습니다.
TRAFFIC_AWARE 실시간 교통상황을 고려하여 경로를 계산합니다. TRAFFIC_AWARE_OPTIMAL와 달리 지연 시간을 크게 줄이기 위해 일부 최적화가 적용됩니다.
TRAFFIC_AWARE_OPTIMAL 대부분의 성능 최적화를 적용하지 않고 실시간 트래픽 상태를 고려하여 경로를 계산합니다. 이 값을 사용하면 가장 긴 지연 시간이 생성됩니다.