Package google.maps.routing.v2

색인

• Routes(인터페이스)
• ComputeRouteMatrixRequest(메시지)
• ComputeRouteMatrixRequest.ExtraComputation(열거형)
• ComputeRoutesRequest(메시지)
• ComputeRoutesRequest.ExtraComputation(열거형)
• ComputeRoutesRequest.ReferenceRoute(열거형)
• ComputeRoutesResponse(메시지)
• FallbackInfo(메시지)
• FallbackReason(열거형)
• FallbackRoutingMode(열거형)
• GeocodedWaypoint(메시지)
• GeocodingResults(메시지)
• Location(메시지)
• Maneuver(열거형)
• NavigationInstruction(메시지)
• Polyline(메시지)
• PolylineEncoding(열거형)
• PolylineQuality(열거형)
• Route(메시지)
• RouteLabel(열거형)
• RouteLeg(메시지)
• RouteLegStep(메시지)
• RouteLegStepTravelAdvisory(메시지)
• RouteLegTravelAdvisory(메시지)
• RouteMatrixDestination(메시지)
• RouteMatrixElement(메시지)
• RouteMatrixElementCondition(열거형)
• RouteMatrixOrigin(메시지)
• RouteModifiers(메시지)
• RouteTravelAdvisory(메시지)
• RouteTravelMode(열거형)
• RoutingPreference(열거형)
• SpeedReadingInterval(메시지)
• SpeedReadingInterval.Speed(열거형)
• TollInfo(메시지)
• TollPass(열거형)
• Units(열거형)
• VehicleEmissionType(열거형)
• VehicleInfo(메시지)
• Waypoint(메시지)

경로

Routes API입니다.

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를 포함해야 합니다. 그러지 않으면 모든 메시지가 정상인 것처럼 보이기 때문입니다. 다음과 같은 이유로 와일드 카드 (*) 응답 필드 마스크는 사용하지 않는 것이 좋습니다. 필요한 필드만 선택하면 서버에서 계산 주기를 단축하여 지연 시간을 줄여 결과를 반환할 수 있습니다. 프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능을 보장할 수 있습니다. 향후 응답 필드가 더 추가될 수 있으며 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 새로 추가한 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다. 필요한 필드만 선택하면 응답 크기가 작아지므로 네트워크 처리량이 증가합니다.

ComputeRoute

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 다음과 같은 이유로 와일드 카드 (*) 응답 필드 마스크를 사용하거나 최상위 수준 (routes)에서 필드 마스크를 지정하지 않는 것이 좋습니다. 필요한 필드만 선택하면 서버에서 계산 주기를 단축하여 지연 시간을 줄여 결과를 반환할 수 있습니다. 프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능을 보장할 수 있습니다. 향후 응답 필드가 더 추가될 수 있으며 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 새로 추가한 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다. 필요한 필드만 선택하면 응답 크기가 작아지므로 네트워크 처리량이 증가합니다.

ComputeRouteMatrixRequest

ComputeRouteMatrix 요청 메시지

필드
origins[]	RouteMatrixOrigin 필수 항목입니다. 응답 매트릭스의 행을 결정하는 출처 배열입니다. 출처 및 대상의 카디널리티에는 몇 가지 크기 제한이 적용됩니다. 요소 (출발지 x 목적지)의 개수는 어떠한 경우에도 625 이하여야 합니다. 라우팅_ 환경설정이 TRAFFIC_AWARE_OPTIMAL로 설정된 경우 요소 수 (출처 × 목적지)는 100 이하여야 합니다. place_id으로 지정된 경유지 (출발지 + 목적지) 수는 50 이하여야 합니다.
destinations[]	RouteMatrixDestination 필수 항목입니다. 응답 매트릭스의 열을 결정하는 대상의 배열입니다.
travel_mode	RouteTravelMode 선택사항. 이동수단을 지정합니다.
routing_preference	RoutingPreference 선택사항. 경로를 계산하는 방법을 지정합니다. 서버는 선택한 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정으로 인해 오류 또는 추가 긴 지연 시간이 발생하면 오류가 반환됩니다. travel_mode가 DRIVE 또는 TWO_WHEELER인 경우에만 이 옵션을 지정할 수 있습니다. 그렇지 않으면 요청이 실패합니다.
departure_time	Timestamp 선택사항. 출발 시간입니다. 이 값을 설정하지 않으면 기본값은 요청한 시간입니다. 이 값을 이미 발생한 시간으로 설정하면 요청이 실패합니다.
language_code	string 선택사항. BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn')입니다. 자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참조하세요. 지원되는 언어 목록은 언어 지원을 참고하세요. 이 값을 지정하지 않으면 첫 번째 출발지의 위치에서 표시 언어가 추론됩니다.
region_code	string 선택사항. ccTLD ('최상위 도메인') 두 문자 값으로 지정되는 지역 코드입니다. 자세한 내용은 https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains를 참고하세요.
extra_computations[]	ExtraComputation 선택사항. 요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다. 참고: 이러한 추가 계산은 응답에서 추가 필드를 반환할 수 있습니다. 이러한 추가 필드는 응답에 반환될 필드 마스크에도 지정해야 합니다.

추가 계산

요청을 완료하는 동안 실행할 추가 계산.

열거형
EXTRA_COMPUTATION_UNSPECIFIED	사용되지 않음. 이 값이 포함된 요청은 실패합니다.
TOLLS	매트릭스 요소의 통행료 정보입니다.

ComputeRoutes 요청

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')입니다. 자세한 내용은 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier를 참조하세요. 지원되는 언어 목록은 언어 지원을 참고하세요. 이 값을 제공하지 않으면 경로 요청의 위치에서 표시 언어가 추론됩니다.
region_code	string 선택사항. ccTLD ('최상위 도메인') 두 문자 값으로 지정되는 지역 코드입니다. 자세한 내용은 https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains를 참고하세요.
units	Units 선택사항. 표시 필드의 측정 단위를 지정합니다. 여기에는 NavigationInstruction의 instruction 필드가 포함됩니다. 경로, 구간, 걸음 거리, 지속 시간에 사용되는 측정 단위는 이 값의 영향을 받지 않습니다. 이 값을 제공하지 않으면 표시 위치가 요청 위치에서 유추됩니다.
requested_reference_routes[]	ReferenceRoute 선택사항. 기본 경로 외에 요청의 일부로 계산할 참조 경로를 지정합니다. 참조 경로는 기본 경로와 다른 경로 계산 목표가 있는 경로입니다. 예를 들어 FUEL_EFFICIENT 참조 경로 계산은 최적의 연비 최적 경로를 생성하는 다양한 매개변수를 고려합니다.
extra_computations[]	ExtraComputation 선택사항. 요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다. 참고: 이러한 추가 계산은 응답에서 추가 필드를 반환할 수 있습니다. 이러한 추가 필드는 응답에 반환될 필드 마스크에도 지정해야 합니다.

추가 계산

요청을 완료하는 동안 실행할 추가 계산.

열거형
EXTRA_COMPUTATION_UNSPECIFIED	사용되지 않음. 이 값이 포함된 요청은 실패합니다.
TOLLS	노선의 통행료 정보입니다.
FUEL_CONSUMPTION	경로의 예상 연료 소비량
TRAFFIC_ON_POLYLINE	경로에 대한 다중선을 트래피킹합니다.

참조 경로

ComputeRoutesRequest에서 지원되는 참조 경로입니다.

열거형
REFERENCE_ROUTE_UNSPECIFIED	사용되지 않음. 이 값이 포함된 요청은 실패합니다.
FUEL_EFFICIENT	연비 최적 경로 이 값으로 라벨이 지정된 경로는 연료 소비량과 같은 매개변수에 최적화된 것으로 결정됩니다.

ComputeRoutesResponse

ComputeRoute 응답 메시지입니다.

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

대체 정보

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

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

대체 이유

대체 응답을 사용하는 이유입니다.

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

대체 라우팅 모드

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

열거형
FALLBACK_ROUTING_MODE_UNSPECIFIED	사용되지 않음.
FALLBACK_TRAFFIC_UNAWARE	응답을 계산하는 데 사용된 'TRAFFIC_UNAWARE' 라우팅 모드를 나타냅니다.
FALLBACK_TRAFFIC_AWARE	응답을 계산하는 데 사용된 'TRAFFIC_AWARE' 라우팅 모드를 나타냅니다.

위치정보 코딩된 Waypoint

경유지로 사용되는 위치에 대한 세부정보입니다. 주소 경유지에만 채워집니다. 주소를 지오코딩한 주소를 확인하기 위한 지오코딩 결과에 대한 세부정보를 포함합니다.

필드
geocoder_status	Status 지오코딩 작업의 결과인 상태 코드를 나타냅니다.
type[]	string 0개 이상의 유형 태그 형식으로 된 결과의 유형입니다. 지원되는 유형: https://developers.google.com/maps/documentation/Geocoding/requests-Geocoding#Types
partial_match	bool 지오코더가 원래 요청한 주소와 정확하게 일치하지 않지만 요청된 주소의 일부분만 일치함을 나타냅니다. 원래 요청을 검사하여 맞춤법 오류 및/또는 불완전한 주소를 찾아낼 수 있습니다.
place_id	string 이 검색결과의 장소 ID입니다.
intermediate_waypoint_request_index	int32 요청에 있는 중간 경유지의 색인입니다. 해당 경유지가 중간 경유지인 경우에만 채워집니다.

지오코딩결과

출발지, 목적지 및 중간 경유지의 GeocodedWaypoints를 포함합니다. 주소 경유지에만 채워집니다.

필드
origin	GeocodedWaypoint 출발지 지오코딩된 경유지.
destination	GeocodedWaypoint 목적지의 지오코딩된 경유지입니다.
intermediates[]	GeocodedWaypoint 요청에서 지정한 순서대로 경유지의 0 기반 위치에 해당하는 색인 필드를 포함하는 중간 지오코딩된 경유지 목록입니다.

위치

위치 (지리적 지점 및 선택적 제목)를 캡슐화합니다.

필드
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	로터리에서 우회전하세요.

내비게이션 안내

RouteLegStep의 탐색 안내를 캡슐화합니다.

필드
maneuver	Maneuver 현재 단계의 탐색 안내를 캡슐화합니다 (예: 왼쪽, 병합, 직선 등). 이 필드는 표시할 아이콘을 결정합니다.
instructions	string 이 단계를 탐색하는 방법

폴리라인

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

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

다중선 인코딩

반환될 기본 다중선 유형을 지정합니다.

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

다중선 품질

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

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

경로

출발지, 목적지, 중간 경유지를 연결하는 일련의 연결된 도로 구간으로 구성된 경로를 캡슐화합니다.

필드
route_labels[]	RouteLabel 경로의 특정 속성을 식별하는 데 유용한 Route 라벨입니다.
legs[]	RouteLeg 경로를 구성하는 구간 (경유지 사이의 경로 세그먼트) 모음입니다. 각 구간은 via이 아닌 두 경유지 간 이동에 해당합니다. 예를 들어 중간 경유지가 없는 경로에는 구간이 하나만 있습니다. via이 아닌 중간 경유지 1개가 포함된 경로에는 구간 2개가 있습니다. via 중간 경유지 1개가 포함된 경로에는 구간 1개가 있습니다. 구간의 순서는 origin에서 intermediates까지, destination에서 Waypoint의 순서와 일치합니다.
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 경로에 대한 추가 정보입니다.
route_token	string Navigation SDK에 전달할 수 있는 웹 안전 base64로 인코딩된 경로 토큰입니다. 이를 통해 탐색 중에 Navigation SDK가 경로를 재구성할 수 있으며 경로 재설정 시 Routes ComputeRoutes가 호출될 때 원래 의도를 준수합니다. 고객은 이 토큰을 불투명 blob으로 취급해야 합니다. 참고: Route.route_token는 ComputeRoutesRequest.routing_preference를 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정한 요청에만 사용할 수 있습니다. 경유지가 있는 요청에는 Route.route_token도 지원되지 않습니다.

경로 라벨

경로의 특정 속성을 식별하는 데 유용한 Route 라벨입니다.

열거형
ROUTE_LABEL_UNSPECIFIED	기본값 - 사용되지 않습니다.
DEFAULT_ROUTE	경로 계산에 대해 반환된 기본 '최적' 경로입니다.
DEFAULT_ROUTE_ALTERNATE	기본 '최적' 경로 대안 이러한 경로는 ComputeRoutesRequest.compute_alternative_routes가 지정되면 반환됩니다.
FUEL_EFFICIENT	연비 최적 경로 이 값으로 라벨이 지정된 경로는 연료 소비와 같은 절전 매개변수에 최적화되어 있습니다.

루트레그

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 사용자에게 알려야 하는 추가 정보(예: 가능한 구간 교통 제한 등)를 캡슐화합니다.

경로 구간

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

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

경로 구간 이동 여행 주의보

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

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

경로 구간 여행 권고

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

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

경로 행렬 대상

ComputeRouteMatrixRequest의 단일 대상

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

경로 행렬 요소

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

필드
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 서버가 특정 출발지/목적지 쌍에 대해 지정된 환경설정으로 경로를 계산할 수 없는 경우 다른 계산 모드를 사용하는 경우가 있습니다. 대체 모드를 사용하면 이 필드에 대체 응답에 관한 자세한 정보가 포함됩니다. 그렇지 않으면 필드가 설정되지 않습니다.
origin_index	int32 요청에서 출처의 0부터 시작하는 색인입니다.
destination_index	int32 요청에서 대상의 0부터 시작하는 색인입니다.

경로 행렬 요소 조건

반환되는 경로의 상태입니다.

열거형
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED	요소의 status가 적절하지 않은 경우에만 사용됩니다.
ROUTE_EXISTS	경로를 찾았으며 요소에 상응하는 정보를 작성했습니다.
ROUTE_NOT_FOUND	경로를 찾을 수 없습니다. 경로 정보가 포함된 필드(예: distance_meters 또는 duration)는 요소에 작성되지 않습니다.

경로 행렬 출처

ComputeRouteMatrixRequest의 단일 출처

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

RouteModifier

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

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

경로여행 권고

가능한 영역 제한 등 사용자에게 알려야 하는 추가 정보를 캡슐화합니다.

필드
toll_info	TollInfo 경로의 통행료 정보를 캡슐화합니다. 이 필드는 경로에 유료 도로가 있는 것으로 예상되는 경우에만 채워집니다. 이 필드는 설정되어 있지만 predict_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).
fuel_consumption_microliters	int64 예상 연료 소비량(마이크로리터)

경로 여행 모드

이동 수단을 지정하는 데 사용되는 값 집합입니다. 참고: WALK, BICYCLE, TWO_WHEELER 경로는 베타 버전이므로 명확한 인도, 보행 경로 또는 자전거 경로가 누락될 수 있습니다. 앱에 표시하는 모든 도보, 자전거 및 오토바이 경로에 대해 이 경고를 사용자에게 표시해야 합니다.

열거형
TRAVEL_MODE_UNSPECIFIED	이동수단이 지정되지 않았습니다. 기본값은 DRIVE입니다.
DRIVE	승용차로 이동합니다.
BICYCLE	자전거로 여행합니다.
WALK	걸어서 여행하세요.
TWO_WHEELER	오토바이. 예: 오토바이 이는 사람 지원 모드를 다루는 BICYCLE 이동 모드와 다릅니다.

라우팅 환경설정

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

열거형
ROUTING_PREFERENCE_UNSPECIFIED	지정된 라우팅 환경설정이 없습니다. 기본값은 TRAFFIC_UNAWARE입니다.
TRAFFIC_UNAWARE	실시간 교통상황을 고려하지 않고 경로를 계산합니다. 교통 상황이 중요하지 않거나 적용할 수 없는 경우 적합합니다. 이 값을 사용하면 가장 짧은 지연 시간이 생성됩니다. 참고: RouteTravelMode 드라이브와 TWO_WHEELER의 경로 및 기간은 도로망 및 평균 시간과 무관한 교통상황을 기준으로 선택됩니다. 지정된 요청의 결과는 도로망의 변화, 평균 교통상황의 업데이트 및 분산된 서비스 특성으로 인해 시간이 지남에 따라 달라질 수 있습니다. 거의 동일한 경로 간에도 경우에 따라 결과가 달라질 수도 있습니다.
TRAFFIC_AWARE	실시간 교통 상황을 고려한 경로를 계산합니다. TRAFFIC_AWARE_OPTIMAL와 달리 일부 최적화는 지연 시간을 크게 줄이기 위해 적용됩니다.
TRAFFIC_AWARE_OPTIMAL	대부분의 성능 최적화를 적용하지 않고 실시간 교통 상황을 고려한 경로를 계산합니다. 이 값을 사용하면 지연 시간이 가장 길어집니다.

속도 읽기 간격

다중선이나 경로의 인접 세그먼트에 있는 교통량 표시자입니다. 지점 P_0, P_1, ... , P_N (0부터 시작하는 색인)이 있는 경로가 있으면 SpeedReadingInterval이 간격을 정의하고 다음 카테고리를 사용하여 트래픽을 설명합니다.

필드
start_polyline_point_index	int32 다중선에서 이 간격의 시작 색인입니다.
end_polyline_point_index	int32 다중선에서 이 간격의 끝 색인입니다.
통합 필드 speed_type는 speed_type는 다음 중 하나여야 합니다.
speed	Speed 이 간격의 교통정보입니다.

속도

교통정보를 기반으로 다중선 속도를 분류한 것입니다.

열거형
SPEED_UNSPECIFIED	기본값 이 값은 사용되지 않습니다.
NORMAL	보통 속도, 감속은 감지되지 않습니다.
SLOW	감속이 감지되었지만 교통 체증이 없습니다.
TRAFFIC_JAM	교통체증이 감지되었습니다.

통행료

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

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

톨 패스

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	인도네시아 통행료를 결제하는 데 사용하는 여러 은행에서 제공하는 전자 카드입니다. 은행을 통한 모든 e-카드는 동일하므로 enum 값 하나만 필요합니다. 예: 은행만디어 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 주정부 면세.
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
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	미국 콜로라도주
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	미국 플로리다주
US_IL_EZPASSIL	미국 일리노이주
US_IL_IPASS	미국 일리노이주
US_IN_EZPASSIN	IN, 미국
US_KS_BESTPASS_HORIZON	KS, 미국
US_KS_KTAG	KS, 미국
US_KS_NATIONALPASS	KS, 미국
US_KS_PREPASS_ELITEPASS	KS, 미국
US_KY_RIVERLINK	KY, 미국
US_LA_GEAUXPASS	LA, 미국
US_LA_TOLL_TAG	LA, 미국
US_MA_EZPASSMA	MA, USA
US_MD_EZPASSMD	(미국)
US_ME_EZPASSME	ME, USA입니다.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD	미국, 미시간주
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG	미국, 미시간주
US_MI_IQ_PROX_CARD	미국, 미시간주
US_MI_MACKINAC_BRIDGE_MAC_PASS	미국, 미시간주
US_MI_NEXPRESS_TOLL	미국, 미시간주
US_MN_EZPASSMN	미네소타주, 미국
US_NC_EZPASSNC	미국 노스캐롤라이나주
US_NC_PEACH_PASS	미국 노스캐롤라이나주
US_NC_QUICK_PASS	미국 노스캐롤라이나주
US_NH_EZPASSNH	미국 뉴햄프셔주
US_NJ_DOWNBEACH_EXPRESS_PASS	미국 뉴저지주
US_NJ_EZPASSNJ	미국 뉴저지주
US_NY_EXPRESSPASS	미국 뉴욕주
US_NY_EZPASSNY	미국 뉴욕주
US_OH_EZPASSOH	오하이오, 미국.
US_PA_EZPASSPA	미국 펜실베이니아주
US_RI_EZPASSRI	미국
US_SC_PALPASS	미국 SC
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_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	미국 워싱턴주
US_WA_GOOD_TO_GO	미국 워싱턴주
US_WV_EZPASSWV	미국 웨스트버지니아주
US_WV_MEMORIAL_BRIDGE_TICKETS	미국 웨스트버지니아주
US_WV_NEWELL_TOLL_BRIDGE_TICKET	미국 웨스트버지니아주

단위

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

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

차량 배출 유형

차량의 배출 유형을 설명하는 값 세트 DRIVE 이동 모드에만 적용됩니다.

열거형
VEHICLE_EMISSION_TYPE_UNSPECIFIED	배출 유형을 지정하지 않았습니다. 기본값은 GASOLINE입니다.
GASOLINE	휘발유/휘발유 연료로 실행되는 차량입니다.
ELECTRIC	전기 구동 자동차
HYBRID	하이브리드 연료 (예: 휘발유 + 전기)
DIESEL	디젤 연료로 사용되는 차량입니다.

차량 정보

번호판 마지막 문자와 같은 차량 정보를 캡슐화합니다.

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

경유지

경유지를 캡슐화합니다. 경유지에는 경로의 시작과 끝이 모두 표시되며 경로에 있는 중간 정류장이 포함됩니다.

필드
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입니다.
address	string 사람이 읽을 수 있는 주소 또는 더하기 코드 자세한 내용은 https://plus.codes를 참고하세요.