Routes Preferred API는 현재 일부 고객만 이용할 수 있습니다. 자세한 내용은 영업팀에 문의하세요.

이 페이지는 Cloud Translation API를 통해 번역되었습니다.

Package google.maps.routes.v1

색인

RoutesPreferred(인터페이스)
ComputeCustomRoutesRequest(메시지)
ComputeCustomRoutesResponse(메시지)
ComputeCustomRoutesResponse.FallbackInfo(메시지)
ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective(열거형)
ComputeRouteMatrixRequest(메시지)
ComputeRoutesRequest(메시지)
ComputeRoutesResponse(메시지)
CustomRoute(메시지)
FallbackInfo(메시지)
FallbackReason(열거형)
FallbackRoutingMode(열거형)
Location(메시지)
Maneuver(열거형)
NavigationInstruction(메시지)
Polyline(메시지)
PolylineEncoding(열거형)
PolylineQuality(열거형)
Route(메시지)
RouteLeg(메시지)
RouteLegStep(메시지)
RouteLegStepTravelAdvisory(메시지)
RouteLegTravelAdvisory(메시지)
RouteMatrixDestination(메시지)
RouteMatrixElement(메시지)
RouteMatrixElementCondition(열거형)
RouteMatrixOrigin(메시지)
RouteModifiers(메시지)
RouteObjective(메시지)
RouteObjective.RateCard(메시지)
RouteObjective.RateCard.MonetaryCost(메시지)
RouteTravelAdvisory(메시지)
RouteTravelMode(열거형)
RoutingPreference(열거형)
SpeedReadingInterval(메시지)
SpeedReadingInterval.Speed(열거형)
TollInfo(메시지)
TollPass(열거형)
Units(열거형)
VehicleEmissionType(열거형)
VehicleInfo(메시지)
Waypoint(메시지)

RoutesPreferred

Routes Preferred API

ComputeCustomRoutes

ComputeCustomRoutes
`rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)` 터미널 및 중간 경유지 집합과 경로 목표를 고려하여 경로 목표에 대한 최적의 경로를 계산합니다. 또한 가장 빠른 경로와 최단 경로를 참조 경로로 반환합니다. 참고: 이 메서드를 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 `$fields` 또는 `fields`를 사용하거나 HTTP/gRPC 헤더 `X-Goog-FieldMask`를 사용하여 응답 필드 마스크를 제공할 수 있습니다 (사용 가능한 URL 매개변수 및 헤더 참조). 값은 필드 경로의 쉼표로 구분된 목록입니다. 필드 경로를 구성하는 방법에 관한 자세한 문서를 참고하세요. 예를 들어 이 메서드에서 다음을 실행합니다. 사용 가능한 모든 필드의 필드 마스크(수동 검사용): `X-Goog-FieldMask: ` 경로 거리, 소요 시간, 토큰, 통행료 정보의 필드 마스크: `X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo` 다음과 같은 이유로 와일드 카드 (``) 응답 필드 마스크를 사용하거나 최상위 수준 (`routes`)에서 필드 마스크를 지정하는 것은 권장하지 않습니다. 필요한 필드만 선택하면 서버에서 계산 주기를 절약하여 지연 시간을 단축하여 결과를 반환할 수 있습니다. 프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능을 보장할 수 있습니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가되는 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다. 필요한 필드만 선택하면 응답 크기가 작아져 네트워크 처리량이 높아집니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/maps-platform.routespreferred` 자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

터미널 및 중간 경유지 집합과 경로 목표를 고려하여 경로 목표에 대한 최적의 경로를 계산합니다. 또한 가장 빠른 경로와 최단 경로를 참조 경로로 반환합니다.

참고: 이 메서드를 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 $fields 또는 fields를 사용하거나 HTTP/gRPC 헤더 X-Goog-FieldMask를 사용하여 응답 필드 마스크를 제공할 수 있습니다 (사용 가능한 URL 매개변수 및 헤더 참조). 값은 필드 경로의 쉼표로 구분된 목록입니다. 필드 경로를 구성하는 방법에 관한 자세한 문서를 참고하세요.

예를 들어 이 메서드에서 다음을 실행합니다.

사용 가능한 모든 필드의 필드 마스크(수동 검사용): X-Goog-FieldMask: *
경로 거리, 소요 시간, 토큰, 통행료 정보의 필드 마스크: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

다음과 같은 이유로 와일드 카드 (*) 응답 필드 마스크를 사용하거나 최상위 수준 (routes)에서 필드 마스크를 지정하는 것은 권장하지 않습니다.

필요한 필드만 선택하면 서버에서 계산 주기를 절약하여 지연 시간을 단축하여 결과를 반환할 수 있습니다.
프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능을 보장할 수 있습니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가되는 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다.
필요한 필드만 선택하면 응답 크기가 작아져 네트워크 처리량이 높아집니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/maps-platform.routespreferred

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)` 출발지 및 목적지 목록을 사용하고 출발지와 목적지의 각 조합에 대한 경로 정보가 포함된 스트림을 반환합니다. 참고: 이 방법을 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 `$fields` 또는 `fields`를 사용하거나 HTTP/gRPC 헤더 `X-Goog-FieldMask`를 사용하여 응답 필드 마스크를 제공할 수 있습니다(사용 가능한 URL 매개변수 및 헤더 참고). 값은 쉼표로 구분된 필드 경로 목록입니다. 필드 경로를 구성하는 방법에 관한 자세한 문서를 참고하세요. 예를 들어 이 메서드에서 사용 가능한 모든 필드의 필드 마스크(수동 검사용): `X-Goog-FieldMask: ` 경로 시간, 거리, 요소 상태, 조건, 요소 색인의 필드 마스크(프로덕션 설정 예시): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` 필드 마스크에 `status`를 포함해야 합니다. 그렇지 않으면 모든 메시지가 정상적으로 표시됩니다. 와일드 카드(``) 응답 필드 마스크는 다음과 같은 이유로 권장되지 않습니다. 필요한 필드만 선택하면 서버에서 계산 주기를 절약하여 지연 시간을 단축하여 결과를 반환할 수 있습니다. 프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능을 보장할 수 있습니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가되는 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다. 필요한 필드만 선택하면 응답 크기가 작아져 네트워크 처리량이 높아집니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/maps-platform.routespreferred` 자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

출발지 및 목적지 목록을 사용하고 출발지와 목적지의 각 조합에 대한 경로 정보가 포함된 스트림을 반환합니다.

참고: 이 방법을 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 $fields 또는 fields를 사용하거나 HTTP/gRPC 헤더 X-Goog-FieldMask를 사용하여 응답 필드 마스크를 제공할 수 있습니다(사용 가능한 URL 매개변수 및 헤더 참고). 값은 쉼표로 구분된 필드 경로 목록입니다. 필드 경로를 구성하는 방법에 관한 자세한 문서를 참고하세요.

예를 들어 이 메서드에서

사용 가능한 모든 필드의 필드 마스크(수동 검사용): X-Goog-FieldMask: *
경로 시간, 거리, 요소 상태, 조건, 요소 색인의 필드 마스크(프로덕션 설정 예시): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

필드 마스크에 status를 포함해야 합니다. 그렇지 않으면 모든 메시지가 정상적으로 표시됩니다. 와일드 카드(*) 응답 필드 마스크는 다음과 같은 이유로 권장되지 않습니다.

필요한 필드만 선택하면 서버에서 계산 주기를 절약하여 지연 시간을 단축하여 결과를 반환할 수 있습니다.
프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능을 보장할 수 있습니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가되는 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다.
필요한 필드만 선택하면 응답 크기가 작아져 네트워크 처리량이 높아집니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/maps-platform.routespreferred

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)` 지정된 일련의 터미널 및 중간 경유지가 지정된 기본 경로와 선택적 대체 경로를 반환합니다. 참고: 이 메서드를 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 `$fields` 또는 `fields`를 사용하거나 HTTP/gRPC 헤더 `X-Goog-FieldMask`를 사용하여 응답 필드 마스크를 제공할 수 있습니다 (사용 가능한 URL 매개변수 및 헤더 참조). 값은 쉼표로 구분된 필드 경로 목록입니다. 필드 경로를 구성하는 방법에 관한 자세한 문서를 참고하세요. 예를 들어 이 메서드에서 사용 가능한 모든 필드의 필드 마스크 (수동 검사용): `X-Goog-FieldMask: ` 경로 수준 소요 시간, 거리, 다중선의 필드 마스크 (프로덕션 설정 예): `X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` 와일드 카드(``) 응답 필드 마스크를 사용하거나 최상위 수준에서 필드 마스크를 지정하는 것은 권장하지 않습니다. 다음과 같은 이유 때문입니다. 필요한 필드만 선택하면 서버에서 계산 주기를 절약하여 지연 시간을 단축하여 결과를 반환할 수 있습니다. 프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능을 보장할 수 있습니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가되는 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다. 필요한 필드만 선택하면 응답 크기가 작아져 네트워크 처리량이 높아집니다. 승인 범위 다음 OAuth 범위가 필요합니다. `https://www.googleapis.com/auth/maps-platform.routespreferred` 자세한 내용은 OAuth 2.0 개요를 참고하세요.

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

지정된 일련의 터미널 및 중간 경유지가 지정된 기본 경로와 선택적 대체 경로를 반환합니다.

참고: 이 메서드를 사용하려면 입력에 응답 필드 마스크를 지정해야 합니다. URL 매개변수 $fields 또는 fields를 사용하거나 HTTP/gRPC 헤더 X-Goog-FieldMask를 사용하여 응답 필드 마스크를 제공할 수 있습니다 (사용 가능한 URL 매개변수 및 헤더 참조). 값은 쉼표로 구분된 필드 경로 목록입니다. 필드 경로를 구성하는 방법에 관한 자세한 문서를 참고하세요.

예를 들어 이 메서드에서

사용 가능한 모든 필드의 필드 마스크 (수동 검사용): X-Goog-FieldMask: *
경로 수준 소요 시간, 거리, 다중선의 필드 마스크 (프로덕션 설정 예): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

와일드 카드(*) 응답 필드 마스크를 사용하거나 최상위 수준에서 필드 마스크를 지정하는 것은 권장하지 않습니다. 다음과 같은 이유 때문입니다.

필요한 필드만 선택하면 서버에서 계산 주기를 절약하여 지연 시간을 단축하여 결과를 반환할 수 있습니다.
프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능을 보장할 수 있습니다. 향후 더 많은 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가되는 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다.
필요한 필드만 선택하면 응답 크기가 작아져 네트워크 처리량이 높아집니다.

승인 범위

다음 OAuth 범위가 필요합니다.

https://www.googleapis.com/auth/maps-platform.routespreferred

자세한 내용은 OAuth 2.0 개요를 참고하세요.

ComputeCustomRoutesRequest

ComputeCustomRoutes 요청 메시지

필드
`origin`	`Waypoint` 필수 항목입니다. 출발지 경유지입니다.
`destination`	`Waypoint` 필수 항목입니다. 도착 웨이포인트
`intermediates[]`	`Waypoint` 선택사항입니다. 경로(터미널 지점 제외)에 있는 경유지의 집합으로, 경유지에서 정차하거나 경유합니다. 최대 25개의 중간 경유지가 지원됩니다.
`travel_mode`	`RouteTravelMode` 선택사항입니다. 이동수단을 지정합니다. `DRIVE` 및 'TWO_WHEELER'만 지원됩니다.
`routing_preference`	`RoutingPreference` 선택사항입니다. 경로를 계산하는 방법을 지정합니다. 서버는 선택한 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정으로 인해 오류가 발생하거나 지연 시간이 너무 길어지면 오류가 반환됩니다. `travel_mode`이 `DRIVE` 또는 `TWO_WHEELER`인 경우에만 이 옵션을 지정할 수 있으며, 그렇지 않으면 요청이 실패합니다.
`polyline_quality`	`PolylineQuality` 선택사항입니다. 다중선의 품질에 대한 환경설정을 지정합니다.
`polyline_encoding`	`PolylineEncoding` 선택사항입니다. 다중선의 기본 인코딩을 지정합니다.
`departure_time`	`Timestamp` 선택사항입니다. 출발 시간입니다. 이 값을 설정하지 않으면 기본값은 요청한 시간입니다. 이 값을 이미 발생한 시간으로 설정하면 요청이 실패합니다.
`route_modifiers`	`RouteModifiers` 선택사항입니다. 경로 계산 방식에 영향을 주는 일련의 조건입니다.
`route_objective`	`RouteObjective` 필수 항목입니다. 최적화할 경로 목표입니다.
`language_code`	`string` 선택사항입니다. BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn') 자세한 내용은 유니코드 언어 식별자를 참고하세요. 지원되는 언어 목록은 언어 지원을 참고하세요. 이 값을 제공하지 않으면 경로 요청의 위치에서 표시 언어가 추론됩니다.
`units`	`Units` 선택사항입니다. 표시 필드의 측정 단위를 지정합니다. 여기에는 `NavigationInstruction`의 `instruction` 필드가 포함됩니다. 경로, 구간, 걸음 수와 소요 시간에 사용되는 측정 단위는 이 값의 영향을 받지 않습니다. 이 값을 제공하지 않으면 요청 위치에서 표시 단위가 추론됩니다.

ComputeCustomRoutesResponse

ComputeCustomRoutes 응답 메시지

필드
`routes[]`	`CustomRoute` 입력된 경로 목표에 가장 적합한 '최적의' 경로입니다.
`fastest_route`	`CustomRoute` 가장 빠른 참조 경로입니다.
`shortest_route`	`CustomRoute` 최단 참조 경로입니다.
`fallback_info`	`FallbackInfo` 커스텀 경로의 대체 정보입니다.

FallbackInfo

ComputeCustomRoutes의 대체 정보를 캡슐화합니다. ComputeCustomRoutes는 두 가지 유형의 대체를 실행합니다.

고객이 요청한 routing_preference를 사용하여 경로를 계산할 수 없는 경우 다른 라우팅 모드로 대체됩니다. 이 경우 fallback_routing_mode 및 routing_mode_fallback_reason는 사용된 대체 라우팅 모드와 대체 이유를 전달하는 데 사용됩니다.
고객이 지정한 경로 목표에 대한 '최적의' 경로를 계산할 수 없는 경우 다른 목표로 대체될 수 있습니다. fallback_route_objective는 대체 경로 목표를 전달하는 데 사용됩니다.

필드

필드
`routing_mode`	`FallbackRoutingMode` 응답에 사용된 라우팅 모드입니다. 대체가 트리거된 경우 모드가 원래 클라이언트 요청에 설정된 라우팅 환경설정과 다를 수 있습니다.
`routing_mode_reason`	`FallbackReason` 원래 응답 대신 대체 응답이 사용된 이유입니다. 이 필드는 대체 모드가 트리거되고 대체 응답이 반환될 때만 채워집니다.
`route_objective`	`FallbackRouteObjective` 응답에 사용된 경로 목표입니다. 대체가 트리거된 경우 목표가 원래 클라이언트 요청에 제공된 경로 목표와 다를 수 있습니다.

routing_mode

FallbackRoutingMode

응답에 사용된 라우팅 모드입니다. 대체가 트리거된 경우 모드가 원래 클라이언트 요청에 설정된 라우팅 환경설정과 다를 수 있습니다.

routing_mode_reason

FallbackReason

원래 응답 대신 대체 응답이 사용된 이유입니다. 이 필드는 대체 모드가 트리거되고 대체 응답이 반환될 때만 채워집니다.

route_objective

FallbackRouteObjective

응답에 사용된 경로 목표입니다. 대체가 트리거된 경우 목표가 원래 클라이언트 요청에 제공된 경로 목표와 다를 수 있습니다.

FallbackRouteObjective

응답에 사용되는 RouteObjective입니다.

열거형
`FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED`	대체 경로 목표가 지정되지 않았습니다.
`FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA`	고객이 `RateCard`를 요청하고 include_tolls를 true로 설정했지만 Google에 경로에 대한 통행료 데이터가 없는 경우 API는 통행료를 고려하지 않고 `RateCard`로 대체합니다.

ComputeRouteMatrixRequest

ComputeRouteMatrix 요청 메시지

필드
`origins[]`	`RouteMatrixOrigin` 필수 항목입니다. 응답 매트릭스의 행을 결정하는 출처 배열입니다. 출처 및 대상의 카디널리티에는 여러 크기 제한사항이 적용됩니다. 요소 수 (출발지 × 목적지)는 어떤 경우에도 625개 이하여야 합니다. 라우팅_preference가 `TRAFFIC_AWARE_OPTIMAL`로 설정된 경우 요소 수 (출발지 × 목적지)는 100개 이하여야 합니다. `place_id`로 지정된 경유지 (출발지 + 목적지) 수는 50 이하여야 합니다.
`destinations[]`	`RouteMatrixDestination` 필수 항목입니다. 응답 매트릭스의 열을 결정하는 대상 배열입니다.
`travel_mode`	`RouteTravelMode` 선택사항입니다. 이동수단을 지정합니다.
`routing_preference`	`RoutingPreference` 선택사항입니다. 경로를 계산하는 방법을 지정합니다. 서버는 선택된 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정으로 인해 오류가 발생하거나 지연 시간이 너무 길어지면 오류가 반환됩니다. `travel_mode`가 `DRIVE` 또는 `TWO_WHEELER`인 경우에만 이 옵션을 지정할 수 있습니다. 그러지 않으면 요청이 실패합니다.
`departure_time`	`Timestamp` 선택사항입니다. 출발 시간입니다. 이 값을 설정하지 않으면 기본적으로 요청한 시간으로 설정됩니다. 이 값을 이미 발생한 시간으로 설정하면 요청이 실패합니다.

ComputeRoutesRequest

ComputeRoutes 요청 메시지

필드
`origin`	`Waypoint` 필수 항목입니다. 출발지 경유지입니다.
`destination`	`Waypoint` 필수 항목입니다. 도착 웨이포인트
`intermediates[]`	`Waypoint` 선택사항입니다. 경로(터미널 지점 제외)에 있는 경유지의 집합으로, 경유지에서 정차하거나 경유합니다. 최대 25개의 중간 경유지가 지원됩니다.
`travel_mode`	`RouteTravelMode` 선택사항입니다. 이동수단을 지정합니다.
`routing_preference`	`RoutingPreference` 선택사항입니다. 경로를 계산하는 방법을 지정합니다. 서버는 선택한 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정으로 인해 오류가 발생하거나 지연 시간이 너무 길면 오류가 반환됩니다. `travel_mode`이 `DRIVE` 또는 `TWO_WHEELER`인 경우에만 이 옵션을 지정할 수 있으며, 그렇지 않으면 요청이 실패합니다.
`polyline_quality`	`PolylineQuality` 선택사항입니다. 다중선의 품질에 대한 환경설정을 지정합니다.
`polyline_encoding`	`PolylineEncoding` 선택사항입니다. 다중선의 기본 인코딩을 지정합니다.
`departure_time`	`Timestamp` 선택사항입니다. 출발 시간입니다. 이 값을 설정하지 않으면 기본값은 요청한 시간입니다. 이 값을 이미 발생한 시간으로 설정하면 요청이 실패합니다.
`compute_alternative_routes`	`bool` 선택사항입니다. 경로 외에 대체 경로를 계산할지 지정합니다. 중간 경유지가 있는 요청에는 대체 경로가 반환되지 않습니다.
`route_modifiers`	`RouteModifiers` 선택사항입니다. 경로 계산 방식에 영향을 주는 일련의 조건입니다.
`language_code`	`string` 선택사항입니다. BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn') 자세한 내용은 유니코드 언어 ID를 참고하세요. 지원되는 언어 목록은 언어 지원을 참고하세요. 이 값을 제공하지 않으면 표시 언어는 경로 요청의 위치에서 추론됩니다.
`units`	`Units` 선택사항입니다. 표시 필드의 측정 단위를 지정합니다. 여기에는 `NavigationInstruction`의 `instruction` 필드가 포함됩니다. 경로, 구간, 걸음 수와 소요 시간에 사용되는 측정 단위는 이 값의 영향을 받지 않습니다. 이 값을 제공하지 않으면 요청 위치에서 표시 단위가 추론됩니다.
`optimize_waypoint_order`	`bool` optimizeWaypointOrder가 true로 설정되면, 경로의 전체 비용을 최소화하기 위해 지정된 중간 경유지의 순서를 다시 지정하려고 시도합니다. 중간 경유지 중 경유 경유지가 있는 경우 요청이 실패합니다. `ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index`를 사용하여 새로운 순서를 찾습니다. `X-Goog-FieldMask` 헤더에서 `routes.optimized_intermediate_waypoint_index`가 요청되지 않으면 요청이 실패합니다. `optimize_waypoint_order`가 false로 설정되면 `ComputeRoutesResponse.optimized_intermediate_waypoint_index`는 비어 있습니다.

ComputeRoutesResponse

응답 메시지를 ComputeRoutes합니다.

필드

필드
`routes[]`	`Route` `compute_alternatives_routes`를 지정하면 계산된 경로 배열(최대 3개)을 포함하고 지정하지 않으면 경로 1개만 포함합니다. 이 배열에 여러 항목이 포함된 경우 첫 번째 항목이 가장 권장되는 경로입니다. 배열이 비어 있으면 경로를 찾을 수 없음을 의미합니다.
`fallback_info`	`FallbackInfo` 서버가 모든 입력 환경설정으로 경로 결과를 계산할 수 없는 경우 다른 계산 방법을 사용하도록 대체할 수 있습니다. 대체 모드가 사용되면 이 필드에 대체 응답에 관한 자세한 정보가 포함됩니다. 그렇지 않으면 이 필드가 설정되지 않습니다.

routes[]

Route

compute_alternatives_routes를 지정하면 계산된 경로 배열(최대 3개)을 포함하고 지정하지 않으면 경로 1개만 포함합니다. 이 배열에 여러 항목이 포함된 경우 첫 번째 항목이 가장 권장되는 경로입니다. 배열이 비어 있으면 경로를 찾을 수 없음을 의미합니다.

fallback_info

FallbackInfo

서버가 모든 입력 환경설정으로 경로 결과를 계산할 수 없는 경우 다른 계산 방법을 사용하도록 대체할 수 있습니다. 대체 모드가 사용되면 이 필드에 대체 응답에 관한 자세한 정보가 포함됩니다. 그렇지 않으면 이 필드가 설정되지 않습니다.

CustomRoute

고객이 지정한 경로 목표를 기반으로 계산된 맞춤 경로를 캡슐화합니다. CustomRoute에는 경로와 경로 토큰이 포함되어 있으며, 이를 NavSDK에 전달하여 세부 경로 탐색을 위한 맞춤 경로를 재구성할 수 있습니다.

필드

필드
`route`	`Route` 입력 경로 목표에 대해 '최적'으로 간주되는 경로입니다.
`token`	`string` NavSDK에 전달할 수 있는 웹 보안 base64로 인코딩된 경로 토큰입니다. 이를 통해 NavSDK가 탐색 중에 경로를 재구성할 수 있으며, 경로를 변경하는 경우 `RoutesPreferred` `ComputeCustomRoutes`가 호출될 때 원래 의도를 준수합니다. 고객은 이 토큰을 불투명 blob으로 취급해야 합니다.

route

Route

입력 경로 목표에 대해 '최적'으로 간주되는 경로입니다.

token

string

NavSDK에 전달할 수 있는 웹 보안 base64로 인코딩된 경로 토큰입니다. 이를 통해 NavSDK가 탐색 중에 경로를 재구성할 수 있으며, 경로를 변경하는 경우 RoutesPreferred ComputeCustomRoutes가 호출될 때 원래 의도를 준수합니다. 고객은 이 토큰을 불투명 blob으로 취급해야 합니다.

FallbackInfo

대체 결과가 사용된 방법 및 이유와 관련된 정보입니다. 이 필드가 설정된 경우 서버가 선호하는 모드와 다른 라우팅 모드를 대체로 사용했다는 의미입니다.

필드

필드
`routing_mode`	`FallbackRoutingMode` 응답에 사용된 라우팅 모드입니다. 대체가 트리거된 경우 모드가 원래 클라이언트 요청에 설정된 라우팅 환경설정과 다를 수 있습니다.
`reason`	`FallbackReason` 원래 응답 대신 대체 응답이 사용된 이유입니다. 이 필드는 대체 모드가 트리거되고 대체 응답이 반환되는 경우에만 채워집니다.

routing_mode

FallbackRoutingMode

응답에 사용된 라우팅 모드입니다. 대체가 트리거된 경우 모드가 원래 클라이언트 요청에 설정된 라우팅 환경설정과 다를 수 있습니다.

reason

FallbackReason

원래 응답 대신 대체 응답이 사용된 이유입니다. 이 필드는 대체 모드가 트리거되고 대체 응답이 반환되는 경우에만 채워집니다.

FallbackReason

대체 응답을 사용하는 이유

열거형
`FALLBACK_REASON_UNSPECIFIED`	대체 이유가 지정되지 않았습니다.
`SERVER_ERROR`	선호하는 경로 모드로 경로를 계산하는 중에 서버 오류가 발생했지만 대체 모드로 계산된 결과를 반환할 수 있었습니다.
`LATENCY_EXCEEDED`	선호하는 라우팅 모드로 계산을 제때 완료할 수 없었지만 대체 모드로 계산된 결과를 반환할 수 있었습니다.

FallbackRoutingMode

반환된 대체 응답에 사용된 실제 라우팅 모드입니다.

열거형
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	사용되지 않음.
`FALLBACK_TRAFFIC_UNAWARE`	`TRAFFIC_UNAWARE` 라우팅 모드가 응답 계산에 사용되었음을 나타냅니다.
`FALLBACK_TRAFFIC_AWARE`	`TRAFFIC_AWARE` 라우팅 모드가 응답 계산에 사용되었음을 나타냅니다.

위치

위치(지리적 지점, 선택사항인 방향)를 캡슐화합니다.

필드

필드
`lat_lng`	`LatLng` 웨이포인트의 지리적 좌표입니다.
`heading`	`Int32Value` 트래픽 흐름 방향과 연결된 나침반 방향입니다. 이 값은 승하차에 사용할 도로의 측면을 지정합니다. 방향 값은 0~360까지 가능하며, 여기서 0은 북쪽 방향을, 90은 동쪽 방향을 지정합니다. 이 입력란은 `DRIVE` 및 `TWO_WHEELER` 이동 수단에만 사용할 수 있습니다.

lat_lng

LatLng

웨이포인트의 지리적 좌표입니다.

heading

Int32Value

트래픽 흐름 방향과 연결된 나침반 방향입니다. 이 값은 승하차에 사용할 도로의 측면을 지정합니다. 방향 값은 0~360까지 가능하며, 여기서 0은 북쪽 방향을, 90은 동쪽 방향을 지정합니다. 이 입력란은 DRIVE 및 TWO_WHEELER 이동 수단에만 사용할 수 있습니다.

Maneuver

현재 단계에서 실행할 탐색 작업 (예: 좌회전, 병합 또는 직선)을 지정하는 값의 집합입니다.

열거형
`MANEUVER_UNSPECIFIED`	사용되지 않음.
`TURN_SLIGHT_LEFT`	약간 왼쪽으로 돌립니다.
`TURN_SHARP_LEFT`	급격하게 왼쪽으로 회전합니다.
`UTURN_LEFT`	왼쪽으로 유턴하세요.
`TURN_LEFT`	왼쪽으로 돌아가세요.
`TURN_SLIGHT_RIGHT`	오른쪽으로 살짝 돌립니다.
`TURN_SHARP_RIGHT`	급격하게 오른쪽으로 회전합니다.
`UTURN_RIGHT`	우회전합니다.
`TURN_RIGHT`	우회전입니다.
`STRAIGHT`	똑바로 가세요.
`RAMP_LEFT`	왼쪽 램프를 이용합니다.
`RAMP_RIGHT`	오른쪽 램프를 타세요.
`MERGE`	교통 흐름에 합류합니다.
`FORK_LEFT`	왼쪽 포크를 타세요.
`FORK_RIGHT`	오른쪽 포크를 타세요.
`FERRY`	페리를 타세요.
`FERRY_TRAIN`	페리로 연결되는 기차를 타세요.
`ROUNDABOUT_LEFT`	원형 교차로에서 좌회전합니다.
`ROUNDABOUT_RIGHT`	로터리에서 우회전하세요.
`DEPART`	초기 작전
`NAME_CHANGE`	거리 이름 변경을 나타내는 데 사용됩니다.

NavigationInstruction

필드

maneuver

Maneuver

현재 단계의 내비게이션 안내를 캡슐화합니다 (예: 좌회전, 병합 또는 직선). 이 필드는 표시할 아이콘을 결정합니다.

instructions

string

이 단계를 탐색하는 방법에 관한 안내입니다.

폴리라인

인코딩된 다중선을 캡슐화합니다.

필드

필드
통합 필드 `polyline_type`. 폴리라인 유형을 캡슐화합니다. 기본값은 encoded_polyline입니다. `polyline_type`은 다음 중 하나여야 합니다.
`encoded_polyline`	`string` 다중선 인코딩 알고리즘을 사용하여 다중선의 문자열 인코딩입니다.
`geo_json_linestring`	`Struct` GeoJSON LineString 형식을 사용하여 다중선을 지정합니다.

통합 필드 polyline_type. 폴리라인 유형을 캡슐화합니다. 기본값은 encoded_polyline입니다. polyline_type은 다음 중 하나여야 합니다.

encoded_polyline

string

다중선 인코딩 알고리즘을 사용하여 다중선의 문자열 인코딩입니다.

geo_json_linestring

Struct

GeoJSON LineString 형식을 사용하여 다중선을 지정합니다.

PolylineEncoding

반환할 폴리라인의 기본 유형을 지정합니다.

열거형
`POLYLINE_ENCODING_UNSPECIFIED`	지정된 다중선 유형 환경설정이 없습니다. 기본값은 `ENCODED_POLYLINE`입니다.
`ENCODED_POLYLINE`	다중선 인코딩 알고리즘을 사용하여 인코딩된 다중선을 지정합니다.
`GEO_JSON_LINESTRING`	GeoJSON LineString 형식을 사용하여 다중선을 지정합니다.

PolylineQuality

다중선의 품질을 지정하는 값의 집합입니다.

열거형
`POLYLINE_QUALITY_UNSPECIFIED`	다중선 품질 환경설정이 지정되지 않았습니다. 기본값은 `OVERVIEW`입니다.
`HIGH_QUALITY`	응답 크기가 증가하는 대신 `OVERVIEW`보다 많은 포인트를 사용하여 구성된 고품질 다중선 선을 지정합니다. 더 높은 정밀도가 필요한 경우 이 값을 사용하세요.
`OVERVIEW`	소수의 점을 사용하여 구성된 개요 폴리라인을 지정합니다. 경로 개요를 표시할 때 이 값을 사용합니다. 이 옵션을 사용하면 `HIGH_QUALITY` 옵션을 사용할 때보다 요청 지연 시간이 짧습니다.

경로

시작, 종료 및 중간 경유지를 연결하는 일련의 연결된 도로 구간으로 구성된 경로를 캡슐화합니다.

필드
`legs[]`	`RouteLeg` 경로를 구성하는 구간 (경유지 사이의 경로 구간) 모음입니다. 각 구간은 `via`가 아닌 두 경유지 간의 이동에 해당합니다. 예를 들어, 중간 경유지가 없는 경로에는 구간이 하나만 있습니다. `via`이 아닌 중간 경유지 1개가 포함된 경로에는 두 개의 구간이 있습니다. `via` 중간 경유지가 1개인 경로에는 구간이 하나만 있습니다. 구간의 순서는 `origin`에서 `intermediates`, `destination`로 이어지는 경유지의 순서와 일치합니다.
`distance_meters`	`int32` 경로의 이동 거리(미터)입니다.
`duration`	`Duration` 경로를 탐색하는 데 필요한 시간입니다. `routing_preference`를 `TRAFFIC_UNAWARE`로 설정하면 이 값은 `static_duration`와 동일합니다. `routing_preference`를 `TRAFFIC_AWARE` 또는 `TRAFFIC_AWARE_OPTIMAL`로 설정하면 이 값은 트래픽 상태를 고려하여 계산됩니다.
`static_duration`	`Duration` 교통상황을 고려하지 않고 경로를 통해 이동하는 시간입니다.
`polyline`	`Polyline` 전체 경로 폴리라인입니다. 이 다중선은 모든 `legs`의 결합된 다중선입니다.
`description`	`string` 경로에 대한 설명입니다.
`warnings[]`	`string` 경로를 표시할 때 표시할 경고의 배열입니다.
`viewport`	`Viewport` 다중선의 표시 영역 경계 상자입니다.
`travel_advisory`	`RouteTravelAdvisory` 경로에 대한 추가 정보입니다.
`optimized_intermediate_waypoint_index[]`	`int32` `ComputeRoutesRequest.optimize_waypoint_order`가 true로 설정된 경우 이 필드에는 중간 경유지의 최적화된 순서가 포함됩니다. 그 외의 경우에는 이 필드가 비어 있습니다. 예를 들어 입력값이 출발지: LA, 중간 경로: 댈러스, 배너고, 피닉스, 도착지: 뉴욕이고 최적화된 중간 경로 순서가 피닉스, 댈러스, 배너고라고 가정해 보겠습니다. 그러면 이 필드에는 [2, 0, 1] 값이 포함됩니다. 첫 번째 중간 경유지에 대한 색인은 0으로 시작합니다.

RouteLeg

via가 아닌 경유지 사이의 세그먼트를 캡슐화합니다.

필드
`distance_meters`	`int32` 경로 구간의 이동 거리(미터)입니다.
`duration`	`Duration` 구간을 이동하는 데 걸리는 시간입니다. `route_preference`가 `TRAFFIC_UNAWARE`로 설정된 경우 이 값은 `static_duration`과 동일합니다. `route_preference` 값이 `TRAFFIC_AWARE` 또는 `TRAFFIC_AWARE_OPTIMAL`이면 이 값은 교통상황을 고려하여 계산됩니다.
`static_duration`	`Duration` 교통상황을 고려하지 않고 구간을 통과하는 데 걸리는 시간입니다.
`polyline`	`Polyline` 이 구간의 전체 폴리라인입니다. 여기에는 각 `step`의 폴리라인이 포함됩니다.
`start_location`	`Location` 이 구간의 시작 위치입니다. 이는 제공된 `origin`와 다를 수 있습니다. 예를 들어 제공된 `origin`가 도로 근처에 있지 않으면 도로의 한 지점입니다.
`end_location`	`Location` 이 구간의 도착 위치입니다. 이는 제공된 `destination`와 다를 수 있습니다. 예를 들어 제공된 `destination`가 도로 근처에 있지 않은 경우 도로의 한 지점입니다.
`steps[]`	`RouteLegStep` 이 구간 내의 세그먼트를 표시하는 단계의 배열입니다. 각 단계는 하나의 탐색 안내를 나타냅니다.
`travel_advisory`	`RouteLegTravelAdvisory` 경로 구간의 가능한 교통 구역 제한 등 사용자에게 알려야 하는 추가 정보를 캡슐화합니다.

RouteLegStep

RouteLeg의 세그먼트를 캡슐화합니다. 단계는 단일 탐색 안내에 해당합니다. 경로 구간은 단계로 구성됩니다.

필드
`distance_meters`	`int32` 이 단계의 이동 거리(미터)입니다. 경우에 따라 이 필드에 값이 없을 수도 있습니다.
`static_duration`	`Duration` 교통상황을 고려하지 않고 이 단계를 통과하는 이동 시간입니다. 경우에 따라 이 필드에 값이 없을 수도 있습니다.
`polyline`	`Polyline` 이 단계와 연결된 다중선입니다.
`start_location`	`Location` 이 단계의 시작 위치입니다.
`end_location`	`Location` 이 단계의 종료 위치입니다.
`navigation_instruction`	`NavigationInstruction` 내비게이션 안내
`travel_advisory`	`RouteLegStepTravelAdvisory` 구간 단계에서 발생할 수 있는 교통 구역 제한과 같이 사용자에게 알려야 하는 추가 정보를 캡슐화합니다.

RouteLegStepTravelAdvisory

구간 단계에서 발생할 수 있는 교통 구역 제한과 같이 사용자에게 알려야 하는 추가 정보를 캡슐화합니다.

필드

필드
`speed_reading_intervals[]`	`SpeedReadingInterval` 참고: 이 필드는 현재 채워져 있지 않습니다.

speed_reading_intervals[]

SpeedReadingInterval

참고: 이 필드는 현재 채워져 있지 않습니다.

RouteLegTravelAdvisory

경로 구간의 가능한 교통 구역 제한 등 사용자에게 알려야 하는 추가 정보를 캡슐화합니다.

필드

필드
`toll_info`	`TollInfo` 특정 `RouteLeg`의 통행료에 관한 정보를 캡슐화합니다. 이 필드는 `RouteLeg`에 통행료가 예상되는 경우에만 채워집니다. 이 필드는 설정되어 있지만 `estimated_price` 하위 필드가 채워지지 않은 경우 도로에 통행료가 포함될 것으로 예상되지만 예상 가격을 알 수 없습니다. 이 필드가 없으면 `RouteLeg`에 통행료가 없습니다.
`speed_reading_intervals[]`	`SpeedReadingInterval` 트래픽 밀도를 자세히 설명하는 속도 읽기 간격입니다. `TRAFFIC_AWARE` 및 `TRAFFIC_AWARE_OPTIMAL` 라우팅 환경설정의 경우 적용할 수 있습니다. 간격은 겹치지 않고 `RouteLeg`의 전체 다중선에 적용됩니다. 지정된 간격의 시작점은 이전 간격의 끝점과 동일합니다. 예: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

특정 RouteLeg의 통행료에 관한 정보를 캡슐화합니다. 이 필드는 RouteLeg에 통행료가 예상되는 경우에만 채워집니다. 이 필드는 설정되어 있지만 estimated_price 하위 필드가 채워지지 않은 경우 도로에 통행료가 포함될 것으로 예상되지만 예상 가격을 알 수 없습니다. 이 필드가 없으면 RouteLeg에 통행료가 없습니다.

speed_reading_intervals[]

SpeedReadingInterval

트래픽 밀도를 자세히 설명하는 속도 읽기 간격입니다. TRAFFIC_AWARE 및 TRAFFIC_AWARE_OPTIMAL 라우팅 환경설정의 경우 적용할 수 있습니다. 간격은 겹치지 않고 RouteLeg의 전체 다중선에 적용됩니다. 지정된 간격의 시작점은 이전 간격의 끝점과 동일합니다.

예:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

ComputeRouteMatrixRequest의 단일 대상

필드

필드
`waypoint`	`Waypoint` 필수 항목입니다. 목적지 경유지

waypoint

Waypoint

필수 항목입니다. 목적지 경유지

RouteMatrixElement

ComputeRouteMatrix API의 출발지/목적지 쌍에 대해 계산된 경로 정보를 캡슐화합니다. 이 프로토는 클라이언트로 스트리밍할 수 있습니다.

필드
`origin_index`	`int32` 요청에서 출처의 0 기반 색인입니다.
`destination_index`	`int32` 요청에서 대상의 0부터 시작하는 색인입니다.
`status`	`Status` 이 요소의 오류 상태 코드입니다.
`condition`	`RouteMatrixElementCondition` 경로를 찾았는지 여부를 나타냅니다. 상태와 관계없습니다.
`distance_meters`	`int32` 경로의 이동 거리(미터)입니다.
`duration`	`Duration` 경로를 탐색하는 데 필요한 시간입니다. `routing_preference`를 `TRAFFIC_UNAWARE`로 설정하면 이 값은 `static_duration`와 동일합니다. `routing_preference`를 `TRAFFIC_AWARE` 또는 `TRAFFIC_AWARE_OPTIMAL`로 설정하면 이 값은 트래픽 상태를 고려하여 계산됩니다.
`static_duration`	`Duration` 교통상황을 고려하지 않고 경로를 통과하는 데 걸리는 시간입니다.
`travel_advisory`	`RouteTravelAdvisory` 경로에 대한 추가 정보입니다. 예: 제한 정보 및 통행료 정보
`fallback_info`	`FallbackInfo` 서버가 이 특정 출발지/도착지 쌍에 대해 지정된 환경설정으로 경로를 계산할 수 없는 경우 다른 계산 모드를 사용하도록 대체할 수 있습니다. 대체 모드가 사용되면 이 필드에 대체 응답에 관한 자세한 정보가 포함됩니다. 그렇지 않으면 이 필드가 설정되지 않습니다.

RouteMatrixElementCondition

반환되는 경로의 조건입니다.

열거형
`ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED`	요소의 `status`가 좋지 않은 경우에만 사용됩니다.
`ROUTE_EXISTS`	경로를 찾았으며 요소에 상응하는 정보가 입력되었습니다.
`ROUTE_NOT_FOUND`	경로를 찾을 수 없습니다. `distance_meters` 또는 `duration`와 같이 경로 정보가 포함된 필드는 요소에 채워지지 않습니다.

RouteMatrixOrigin

ComputeRouteMatrixRequest의 단일 출처

필드

필드
`waypoint`	`Waypoint` 필수 항목입니다. 출발지 경유지
`route_modifiers`	`RouteModifiers` 선택사항입니다. 이 값을 출발지로 사용하는 모든 경로의 수정자

waypoint

Waypoint

필수 항목입니다. 출발지 경유지

route_modifiers

RouteModifiers

선택사항입니다. 이 값을 출발지로 사용하는 모든 경로의 수정자

RouteModifiers

경로를 계산할 때 충족해야 하는 선택적 조건 집합을 캡슐화합니다.

필드
`avoid_tolls`	`bool` true로 설정하면 합당한 경우 유료 도로를 제외하여 유료 도로가 포함되지 않은 경로를 우선 적용합니다. `DRIVE` 및 `TWO_WHEELER` 이동 모드에만 적용됩니다.
`avoid_highways`	`bool` true로 설정하면 합리적인 경우 고속도로를 피하고 고속도로가 포함되지 않은 경로를 우선합니다. `DRIVE` 및 `TWO_WHEELER` 이동 모드에만 적용됩니다.
`avoid_ferries`	`bool` true로 설정하면 합당한 경우 페리를 제외하여 페리가 포함되지 않은 경로를 우선 적용합니다. `DRIVE` 및 `TWO_WHEELER` 이동 모드에만 적용됩니다.
`avoid_indoor`	`bool` true로 설정하면 합리적인 경우 실내에서 탐색하지 않고 실내 탐색이 포함되지 않은 경로를 우선합니다. `WALK` 이동 모드에만 적용됩니다.
`vehicle_info`	`VehicleInfo` 차량 정보를 지정합니다.
`toll_passes[]`	`TollPass` 통행료에 대한 정보를 캡슐화합니다. 통행료가 제공되면 API는 통행료를 반환하려고 시도합니다. 톨 패스가 제공되지 않으면 API는 톨 패스를 알 수 없는 것으로 간주하고 현금 가격을 반환하려고 시도합니다. `DRIVE` 및 `TWO_WHEELER` 이동 모드에만 적용됩니다.

RouteObjective

ComputeCustomRoutes에 의해 최적화할 목표를 캡슐화합니다.

필드

필드
통합 필드 `objective`. 경로 목표입니다. `objective`은 다음 중 하나여야 합니다.
`rate_card`	`RateCard` RateCard 목표입니다.

통합 필드 objective. 경로 목표입니다. objective은 다음 중 하나여야 합니다.

rate_card

RateCard

RateCard 목표입니다.

RateCard

RateCard 경로 목표를 캡슐화합니다.

필드

필드
`cost_per_minute`	`MonetaryCost` 선택사항입니다. 분당 비용입니다.
`cost_per_km`	`MonetaryCost` 선택사항입니다. 킬로미터당 비용입니다.
`include_tolls`	`bool` 선택사항입니다. 전체 비용에 통행료 비용을 포함할지 여부입니다.

cost_per_minute

MonetaryCost

선택사항입니다. 분당 비용입니다.

cost_per_km

MonetaryCost

선택사항입니다. 킬로미터당 비용입니다.

include_tolls

bool

선택사항입니다. 전체 비용에 통행료 비용을 포함할지 여부입니다.

MonetaryCost

요율표에 사용되는 비용을 캡슐화합니다.

필드

필드
`value`	`double` 필수 항목입니다. 요청에서 추정된 현지 통화 단위의 비용 값입니다.

value

double

필수 항목입니다. 요청에서 추정된 현지 통화 단위의 비용 값입니다.

RouteTravelAdvisory

사용자에게 알려야 하는 추가 정보(예: 교통체증 제한 구간 제한 등)를 캡슐화합니다.

필드

필드
`toll_info`	`TollInfo` 경로의 유료 도로에 대한 정보를 캡슐화합니다. 이 필드는 경로에 통행료가 예상되는 경우에만 채워집니다. 이 필드는 설정되어 있지만 `estimated_price` 하위 필드가 채워지지 않은 경우 도로에 통행료가 포함될 것으로 예상되지만 예상 가격을 알 수 없습니다. 이 필드가 설정되지 않으면 경로에 통행료가 없는 것으로 간주됩니다.
`speed_reading_intervals[]`	`SpeedReadingInterval` 트래픽 밀도를 자세히 설명하는 속도 읽기 간격입니다. `TRAFFIC_AWARE` 및 `TRAFFIC_AWARE_OPTIMAL` 라우팅 환경설정의 경우 적용할 수 있습니다. 간격은 경로의 전체 폴리라인을 겹치지 않게 포함합니다. 지정된 간격의 시작 지점은 이전 간격의 끝 지점과 동일합니다. 예: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_info

TollInfo

경로의 유료 도로에 대한 정보를 캡슐화합니다. 이 필드는 경로에 통행료가 예상되는 경우에만 채워집니다. 이 필드는 설정되어 있지만 estimated_price 하위 필드가 채워지지 않은 경우 도로에 통행료가 포함될 것으로 예상되지만 예상 가격을 알 수 없습니다. 이 필드가 설정되지 않으면 경로에 통행료가 없는 것으로 간주됩니다.

speed_reading_intervals[]

SpeedReadingInterval

트래픽 밀도를 자세히 설명하는 속도 읽기 간격입니다. TRAFFIC_AWARE 및 TRAFFIC_AWARE_OPTIMAL 라우팅 환경설정의 경우 적용할 수 있습니다. 간격은 경로의 전체 폴리라인을 겹치지 않게 포함합니다. 지정된 간격의 시작 지점은 이전 간격의 끝 지점과 동일합니다.

예:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteTravelMode

이동 수단을 지정하는 데 사용되는 값 집합입니다.

열거형
`TRAVEL_MODE_UNSPECIFIED`	지정된 이동 수단이 없습니다. 기본값은 `DRIVE`입니다.
`DRIVE`	승용차로 이동합니다.
`BICYCLE`	자전거로 이동합니다.
`WALK`	도보 이동
`TWO_WHEELER`	오토바이 (예: 오토바이) 이는 사람이 직접 움직이는 이동 수단을 다루는 `BICYCLE` 이동 수단과 다릅니다.
`TAXI`	일부 지역에서는 지정된 택시 차선을 따라 이동할 수 있는 면허가 있는 택시를 이용합니다. TAXI 모드는 실험용 기능입니다. 고객이 택시 전용 차선 데이터를 사용할 수 없는 도시에서 택시 경로를 요청하면 자동차 경로가 반환됩니다.

RoutingPreference

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

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

SpeedReadingInterval

다중선 또는 경로의 연속 구간의 교통량 밀도 표시기입니다. 점 P_0, P_1, ... , P_N (0부터 시작하는 색인)이 있는 경로의 경우 SpeedReadingInterval는 간격을 정의하고 다음 카테고리를 사용하여 트래픽을 설명합니다.

필드

필드
`start_polyline_point_index`	`int32` 다중선에서 이 간격의 시작 색인입니다. JSON에서 색인이 0이면 필드가 채워지지 않은 것처럼 보입니다.
`end_polyline_point_index`	`int32` 다중선에서 이 간격의 종료 색인입니다. JSON에서 색인이 0이면 필드가 채워지지 않은 것으로 표시됩니다.
`speed`	`Speed` 이 간격 내의 트래픽 속도입니다.

start_polyline_point_index

int32

다중선에서 이 간격의 시작 색인입니다. JSON에서 색인이 0이면 필드가 채워지지 않은 것처럼 보입니다.

end_polyline_point_index

int32

다중선에서 이 간격의 종료 색인입니다. JSON에서 색인이 0이면 필드가 채워지지 않은 것으로 표시됩니다.

speed

Speed

이 간격 내의 트래픽 속도입니다.

속도

트래픽 데이터를 기반으로 한 다중선 속도 분류입니다.

열거형
`SPEED_UNSPECIFIED`	기본값 이 값은 사용되지 않습니다.
`NORMAL`	정상 속도이며 속도 저하가 감지되지 않습니다.
`SLOW`	속도가 느려졌지만 교통 체증이 발생하지 않았습니다.
`TRAFFIC_JAM`	교통체증이 감지되었습니다.

TollInfo

Route 또는 RouteLeg에 통행료 정보를 캡슐화합니다.

필드

필드
`estimated_price[]`	`Money` 해당 `Route` 또는 `RouteLeg`의 통행료 금액입니다. 이 목록에는 통행료소에서 청구할 것으로 예상되는 각 통화의 금액이 포함되어 있습니다. 일반적으로 이 목록에는 통화가 하나인 통행료가 있는 경로의 항목이 하나만 포함됩니다. 해외 여행의 경우 다양한 통화로 통행료를 반영하기 위해 이 목록에 여러 항목이 포함될 수 있습니다.

estimated_price[]

Money

해당 Route 또는 RouteLeg의 통행료 금액입니다. 이 목록에는 통행료소에서 청구할 것으로 예상되는 각 통화의 금액이 포함되어 있습니다. 일반적으로 이 목록에는 통화가 하나인 통행료가 있는 경로의 항목이 하나만 포함됩니다. 해외 여행의 경우 다양한 통화로 통행료를 반영하기 위해 이 목록에 여러 항목이 포함될 수 있습니다.

TollPass

Google에서 지원하는 전 세계 유료 도로 목록입니다.

열거형
`TOLL_PASS_UNSPECIFIED`	사용되지 않음. 이 값을 사용하면 요청이 실패합니다.
`AU_ETOLL_TAG`	시드니의 여러 통행료 패스 제공업체 중 하나입니다. https://www.myetoll.com.au
`AU_EWAY_TAG`	시드니 통행료 서비스 제공업체 중 하나입니다. https://www.tollpay.com.au/
`AU_LINKT`	오스트레일리아 전역 톨 패스입니다. 자세한 내용은 https://www.linkt.com.au/를 참고하세요.
`AR_TELEPASE`	아르헨티나 톨 패스 자세한 내용은 https://telepase.com.ar을 참조하세요.
`BR_AUTO_EXPRESO`	브라질 통행료입니다. https://www.autoexpreso.com에서 자세한 내용을 확인하세요.
`BR_CONECTCAR`	브라질 통행료입니다. 자세한 내용은 https://conectcar.com을 참고하세요.
`BR_MOVE_MAIS`	브라질 톨 패스 자세한 내용은 https://movemais.com에서 확인하세요.
`BR_PASSA_RAPIDO`	브라질 통행료입니다. 자세한 내용은 https://pasorapido.gob.do/를 참고하세요.
`BR_SEM_PARAR`	브라질 톨 패스 자세한 내용은 https://www.semparar.com.br를 참고하세요.
`BR_TAGGY`	브라질 통행료입니다. 추가 세부정보는 https://taggy.com.br에서 확인하세요.
`BR_VELOE`	브라질 통행료입니다. 자세한 내용은 https://veloe.com.br/site/onde-usar를 참고하세요.
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	캐나다에서 미국으로 국경을 넘는 경우
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	캐나다에서 미국으로 국경을 넘는 경우
`CA_US_BLUE_WATER_EDGE_PASS`	캐나다 온타리오에서 미국 미시간으로 국경을 넘는 경우
`CA_US_CONNEXION`	캐나다 온타리오에서 미국 미시간으로 국경을 넘는 경우
`CA_US_NEXUS_CARD`	캐나다에서 미국 국경 통과
`ID_E_TOLL`	인도네시아 여러 은행에서 제공하는 전자 카드로 통행료를 지불하는 데 사용됩니다. 은행을 통한 모든 전자 카드에는 동일한 요금이 청구되므로 enum 값은 하나만 있으면 됩니다. 예: Mandiri 은행 https://www.bankmandiri.co.id/e-money BCA https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking/tapcash
`IN_FASTAG`	India.
`IN_LOCAL_HP_PLATE_EXEMPT`	인도, HP 주 번호판 예외
`JP_ETC`	Japan ETC. 통행료를 징수하는 전자 무선 시스템입니다. https://www.go-etc.jp/
`JP_ETC2`	일본 ETC2.0 새로운 버전의 ETC에 추가 할인이 적용되어 차량의 기기와 도로의 안테나 간 양방향 통신이 제공됩니다. https://www.go-etc.jp/etc2/index.html
`MX_IAVE`	멕시코 https://iave.capufe.gob.mx/#/
`MX_PASE`	멕시코 https://www.pase.com.mx
`MX_QUICKPASS`	멕시코 https://operadoravial.com/quick-pass/
`MX_SISTEMA_TELEPEAJE_CHIHUAHUA`	멕시코 http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
`MX_TAG_IAVE`	멕시코
`MX_TAG_TELEVIA`	멕시코 통행료 회사 멕시코시티에서 사업을 운영하는 많은 기업 중 하나입니다. 자세한 내용은 https://www.televia.com.mx를 참고하세요.
`MX_TELEVIA`	멕시코 통행료 회사 멕시코시티에 있는 여러 방송사 중 하나입니다. https://www.televia.com.mx
`MX_VIAPASS`	멕시코 톨 패스 자세한 내용은 https://www.viapass.com.mx/viapass/web_home.aspx에서 참조하세요.
`US_AL_FREEDOM_PASS`	미국 앨라배마
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	AK, USA입니다.
`US_CA_FASTRAK`	미국, 캐나다
`US_CA_FASTRAK_CAV_STICKER`	운전자에게 DMV에서 발급한 클린 에어 차량(CAV) 스티커 외에도 FasTrak 패스가 있음을 나타냅니다. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	미국 콜로라도주입니다.
`US_CO_GO_PASS`	CO, USA.
`US_DE_EZPASSDE`	독일, 미국.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	플로리다주입니다.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	플로리다주입니다.
`US_FL_EPASS`	플로리다주입니다.
`US_FL_GIBA_TOLL_PASS`	플로리다주입니다.
`US_FL_LEEWAY`	플로리다주입니다.
`US_FL_SUNPASS`	플로리다주입니다.
`US_FL_SUNPASS_PRO`	FL, 미국
`US_IL_EZPASSIL`	IL, 미국
`US_IL_IPASS`	IL, 미국
`US_IN_EZPASSIN`	인디애나주, 미국
`US_KS_BESTPASS_HORIZON`	KS, 미국
`US_KS_KTAG`	KS, 미국
`US_KS_NATIONALPASS`	KS, 미국
`US_KS_PREPASS_ELITEPASS`	KS, 미국.
`US_KY_RIVERLINK`	KY, USA
`US_LA_GEAUXPASS`	미국 로스앤젤레스
`US_LA_TOLL_TAG`	미국 로스앤젤레스
`US_MA_EZPASSMA`	MA, USA.
`US_MD_EZPASSMD`	의학 박사, 미국.
`US_ME_EZPASSME`	미국 중동
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	미국 미시간주.
`US_MI_BCPASS`	미국 미시간주.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	미국 미시간주.
`US_MI_IQ_PROX_CARD`	MI, 미국 이 패스 유형은 더 이상 존재하지 않으므로 지원 중단되었습니다. 이 항목은 지원 중단되었습니다.
`US_MI_IQ_TAG`	미국 미시간주.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	미국 미시간주.
`US_MI_NEXPRESS_TOLL`	MI, 미국
`US_MN_EZPASSMN`	MN, 미국
`US_NC_EZPASSNC`	미국 노스캐롤라이나
`US_NC_PEACH_PASS`	미국 노스캐롤라이나
`US_NC_QUICK_PASS`	미국 노스캐롤라이나주
`US_NH_EZPASSNH`	NH, 미국
`US_NJ_DOWNBEACH_EXPRESS_PASS`	뉴저지주입니다.
`US_NJ_EZPASSNJ`	미국 뉴저지
`US_NY_EXPRESSPASS`	뉴욕, 미국
`US_NY_EZPASSNY`	뉴욕, 미국
`US_OH_EZPASSOH`	오, 미국.
`US_PA_EZPASSPA`	PA, USA입니다.
`US_RI_EZPASSRI`	RI, 미국
`US_SC_PALPASS`	SC, USA
`US_TX_AVI_TAG`	텍사스, 미국
`US_TX_BANCPASS`	텍사스, 미국
`US_TX_DEL_RIO_PASS`	텍사스, 미국
`US_TX_EFAST_PASS`	텍사스, 미국
`US_TX_EAGLE_PASS_EXPRESS_CARD`	텍사스, 미국
`US_TX_EPTOLL`	텍사스, 미국
`US_TX_EZ_CROSS`	텍사스, 미국
`US_TX_EZTAG`	텍사스, 미국
`US_TX_FUEGO_TAG`	텍사스, 미국
`US_TX_LAREDO_TRADE_TAG`	텍사스, 미국
`US_TX_PLUSPASS`	텍사스, 미국
`US_TX_TOLLTAG`	텍사스, 미국
`US_TX_TXTAG`	텍사스, 미국
`US_TX_XPRESS_CARD`	텍사스, 미국
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	, 미국
`US_VA_EZPASSVA`	버지니아주입니다.
`US_WA_BREEZEBY`	워싱턴 D.C.로 이동합니다.
`US_WA_GOOD_TO_GO`	WA, 미국
`US_WV_EZPASSWV`	WV, USA.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	WV, USA.
`US_WV_MOV_PASS`	WV, 미국
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	미국 서던웨스트 버지니아

단위

디스플레이에 사용되는 측정 단위를 지정하는 값 집합입니다.

열거형
`UNITS_UNSPECIFIED`	측정 단위가 지정되지 않았습니다. 기본값은 요청에서 추론한 측정 단위입니다.
`METRIC`	미터법 측정 단위
`IMPERIAL`	야드파운드법 (영어) 측정 단위입니다.

VehicleEmissionType

차량의 배출 유형을 설명하는 값 집합입니다. 드라이브 이동 모드에만 적용됩니다.

열거형
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	지정된 배출량 유형이 없습니다. 기본값은 GASOLINE입니다.
`GASOLINE`	휘발유/휘발유 차량
`ELECTRIC`	전기자동차입니다.
`HYBRID`	하이브리드 연료 (예: 휘발유 + 전기) 자동차

VehicleInfo

차량 배출 유형과 같은 차량 정보를 캡슐화합니다.

필드

필드
`emission_type`	`VehicleEmissionType` 차량의 배출 유형을 설명합니다. `DRIVE` `RouteTravelMode`에만 적용됩니다.

emission_type

VehicleEmissionType

차량의 배출 유형을 설명합니다. DRIVE RouteTravelMode에만 적용됩니다.

경유지

경유지를 캡슐화합니다. 경유지는 경로의 시작과 끝을 모두 표시하고, 경로상의 중간 정류장을 포함합니다.

필드
`via`	`bool` 이 웨이포인트를 중지 지점이 아닌 주요 기록으로 표시합니다. 요청에 포함된 각 비경유 경유지의 경우 응답은 `legs` 배열에 항목을 추가하여 해당 이동 구간의 중간 기착 세부정보를 제공합니다. 경로가 경유지 없이 이 경유지를 통과하기를 원하는 경우 이 값을 true로 설정합니다. 경유지 경유지는 항목이 `legs` 배열에 추가되지는 않지만 경로를 경유지를 통해 라우팅합니다. 중간 지점인 경유지에만 이 값을 설정할 수 있습니다. 터미널 경유지에 이 필드를 설정하면 요청이 실패합니다. `ComputeRoutesRequest.optimize_waypoint_order`가 true로 설정되면 이 필드를 true로 설정할 수 없습니다. 그렇지 않으면 요청이 실패합니다.
`vehicle_stopover`	`bool` 차량이 정차하여 승하차할 수 있는 위치에 있는 중간 지점임을 나타냅니다. 이 값을 설정하면 계산된 경로에 승하차에 적합하지 않은 도로의 `via`가 아닌 중간 지점이 포함되지 않습니다. 이 옵션은 `DRIVE` 및 `TWO_WHEELER` 이동 모드에서만 작동하며 `location_type`이 `location`인 경우에만 작동합니다.
`side_of_road`	`bool` 이 경유지의 위치는 차량이 도로의 특정 쪽에 정차하기를 원한다는 것을 나타냅니다. 이 값을 설정하면 경로가 해당 위치를 통과하여 차량이 위치가 도로의 중심에서 편중된 도로 쪽에 정차할 수 있습니다. 이 옵션은 'DRIVE' 및 'TWO_WHEELER' 이동 모드에서만 작동합니다.
통합 필드 `location_type`. 위치를 나타내는 다양한 방법 `location_type`은 다음 중 하나여야 합니다.
`location`	`Location` 방향(선택사항)을 포함하여 지리적 좌표를 사용하여 지정된 지점입니다.
`place_id`	`string` 경유지와 연결된 관심 장소 장소 ID입니다.