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입니다.

Package google.maps.routes.v1 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

색인

RoutesPreferred

ComputeCustomRoutesRequest

ComputeCustomRoutesResponse

FallbackInfo

FallbackRouteObjective

ComputeRouteMatrixRequest

ComputeRoutesRequest

ComputeRoutesResponse

CustomRoute

FallbackInfo

FallbackReason

FallbackRoutingMode

위치

Maneuver

NavigationInstruction

폴리라인

PolylineEncoding

PolylineQuality

경로

RouteLeg

RouteLegStep

RouteLegStepTravelAdvisory

RouteLegTravelAdvisory

RouteMatrixDestination

RouteMatrixElement

RouteMatrixElementCondition

RouteMatrixOrigin

RouteModifiers

RouteObjective

RateCard

MonetaryCost

RouteTravelAdvisory

RouteTravelMode

RoutingPreference

SpeedReadingInterval

속도

TollInfo

TollPass

단위

VehicleEmissionType

VehicleInfo

경유지

Package google.maps.routes.v1