Package google.maps.routing.v2

색인

• Routes(인터페이스)
• ComputeRouteMatrixRequest(메시지)
• ComputeRouteMatrixRequest.ExtraComputation(열거형)
• ComputeRoutesRequest(메시지)
• ComputeRoutesRequest.ExtraComputation(열거형)
• ComputeRoutesRequest.ReferenceRoute(열거형)
• ComputeRoutesResponse(메시지)
• FallbackInfo(메시지)
• FallbackReason(열거형)
• FallbackRoutingMode(열거형)
• GeocodedWaypoint(메시지)
• GeocodingResults(메시지)
• LocalizedTime(메시지)
• Location(메시지)
• Maneuver(열거형)
• NavigationInstruction(메시지)
• Polyline(메시지)
• PolylineDetails(메시지)
• PolylineDetails.FlyoverInfo(메시지)
• PolylineDetails.NarrowRoadInfo(메시지)
• PolylineDetails.PolylinePointIndex(메시지)
• PolylineDetails.RoadFeatureState(열거형)
• PolylineEncoding(열거형)
• PolylineQuality(열거형)
• Route(메시지)
• Route.RouteLocalizedValues(메시지)
• RouteLabel(열거형)
• RouteLeg(메시지)
• RouteLeg.RouteLegLocalizedValues(메시지)
• RouteLeg.StepsOverview(메시지)
• RouteLeg.StepsOverview.MultiModalSegment(메시지)
• RouteLegStep(메시지)
• RouteLegStep.RouteLegStepLocalizedValues(메시지)
• RouteLegStepTransitDetails(메시지)
• RouteLegStepTransitDetails.TransitDetailsLocalizedValues(메시지)
• RouteLegStepTransitDetails.TransitStopDetails(메시지)
• RouteLegStepTravelAdvisory(메시지)
• RouteLegTravelAdvisory(메시지)
• RouteMatrixDestination(메시지)
• RouteMatrixElement(메시지)
• RouteMatrixElement.LocalizedValues(메시지)
• RouteMatrixElementCondition(열거형)
• RouteMatrixOrigin(메시지)
• RouteModifiers(메시지)
• RouteTravelAdvisory(메시지)
• RouteTravelMode(열거형)
• RoutingPreference(열거형)
• SpeedReadingInterval(메시지)
• SpeedReadingInterval.Speed(열거형)
• TollInfo(메시지)
• TollPass(열거형)
• TrafficModel(열거형)
• TransitAgency(메시지)
• TransitLine(메시지)
• TransitPreferences(메시지)
• TransitPreferences.TransitRoutingPreference(열거형)
• TransitPreferences.TransitTravelMode(열거형)
• TransitStop(메시지)
• TransitVehicle(메시지)
• TransitVehicle.TransitVehicleType(열거형)
• 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를 포함해야 합니다. 그렇지 않으면 모든 메시지가 정상적으로 표시됩니다. 와일드 카드 (*) 응답 필드 마스크는 다음과 같은 이유로 권장되지 않습니다. 필요한 필드만 선택하면 Google 서버에서 계산 주기를 절약하여 지연 시간을 줄여 결과를 반환할 수 있습니다. 프로덕션 작업에 필요한 필드만 선택하면 안정적인 지연 시간 성능을 보장할 수 있습니다. 향후 응답 필드가 추가될 수 있으며, 이러한 새 필드에는 추가 계산 시간이 필요할 수 있습니다. 모든 필드를 선택하거나 최상위 수준에서 모든 필드를 선택하면 추가된 새 필드가 응답에 자동으로 포함되므로 성능이 저하될 수 있습니다. 필요한 필드만 선택하면 응답 크기가 줄어들어 네트워크 처리량이 증가합니다.

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

ComputeRouteMatrixRequest

ComputeRouteMatrix 요청 메시지

필드
origins[]	RouteMatrixOrigin 필수 항목입니다. 응답 행렬의 행을 결정하는 출처 배열입니다. 출처 및 대상의 카디널리티에는 여러 크기 제한사항이 적용됩니다. 출발지 수 + place_id 또는 address로 지정된 도착지 수는 50을 초과할 수 없습니다. 출발지 수 × 도착지 수는 어떤 경우에도 625를 초과해서는 안 됩니다. routing_preference가 TRAFFIC_AWARE_OPTIMAL로 설정된 경우 출발지 수 × 도착지 수가 100을 초과해서는 안 됩니다. travel_mode가 TRANSIT로 설정된 경우 출발지 수 × 목적지 수가 100을 초과해서는 안 됩니다.
destinations[]	RouteMatrixDestination 필수 항목입니다. 응답 행렬의 열을 결정하는 대상 배열입니다.
travel_mode	RouteTravelMode 선택사항입니다. 이동수단을 지정합니다.
routing_preference	RoutingPreference 선택사항입니다. 경로를 계산하는 방법을 지정합니다. 서버는 선택한 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정으로 인해 오류가 발생하거나 지연 시간이 너무 길어지면 오류가 반환됩니다. travel_mode가 DRIVE 또는 TWO_WHEELER인 경우에만 이 옵션을 지정할 수 있습니다. 그러지 않으면 요청이 실패합니다.
departure_time	Timestamp 선택사항입니다. 출발 시간입니다. 이 값을 설정하지 않으면 기본값은 요청한 시간입니다. 참고: RouteTravelMode가 TRANSIT로 설정된 경우에만 과거의 departure_time를 지정할 수 있습니다.
arrival_time	Timestamp 선택사항입니다. 도착 시간입니다. 참고: RouteTravelMode가 TRANSIT로 설정된 경우에만 설정할 수 있습니다. departure_time 또는 arrival_time 중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다.
language_code	string 선택사항입니다. BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn') 자세한 내용은 유니코드 언어 ID를 참고하세요. 지원되는 언어 목록은 언어 지원을 참고하세요. 이 값을 제공하지 않으면 표시 언어가 첫 번째 출처의 위치에서 추론됩니다.
region_code	string 선택사항입니다. ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 자세한 내용은 국가 코드 최상위 도메인을 참고하세요.
units	Units 선택사항입니다. 디스플레이 필드의 측정 단위를 지정합니다.
extra_computations[]	ExtraComputation 선택사항입니다. 요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다. 참고: 이러한 추가 계산으로 인해 응답에 추가 필드가 반환될 수 있습니다. 이러한 추가 필드는 응답에서 반환되도록 필드 마스크에 지정되어야 합니다.
traffic_model	TrafficModel 선택사항입니다. 이동 시간을 계산할 때 사용할 가정을 지정합니다. 이 설정은 이전 평균을 기반으로 한 예상 이동 시간이 포함된 RouteMatrixElement의 duration 필드에 반환되는 값에 영향을 미칩니다. TrafficModel는 RoutingPreference를 TRAFFIC_AWARE_OPTIMAL로, RouteTravelMode를 DRIVE로 설정한 요청에만 사용할 수 있습니다. 트래픽이 요청되고 TrafficModel이 지정되지 않은 경우 기본값은 BEST_GUESS입니다.
transit_preferences	TransitPreferences 선택사항입니다. TRANSIT 경로에 대해 반환되는 경로에 영향을 미치는 환경설정을 지정합니다. 참고: RouteTravelMode가 TRANSIT로 설정된 경우에만 transit_preferences를 지정할 수 있습니다.

ExtraComputation

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

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

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 선택사항입니다. 출발 시간입니다. 이 값을 설정하지 않으면 기본값은 요청한 시간입니다. 참고: RouteTravelMode가 TRANSIT로 설정된 경우에만 과거의 departure_time를 지정할 수 있습니다. 대중교통 이동은 최대 7일 전 또는 100일 후까지 사용할 수 있습니다.
arrival_time	Timestamp 선택사항입니다. 도착 시간입니다. 참고: RouteTravelMode가 TRANSIT로 설정된 경우에만 설정할 수 있습니다. departure_time 또는 arrival_time 중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다. 대중교통 이동은 최대 7일 전 또는 100일 후까지 사용할 수 있습니다.
compute_alternative_routes	bool 선택사항입니다. 경로 외에 대체 경로를 계산할지 지정합니다. 중간 경유지가 있는 요청에는 대체 경로가 반환되지 않습니다.
route_modifiers	RouteModifiers 선택사항입니다. 경로가 계산되는 방식에 영향을 미치는 충족 조건 집합입니다.
language_code	string 선택사항입니다. BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn') 자세한 내용은 유니코드 언어 ID를 참고하세요. 지원되는 언어 목록은 언어 지원을 참고하세요. 이 값을 제공하지 않으면 경로 요청의 위치에서 표시 언어가 추론됩니다.
region_code	string 선택사항입니다. ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 자세한 내용은 국가 코드 최상위 도메인을 참고하세요.
units	Units 선택사항입니다. 디스플레이 필드의 측정 단위를 지정합니다. 이러한 필드에는 NavigationInstruction의 instruction 필드가 포함됩니다. 경로, 구간, 걸음 거리, 시간에 사용되는 측정 단위는 이 값의 영향을 받지 않습니다. 이 값을 제공하지 않으면 표시 단위가 첫 번째 원점의 위치에서 추론됩니다.
optimize_waypoint_order	bool 선택사항입니다. true로 설정하면 서비스는 지정된 중간 웨이포인트의 순서를 다시 지정하여 경로의 전체 비용을 최소화하려고 시도합니다. 중간 경유지 중 하나가 via 경유지인 경우 요청이 실패합니다. ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index를 사용하여 새 순서를 찾습니다. X-Goog-FieldMask 헤더에서 ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index가 요청되지 않으면 요청이 실패합니다. optimize_waypoint_order가 false로 설정되면 ComputeRoutesResponse.optimized_intermediate_waypoint_index는 비어 있습니다.
requested_reference_routes[]	ReferenceRoute 선택사항입니다. 기본 경로 외에 요청의 일부로 계산할 참조 경로를 지정합니다. 참조 경로는 기본 경로와 다른 경로 계산 목표가 있는 경로입니다. 예를 들어 FUEL_EFFICIENT 참조 경로 계산은 최적의 연료 효율 경로를 생성하는 다양한 매개변수를 고려합니다. 이 기능을 사용할 때는 결과 경로에서 route_labels를 찾습니다.
extra_computations[]	ExtraComputation 선택사항입니다. 요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다. 참고: 이러한 추가 계산으로 인해 응답에 추가 필드가 반환될 수 있습니다. 이러한 추가 필드는 응답에서 반환되도록 필드 마스크에 지정되어야 합니다.
traffic_model	TrafficModel 선택사항입니다. 이동 시간을 계산할 때 사용할 가정을 지정합니다. 이 설정은 이전 평균을 기반으로 한 예상 이동 시간이 포함된 Route 및 RouteLeg의 기간 필드에 반환되는 값에 영향을 미칩니다. TrafficModel는 RoutingPreference를 TRAFFIC_AWARE_OPTIMAL로, RouteTravelMode를 DRIVE로 설정한 요청에만 사용할 수 있습니다. 트래픽이 요청되고 TrafficModel이 지정되지 않은 경우 기본값은 BEST_GUESS입니다.
transit_preferences	TransitPreferences 선택사항입니다. TRANSIT 경로에 대해 반환되는 경로에 영향을 미치는 환경설정을 지정합니다. 참고: RouteTravelMode가 TRANSIT로 설정된 경우에만 transit_preferences를 지정할 수 있습니다.

ExtraComputation

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

열거형
EXTRA_COMPUTATION_UNSPECIFIED	사용되지 않음. 이 값이 포함된 요청은 실패합니다.
TOLLS	경로의 통행료 정보입니다.
FUEL_CONSUMPTION	경로의 예상 연료 소비량입니다.
TRAFFIC_ON_POLYLINE	경로의 교통 인식 다중선
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS	NavigationInstructions: 형식이 지정된 HTML 텍스트 문자열로 표시됩니다. 이 콘텐츠는 있는 그대로 읽어야 합니다. 이 콘텐츠는 표시 전용입니다. 프로그래매틱 방식으로 파싱하지 마세요.
FLYOVER_INFO_ON_POLYLINE	경로의 플라이오버 정보입니다. 이 정보를 반환하려면 routes.polyline_details.flyover_info 필드 마스크를 지정해야 합니다. 이 데이터는 현재 인도의 특정 대도시에 대해서만 채워집니다. 이 기능은 실험 단계이며 SKU/요금은 변경될 수 있습니다.
NARROW_ROAD_INFO_ON_POLYLINE	경로의 좁은 도로 정보입니다. 이 정보를 반환하려면 routes.polyline_details.narrow_road_info 필드 마스크를 지정해야 합니다. 이 데이터는 현재 인도의 특정 대도시에 대해서만 채워집니다. 이 기능은 실험 단계이며 SKU/요금은 변경될 수 있습니다.

ReferenceRoute

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

열거형
REFERENCE_ROUTE_UNSPECIFIED	사용되지 않음. 이 값이 포함된 요청은 실패합니다.
FUEL_EFFICIENT	연비 최적 경로
SHORTER_DISTANCE	이동 거리가 더 짧은 경로 실험용으로 제공되는 기능입니다. DRIVE 요청의 경우 이 기능은 운전 편의보다 더 짧은 거리를 우선시합니다. 예를 들어 고속도로 대신 지방 도로를 이용하거나 비포장 도로를 이용하거나 주차장을 통과할 수 있습니다. 이 기능은 Google 지도에서 불법으로 알고 있는 경로를 반환하지 않습니다. BICYCLE 및 TWO_WHEELER 요청의 경우 이 기능은 requested_reference_routes를 지정하지 않을 때 반환되는 것과 유사한 경로를 반환합니다. 이 기능은 중간 경유지 또는 optimize_waypoint_order를 통한 다른 이동 모드와 호환되지 않습니다. 이러한 요청은 실패합니다. 하지만 모든 routing_preference와 함께 사용할 수 있습니다.

ComputeRoutesResponse

응답 메시지의 ComputeRoutes를 실행합니다.

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

FallbackInfo

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

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

FallbackReason

대체 응답을 사용하는 이유

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

FallbackRoutingMode

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

열거형
FALLBACK_ROUTING_MODE_UNSPECIFIED	사용되지 않음.
FALLBACK_TRAFFIC_UNAWARE	응답을 계산하는 데 TRAFFIC_UNAWARE RoutingPreference가 사용되었음을 나타냅니다.
FALLBACK_TRAFFIC_AWARE	응답을 계산하는 데 TRAFFIC_AWARE RoutingPreference가 사용되었음을 나타냅니다.

GeocodedWaypoint

중간 지점으로 사용된 위치에 관한 세부정보입니다. 주소 웨이포인트에 대해서만 채워집니다. 주소가 지오코딩된 위치를 확인하기 위한 지오코딩 결과에 관한 세부정보를 포함합니다.

필드
geocoder_status	Status 지오코딩 작업 결과 발생한 상태 코드를 나타냅니다.
type[]	string 결과의 유형으로, 0개 이상의 유형 태그 형식입니다. 지원되는 유형: 주소 유형 및 주소 구성요소 유형
partial_match	bool 지오코더가 원래 요청에 대해 정확히 일치하는 결과를 반환하지 않았지만 요청된 주소의 일부분과 일치함을 나타냅니다. 원래 요청을 검사하여 맞춤법 오류 및/또는 불완전한 주소를 찾아낼 수 있습니다.
place_id	string 이 결과의 장소 ID입니다.
intermediate_waypoint_request_index	int32 요청에서 해당하는 중간 웨이포인트의 색인입니다. 해당 웨이포인트가 중간 웨이포인트인 경우에만 채워집니다.

GeocodingResults

출발지, 목적지, 중간 경유지의 GeocodedWaypoints를 포함합니다. 주소 웨이포인트에 대해서만 채워집니다.

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

LocalizedTime

시간에 대한 현지화된 설명입니다.

필드
time	LocalizedText 지정된 시간대의 시간으로 문자열로 지정됩니다.
time_zone	string 시간대가 포함됩니다. IANA 시간대 데이터베이스(예: 미국/뉴욕')에 따라 정의된 시간대의 이름이 값으로 사용됩니다.

위치

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

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

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

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

필드
maneuver	Maneuver 현재 단계의 경로 안내 (예: 좌회전, 합류, 직진)를 캡슐화합니다. 이 필드는 표시할 아이콘을 결정합니다.
instructions	string 이 단계를 탐색하는 방법에 관한 안내입니다.

폴리라인

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

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

PolylineDetails

다중선의 지정된 색인 또는 연속 세그먼트에 해당하는 세부정보입니다. P_0, P_1, ... , P_N (0부터 시작하는 색인) 지점이 있는 다중선이 주어지면 PolylineDetails는 간격과 연결된 메타데이터를 정의합니다.

필드
flyover_info[]	FlyoverInfo 다중선의 플라이오버 세부정보
narrow_road_info[]	NarrowRoadInfo 다중선의 좁은 도로 세부정보

FlyoverInfo

다중선의 플라이오버에 관한 정보를 캡슐화합니다.

필드
flyover_presence	RoadFeatureState 출력 전용입니다. 다중선의 특정 구간에 플라이오버가 있는지 여부를 나타냅니다.
polyline_point_index	PolylinePointIndex 다중선의 플라이오버 관련 정보 위치입니다.

NarrowRoadInfo

다중선의 좁은 도로에 관한 정보를 캡슐화합니다.

필드
narrow_road_presence	RoadFeatureState 출력 전용입니다. 다중선의 특정 구간에 좁은 도로가 있는지 나타냅니다.
polyline_point_index	PolylinePointIndex 다중선의 좁은 도로 관련 정보 위치입니다.

PolylinePointIndex

다중선 세부정보의 시작 색인과 끝 색인을 캡슐화합니다. 데이터가 단일 지점에 해당하는 인스턴스의 경우 start_index와 end_index는 같습니다.

필드
start_index	int32 다중선에서 이 세부정보의 시작 색인입니다.
end_index	int32 다중선에서 이 세부정보의 끝 색인입니다.

RoadFeatureState

다중선 구간의 도로 지형지물의 상태를 캡슐화합니다.

열거형
ROAD_FEATURE_STATE_UNSPECIFIED	도로 지형지물의 상태가 계산되지 않았습니다 (기본값).
EXISTS	도로 지형지물이 존재합니다.
DOES_NOT_EXIST	도로 지형지물이 존재하지 않습니다.

PolylineEncoding

반환할 선분의 기본 유형을 지정합니다.

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

PolylineQuality

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

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

경로

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

필드
route_labels[]	RouteLabel 다른 경로와 비교할 경로의 특정 속성을 식별하는 데 유용한 Route의 라벨입니다.
legs[]	RouteLeg 경로를 구성하는 구간 (경유지 간의 경로 세그먼트) 모음입니다. 각 구간은 via가 아닌 두 Waypoints 간의 이동에 해당합니다. 예를 들어 중간 경유지가 없는 경로에는 구간이 하나만 있습니다. via가 아닌 중간 경유지가 하나 포함된 경로에는 두 개의 구간이 있습니다. via 중간 경유지가 하나 포함된 경로에는 구간이 하나 있습니다. 구간의 순서는 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 optimize_waypoint_order를 true로 설정하면 이 필드에 중간 웨이포인트의 최적화된 순서가 포함됩니다. 그렇지 않으면 이 필드는 비어 있습니다. 예를 들어 출발지: LA, 중간 경로: 댈러스, 배너고, 피닉스, 도착지: 뉴욕을 입력하고 최적화된 중간 경로 순서가 피닉스, 댈러스, 배너고인 경우 이 필드에는 값 [2, 0, 1]이 포함됩니다. 색인은 입력에 제공된 첫 번째 중간 웨이포인트의 경우 0으로 시작합니다.
localized_values	RouteLocalizedValues Route의 속성을 텍스트로 표현한 것입니다.
route_token	string Navigation SDK에 전달하여 내비게이션 중에 경로를 재구성하고 경로를 변경하는 경우 경로가 생성될 때의 원래 의도를 준수할 수 있는 불투명 토큰입니다. 이 토큰을 불투명 BLOB로 취급합니다. 서비스가 정확히 동일한 경로를 반환하더라도 값이 변경될 수 있으므로 요청 간에 값을 비교하지 마세요. 참고: Route.route_token는 ComputeRoutesRequest.routing_preference를 TRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정한 요청에만 사용할 수 있습니다. 경유지 경로가 있는 요청에는 Route.route_token가 지원되지 않습니다.
polyline_details	PolylineDetails 다중선의 세부정보에 관한 정보를 포함합니다.

RouteLocalizedValues

특정 속성의 텍스트 표현입니다.

필드
distance	LocalizedText 텍스트 형식으로 표시된 이동 거리입니다.
duration	LocalizedText 텍스트 형식으로 표시되며 쿼리의 지역으로 현지화된 시간입니다. 교통상황을 고려합니다. 참고: 교통 정보를 요청하지 않은 경우 이 값은 static_duration와 동일한 값입니다.
static_duration	LocalizedText 트래픽 상태를 고려하지 않은 시간으로 텍스트 형식으로 표시됩니다.
transit_fare	LocalizedText 대중교통 요금을 텍스트 형식으로 나타냅니다.

RouteLabel

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

열거형
ROUTE_LABEL_UNSPECIFIED	기본값 - 사용되지 않음
DEFAULT_ROUTE	경로 계산에 대해 반환된 기본 '최적' 경로입니다.
DEFAULT_ROUTE_ALTERNATE	기본 '최적' 경로의 대안입니다. compute_alternative_routes가 지정되면 이와 같은 경로가 반환됩니다.
FUEL_EFFICIENT	연비 최적 경로 이 값으로 라벨이 지정된 경로는 연료 소비와 같은 에코 매개변수에 최적화된 것으로 간주됩니다.
SHORTER_DISTANCE	이동 거리가 더 짧은 경로 실험용으로 제공되는 기능입니다.

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 경로 구간의 가능한 교통 구역 제한과 같이 사용자에게 알려야 하는 추가 정보가 포함됩니다.
localized_values	RouteLegLocalizedValues RouteLeg의 속성을 텍스트로 표현한 것입니다.
steps_overview	StepsOverview 이 RouteLeg의 단계에 관한 개요 정보입니다. 이 필드는 대중교통 경로에 대해서만 채워집니다.

RouteLegLocalizedValues

특정 속성의 텍스트 표현입니다.

필드
distance	LocalizedText 텍스트 형식으로 표시된 이동 거리입니다.
duration	LocalizedText 텍스트 형식으로 표시되며 쿼리의 지역으로 현지화된 시간입니다. 교통상황을 고려합니다. 참고: 트래픽 정보를 요청하지 않은 경우 이 값은 static_duration과 동일한 값입니다.
static_duration	LocalizedText 트래픽 상태를 고려하지 않은 시간으로 텍스트 형식으로 표시됩니다.

StepsOverview

RouteLegStep 목록에 관한 개요 정보를 제공합니다.

필드
multi_modal_segments[]	MultiModalSegment RouteLeg.steps의 다양한 멀티모달 세그먼트에 관한 요약된 정보입니다. RouteLeg에 단계에 멀티모달 세그먼트가 포함되어 있지 않으면 이 필드가 채워지지 않습니다.

MultiModalSegment

RouteLeg.steps의 다양한 다중 모드 세그먼트에 관한 요약 정보를 제공합니다. 다중 모달 세그먼트는 동일한 RouteTravelMode를 가진 연속된 RouteLegStep 1개 이상으로 정의됩니다. RouteLeg에 단계에 멀티모달 세그먼트가 포함되어 있지 않으면 이 필드가 채워지지 않습니다.

필드
navigation_instruction	NavigationInstruction 멀티모달 세그먼트의 NavigationInstruction입니다.
travel_mode	RouteTravelMode 멀티모달 세그먼트의 이동 수단입니다.
step_start_index	int32 멀티모달 세그먼트의 시작인 상응하는 RouteLegStep 색인입니다.
step_end_index	int32 멀티모달 세그먼트의 끝인 상응하는 RouteLegStep 색인입니다.

RouteLegStep

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

필드
distance_meters	int32 이 단계의 이동 거리(미터)입니다. 경우에 따라 이 필드에 값이 없을 수 있습니다.
static_duration	Duration 교통 상황을 고려하지 않고 이 단계를 통과하는 데 걸리는 시간입니다. 경우에 따라 이 필드에 값이 없을 수 있습니다.
polyline	Polyline 이 단계와 연결된 다중선입니다.
start_location	Location 이 단계의 시작 위치입니다.
end_location	Location 이 단계의 종료 위치입니다.
navigation_instruction	NavigationInstruction 내비게이션 안내
travel_advisory	RouteLegStepTravelAdvisory 구간 단계에서 가능한 교통 구역 제한과 같이 사용자에게 알려야 하는 추가 정보가 포함됩니다.
localized_values	RouteLegStepLocalizedValues RouteLegStep의 속성을 텍스트로 표현한 것입니다.
transit_details	RouteLegStepTransitDetails 이동 모드가 TRANSIT인 경우 이 단계와 관련된 세부정보입니다.
travel_mode	RouteTravelMode 이 단계에 사용된 이동 수단입니다.

RouteLegStepLocalizedValues

특정 속성의 텍스트 표현입니다.

필드
distance	LocalizedText 텍스트 형식으로 표시된 이동 거리입니다.
static_duration	LocalizedText 트래픽 상태를 고려하지 않은 시간으로 텍스트 형식으로 표시됩니다.

RouteLegStepTransitDetails

TRANSIT 경로와 관련된 RouteLegStep의 추가 정보입니다.

필드
stop_details	TransitStopDetails 경로의 도착 정류장 및 출발 정류장에 대한 정보입니다.
localized_values	TransitDetailsLocalizedValues RouteLegStepTransitDetails의 속성을 텍스트로 표현한 것입니다.
headsign	string 이 노선의 이동 방향을 지정하며 차량이나 출발 정류장에 표시됩니다. 방향은 종착역인 경우가 많습니다.
headway	Duration 현재 동일한 정류장에서 출발하는 시간 간격을 예상 시간으로 지정합니다. 예를 들어 간격(초) 값이 600인 경우 버스를 놓치면 다음 버스까지 10분을 기다려야 합니다.
transit_line	TransitLine 이 단계에서 사용되는 대중교통 노선에 대한 정보입니다.
stop_count	int32 출발 정류장부터 도착 정류장까지의 정류장 수입니다. 이 수치에는 도착 정류장이 포함되지만 출발 정류장은 제외됩니다. 예를 들어 경로가 정류장 A에서 출발하여 정류장 B와 C를 지나 정류장 D에 도착하는 경우 stop_count 3을 반환합니다.
trip_short_text	string 승객에게 대중교통 이동을 식별하기 위해 일정 및 표지판에 표시되는 텍스트입니다. 텍스트는 서비스 요일 내의 이동을 고유하게 식별해야 합니다. 예를 들어 '538'은 평일 오후 3시 10분에 캘리포니아 주 새너재이에서 캘리포니아 주 새크라멘토로 출발하는 Amtrak 열차의 trip_short_text입니다.

TransitDetailsLocalizedValues

RouteTransitDetails 값에 대한 현지화된 설명입니다.

필드
arrival_time	LocalizedTime 시간대와 함께 형식이 지정된 텍스트 표현의 시간입니다.
departure_time	LocalizedTime 시간대와 함께 형식이 지정된 텍스트 표현의 시간입니다.

TransitStopDetails

RouteLegStep의 대중교통 정류장에 대한 세부정보입니다.

필드
arrival_stop	TransitStop 단계의 도착 정류장에 대한 정보입니다.
arrival_time	Timestamp 단계의 도착 예정 시간입니다.
departure_stop	TransitStop 단계의 출발 정류장에 대한 정보입니다.
departure_time	Timestamp 단계의 예상 출발 시간입니다.

RouteLegStepTravelAdvisory

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

필드
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).

RouteMatrixDestination

ComputeRouteMatrixRequest의 단일 대상

필드
waypoint	Waypoint 필수 항목입니다. 도착 웨이포인트

RouteMatrixElement

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

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

LocalizedValues

특정 속성의 텍스트 표현입니다.

필드
distance	LocalizedText 텍스트 형식으로 표시된 이동 거리입니다.
duration	LocalizedText 교통상황을 고려하여 텍스트 형식으로 표시된 소요 시간입니다. 참고: 트래픽 정보가 요청되지 않은 경우 이 값은 static_duration과 동일한 값입니다.
static_duration	LocalizedText 트래픽 상태를 고려하지 않고 텍스트 형식으로 표시된 시간입니다.
transit_fare	LocalizedText 대중교통 요금을 텍스트 형식으로 나타냅니다.

RouteMatrixElementCondition

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

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

RouteMatrixOrigin

ComputeRouteMatrixRequest의 단일 출처

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

RouteModifiers

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

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

RouteTravelAdvisory

가능한 트래픽 구역 제한과 같이 사용자에게 알려야 하는 추가 정보가 포함됩니다.

필드
toll_info	TollInfo 경로의 통행료에 관한 정보를 포함합니다. 이 필드는 경로에 통행료가 예상되는 경우에만 채워집니다. 이 필드는 설정되어 있지만 estimatedPrice 하위 필드가 채워지지 않은 경우 경로에 통행료가 포함되어 있지만 예상 가격을 알 수 없습니다. 이 필드가 설정되지 않으면 경로에 예상되는 통행료가 없습니다.
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 마이크로리터 단위로 예측된 연료 소모량입니다.
route_restrictions_partially_ignored	bool 반환된 경로에 요청된 이동 수단 또는 경로 수정자에 적합하지 않은 제한사항이 있을 수 있습니다.
transit_fare	Money 이 속성은 이 경로의 총요금 또는 티켓 비용을 포함합니다(있는 경우). 이 속성은 TRANSIT 요청의 경우에만 반환되며 모든 대중교통 단계에 대해 요금 정보를 사용할 수 있는 경로의 경우에만 반환됩니다.

RouteTravelMode

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

열거형
TRAVEL_MODE_UNSPECIFIED	지정된 이동 수단이 없습니다. 기본값은 DRIVE입니다.
DRIVE	승용차로 이동합니다.
BICYCLE	자전거로 이동합니다.
WALK	걷기
TWO_WHEELER	오토바이 오토바이를 예로 들 수 있습니다. 이는 사람이 직접 움직이는 이동 수단을 다루는 BICYCLE 이동 수단과 다릅니다.
TRANSIT	대중교통 경로를 이용할 수 있는 경우 대중교통을 이용합니다.

RoutingPreference

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

열거형
ROUTING_PREFERENCE_UNSPECIFIED	지정된 라우팅 환경설정이 없습니다. 기본값은 TRAFFIC_UNAWARE입니다.
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 다중선에서 이 간격의 시작 색인입니다.
end_polyline_point_index	int32 다중선에서 이 간격의 종료 색인입니다.
통합 필드 speed_type. speed_type는 다음 중 하나여야 합니다.
speed	Speed 이 간격의 트래픽 속도입니다.

속도

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

열거형
SPEED_UNSPECIFIED	기본값 이 값은 사용되지 않습니다.
NORMAL	정상 속도이며 교통 지연이 없습니다.
SLOW	속도 저하 감지됨, 트래픽 양이 중간 수준입니다.
TRAFFIC_JAM	교통 지연

TollInfo

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 값은 하나만 있으면 됩니다. 예: - Bank 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	일본 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, 미국
US_CA_FASTRAK	미국 캘리포니아
US_CA_FASTRAK_CAV_STICKER	운전자에게 DMV에서 발급한 클린 에어 차량 (CAV) 스티커 외에도 FasTrak 패스가 있음을 나타냅니다. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL	CO, USA.
US_CO_GO_PASS	CO, USA.
US_DE_EZPASSDE	독일, 미국
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS	FL, 미국
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD	FL, 미국
US_FL_EPASS	FL, 미국
US_FL_GIBA_TOLL_PASS	FL, 미국
US_FL_LEEWAY	FL, 미국
US_FL_SUNPASS	FL, 미국
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	MI, 미국
US_MI_BCPASS	MI, 미국
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG	MI, 미국
US_MI_IQ_PROX_CARD	MI, 미국 이 패스 유형은 더 이상 존재하지 않으므로 지원 중단되었습니다. 이 항목은 지원 중단되었습니다.
US_MI_IQ_TAG	MI, 미국
US_MI_MACKINAC_BRIDGE_MAC_PASS	MI, 미국
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, 미국
US_RI_EZPASSRI	RI, 미국
US_SC_PALPASS	SC, 미국
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	WA, 미국
US_WA_GOOD_TO_GO	미국 워싱턴
US_WV_EZPASSWV	WV, 미국
US_WV_MEMORIAL_BRIDGE_TICKETS	미국 서던웨스트 버지니아
US_WV_MOV_PASS	WV, 미국
US_WV_NEWELL_TOLL_BRIDGE_TICKET	WV, 미국

TrafficModel

이동 시간을 계산할 때 사용할 가정을 지정합니다. 이 설정은 응답의 duration 필드에 반환되는 값에 영향을 미칩니다. 이 필드에는 이전 평균을 기반으로 한 예상 이동 시간이 포함됩니다.

열거형
TRAFFIC_MODEL_UNSPECIFIED	사용하지 않습니다. 지정된 경우 기본값은 BEST_GUESS입니다.
BEST_GUESS	이전 교통상황과 실시간 교통정보에 대해 알려진 정보를 기준으로 할 때 반환된 duration이 최적의 예상 이동 시간임을 나타냅니다. departure_time이 지금에 가까울수록 실시간 교통정보가 더 중요합니다.
PESSIMISTIC	대부분의 날에는 반환된 이동 시간이 실제 이동 시간보다 더 길다는 것을 나타내지만 특히 교통상황이 나쁜 날은 이 값을 초과할 수도 있습니다.
OPTIMISTIC	대부분의 날에는 반환된 이동 시간이 실제 이동 시간보다 짧다는 것을 나타내지만, 교통상황이 특히 좋은 날은 이 값보다 빠를 수도 있습니다.

TransitAgency

대중교통 노선을 운영하는 대중교통 기관입니다.

필드
name	string 이 대중교통 기관의 이름입니다.
phone_number	string 대중교통 기관의 언어별 형식의 전화번호입니다.
uri	string 대중교통 기관의 URI입니다.

TransitLine

이 단계에서 사용되는 대중교통 노선에 대한 정보를 포함합니다.

필드
agencies[]	TransitAgency 이 대중교통 노선을 운영하는 대중교통 기관입니다.
name	string 이 대중교통 노선의 전체 이름입니다(예: '8번가 지역선').
uri	string 대중교통 기관에서 제공하는 대중교통 노선의 URI입니다.
color	string 이 노선의 표지판에 흔히 사용되는 색상입니다. 16진수로 표시됩니다.
icon_uri	string 이 노선과 연결된 아이콘의 URI입니다.
name_short	string 이 대중교통 노선의 짧은 이름입니다. 일반적으로 이 이름은 'M7' 또는 '355'와 같은 노선 번호입니다.
text_color	string 이 노선의 표지판에 흔히 사용되는 텍스트의 색상입니다. 16진수로 표시됩니다.
vehicle	TransitVehicle 이 대중교통 노선에서 운행되는 차량 유형입니다.

TransitPreferences

반환되는 경로에 영향을 미치는 TRANSIT 기반 경로의 환경설정입니다.

필드
allowed_travel_modes[]	TransitTravelMode TRANSIT 경로를 가져올 때 사용할 이동 수단 집합입니다. 기본값은 지원되는 모든 이동 수단입니다.
routing_preference	TransitRoutingPreference 지정하면 반환되는 TRANSIT 경로에 영향을 주는 라우팅 환경설정입니다.

TransitRoutingPreference

대중교통 경로의 라우팅 환경설정을 지정합니다.

열거형
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED	지정된 환경설정이 없음
LESS_WALKING	계산된 경로에서 도보 이동을 제한해야 함을 나타냅니다.
FEWER_TRANSFERS	계산된 경로에서 환승 횟수를 제한해야 함을 나타냅니다.

TransitTravelMode

대중교통 수단을 지정하는 데 사용되는 값 집합입니다.

열거형
TRANSIT_TRAVEL_MODE_UNSPECIFIED	지정된 대중교통 이동 수단이 없습니다.
BUS	버스를 타고 이동합니다.
SUBWAY	지하철을 이용합니다.
TRAIN	기차로 이동합니다.
LIGHT_RAIL	경전철 또는 트램을 이용하세요.
RAIL	기차로 이동합니다. 이는 SUBWAY, TRAIN, LIGHT_RAIL의 조합과 같습니다.

TransitStop

대중교통 정류장 정보입니다.

필드
name	string 대중교통 정류장 이름입니다.
location	Location 정류장의 위치(위도/경도 좌표)입니다.

TransitVehicle

대중교통 경로에 사용되는 차량에 대한 정보입니다.

필드
name	LocalizedText 이 차량의 이름입니다(대문자).
type	TransitVehicleType 사용된 차량 유형입니다.
icon_uri	string 이 차량 유형과 연결된 아이콘의 URI입니다.
local_icon_uri	string 지역 교통 표지판을 기반으로 이 운송 수단 유형과 연결되는 아이콘의 URI입니다.

TransitVehicleType

대중교통 경로의 차량 유형입니다.

열거형
TRANSIT_VEHICLE_TYPE_UNSPECIFIED	사용하지 않습니다.
BUS	버스
CABLE_CAR	일반적으로 지상에서 케이블로 운영되는 차량입니다. 공중 케이블카는 GONDOLA_LIFT 유형일 수도 있습니다.
COMMUTER_TRAIN	통근 열차
FERRY	페리
FUNICULAR	케이블로 당겨서 가파른 경사를 오르는 차량입니다. 푸니쿨라는 일반적으로 두 차량으로 구성되며, 각 차량이 다른 차량의 평형추 역할을 합니다.
GONDOLA_LIFT	공중 케이블카
HEAVY_RAIL	철도
HIGH_SPEED_TRAIN	고속 열차
INTERCITY_BUS	시외버스
LONG_DISTANCE_TRAIN	장거리 열차
METRO_RAIL	경전철
MONORAIL	모노레일
OTHER	기타 모든 차량
RAIL	철도
SHARE_TAXI	합승 택시는 일종의 버스이며, 경로상의 어느 곳에서나 승객이 승하차할 수 있습니다.
SUBWAY	지하철
TRAM	지상철
TROLLEYBUS	트롤리 버스

단위

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

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

VehicleEmissionType

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

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

VehicleInfo

차량 배출 유형과 같은 차량 정보를 포함합니다.

필드
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 RouteTravelMode에만 적용됩니다.
통합 필드 location_type. 위치를 나타내는 다양한 방법 location_type은 다음 중 하나여야 합니다.
location	Location 선택적 방향을 포함하여 지리적 좌표를 사용하여 지정된 지점입니다.
place_id	string 경로 지점과 연결된 관심 장소 장소 ID입니다.
address	string 사람이 읽을 수 있는 주소 또는 Plus Code입니다. 자세한 내용은 https://plus.codes를 참고하세요.