Package google.maps.routing.v2

색인

경로

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를 포함하는 것이 중요합니다. 그렇지 않으면 모든 메시지가 정상인 것처럼 보입니다. 다음과 같은 이유로 와일드 카드 (*) 응답 필드 마스크를 사용하지 않는 것이 좋습니다.

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

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

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

ComputeRouteMatrixRequest

ComputeRouteMatrix 요청 메시지

입력란
origins[]

RouteMatrixOrigin

필수 항목입니다. 응답 행렬의 행을 결정하는 출처의 배열입니다. 출발지와 목적지의 카디널리티에는 몇 가지 크기 제한이 적용됩니다.

  • 출발지 수와 place_id 또는 address로 지정된 목적지 수를 합한 값은 50 이하여야 합니다.
  • 출발지 수 × 목적지 수의 곱은 어떠한 경우에도 625 이하여야 합니다.
  • 라우팅_preference가 TRAFFIC_AWARE_OPTIMAL로 설정된 경우 출발지 수 × 목적지 수를 곱한 값은 100 이하여야 합니다.
  • travel_mode가 TRANSIT로 설정된 경우 출발지 수 × 목적지 수를 곱한 값은 100 이하여야 합니다.
destinations[]

RouteMatrixDestination

필수 항목입니다. 응답 매트릭스의 열을 결정하는 대상의 배열입니다.

travel_mode

RouteTravelMode

선택사항입니다. 교통수단을 지정합니다.

routing_preference

RoutingPreference

선택사항입니다. 경로 계산 방법을 지정합니다. 서버에서는 선택된 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정에서 오류가 발생하거나 지연 시간이 길어지면 오류가 반환됩니다. travel_modeDRIVE 또는 TWO_WHEELER인 경우에만 이 옵션을 지정할 수 있으며, 그렇지 않으면 요청이 실패합니다.

departure_time

Timestamp

선택사항입니다. 출발 시간입니다. 이 값을 설정하지 않으면 요청한 시간이 기본값으로 설정됩니다. 참고: RouteTravelModeTRANSIT로 설정된 경우에만 과거에 departure_time를 지정할 수 있습니다.

arrival_time

Timestamp

선택사항입니다. 도착 시간입니다. 참고: RouteTravelModeTRANSIT로 설정된 경우에만 설정할 수 있습니다. departure_time 또는 arrival_time 중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다.

language_code

string

선택사항입니다. BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn')입니다. 자세한 내용은 유니코드 언어 식별자를 참조하세요. 지원되는 언어 목록을 보려면 언어 지원을 참조하세요. 이 값을 제공하지 않으면 표시 언어는 첫 번째 출발지의 위치에서 추론됩니다.

region_code

string

선택사항입니다. ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 자세한 내용은 국가 코드 최상위 도메인을 참고하세요.

units

Units

선택사항입니다. 표시 필드의 측정 단위를 지정합니다.

extra_computations[]

ExtraComputation

선택사항입니다. 요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다. 참고: 이러한 추가 계산은 응답에 추가 필드를 반환할 수도 있습니다. 이러한 추가 필드는 응답에서 반환되도록 필드 마스크에 지정되어야 합니다.

traffic_model

TrafficModel

선택사항입니다. 이동 시간을 계산할 때 사용할 가정을 지정합니다. 이 설정은 이전 평균을 기반으로 한 예상 이동 시간을 포함하는 RouteMatrixElement의 기간 필드에 반환되는 값에 영향을 미칩니다. RoutingPreference에서 TRAFFIC_AWARE_OPTIMAL로, RouteTravelMode에서 DRIVE로 트래픽이 요청되고 TrafficModel가 지정되지 않은 경우 기본값은 BEST_GUESS입니다.

transit_preferences

TransitPreferences

선택사항입니다. TRANSIT 경로에 대해 반환되는 경로에 영향을 미치는 환경설정을 지정합니다. 참고: RouteTravelModeTRANSIT로 설정된 경우에만 transit_preferences를 지정할 수 있습니다.

ExtraComputation

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

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

ComputeRoutesRequest

ComputeRoutes 요청 메시지입니다.

입력란
origin

Waypoint

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

destination

Waypoint

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

intermediates[]

Waypoint

선택사항입니다. 경로에 있는 경유지 집합 (터미널 지점 제외). 중간 경유지는 최대 25개까지 지원됩니다.

travel_mode

RouteTravelMode

선택사항입니다. 교통수단을 지정합니다.

routing_preference

RoutingPreference

선택사항입니다. 경로 계산 방법을 지정합니다. 서버에서는 선택된 라우팅 환경설정을 사용하여 경로를 계산하려고 시도합니다. 라우팅 환경설정에서 오류가 발생하거나 지연 시간이 길어지면 오류가 반환됩니다. travel_modeDRIVE 또는 TWO_WHEELER인 경우에만 이 옵션을 지정할 수 있으며, 그렇지 않으면 요청이 실패합니다.

polyline_quality

PolylineQuality

선택사항입니다. 다중선의 품질에 대한 기본 설정을 지정합니다.

polyline_encoding

PolylineEncoding

선택사항입니다. 다중선에 대한 기본 인코딩을 지정합니다.

departure_time

Timestamp

선택사항입니다. 출발 시간입니다. 이 값을 설정하지 않으면 요청한 시간이 기본값으로 설정됩니다. 참고: RouteTravelModeTRANSIT로 설정된 경우에만 과거에 departure_time를 지정할 수 있습니다. 대중교통 여정은 최대 지난 7일 또는 향후 100일 동안 사용할 수 있습니다.

arrival_time

Timestamp

선택사항입니다. 도착 시간입니다. 참고: RouteTravelModeTRANSIT로 설정된 경우에만 설정할 수 있습니다. departure_time 또는 arrival_time 중 하나를 지정할 수 있지만 둘 다 지정할 수는 없습니다. 대중교통 여정은 최대 지난 7일 또는 향후 100일 동안 사용할 수 있습니다.

compute_alternative_routes

bool

선택사항입니다. 경로 외에 대체 경로를 계산할지 여부를 지정합니다. 중간 경유지가 있는 요청에는 대체 경로가 반환되지 않습니다.

route_modifiers

RouteModifiers

선택사항입니다. 경로 계산 방식에 영향을 주는 충족하는 조건 집합입니다.

language_code

string

선택사항입니다. BCP-47 언어 코드(예: 'en-US' 또는 'sr-Latn')입니다. 자세한 내용은 유니코드 언어 식별자를 참조하세요. 지원되는 언어 목록을 보려면 언어 지원을 참조하세요. 이 값을 제공하지 않으면 표시 언어는 경로 요청의 위치에서 추론됩니다.

region_code

string

선택사항입니다. ccTLD ('최상위 도메인') 2자리 값으로 지정되는 지역 코드입니다. 자세한 내용은 국가 코드 최상위 도메인을 참고하세요.

units

Units

선택사항입니다. 표시 필드의 측정 단위를 지정합니다. 이러한 필드에는 NavigationInstructioninstruction 필드가 포함됩니다. 경로, 구간, 보폭, 소요 시간에 사용되는 측정 단위는 이 값의 영향을 받지 않습니다. 이 값을 제공하지 않으면 첫 번째 출처의 위치에서 표시 단위가 유추됩니다.

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 참조 경로 계산에서는 최적의 연비 경로를 생성하는 다양한 매개변수를 고려합니다.

extra_computations[]

ExtraComputation

선택사항입니다. 요청을 완료하는 데 사용할 수 있는 추가 계산 목록입니다. 참고: 이러한 추가 계산은 응답에 추가 필드를 반환할 수도 있습니다. 이러한 추가 필드는 응답에서 반환되도록 필드 마스크에 지정되어야 합니다.

traffic_model

TrafficModel

선택사항입니다. 이동 시간을 계산할 때 사용할 가정을 지정합니다. 이 설정은 이전 평균을 기반으로 한 예상 이동 시간을 포함하는 RouteRouteLeg의 기간 필드에 반환되는 값에 영향을 미칩니다. TrafficModelRoutingPreferenceTRAFFIC_AWARE_OPTIMAL로, RouteTravelModeDRIVE로 설정한 요청에만 사용할 수 있습니다. 트래픽이 요청되고 TrafficModel가 지정되지 않은 경우 기본값은 BEST_GUESS입니다.

transit_preferences

TransitPreferences

선택사항입니다. TRANSIT 경로에 대해 반환되는 경로에 영향을 미치는 환경설정을 지정합니다. 참고: RouteTravelModeTRANSIT로 설정된 경우에만 transit_preferences를 지정할 수 있습니다.

ExtraComputation

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

열거형
EXTRA_COMPUTATION_UNSPECIFIED 사용되지 않음. 이 값이 포함된 요청은 실패합니다.
TOLLS 경로에 대한 통행료 정보입니다.
FUEL_CONSUMPTION 경로의 예상 연료 소비량입니다.
TRAFFIC_ON_POLYLINE 경로의 교통 인식 다중선입니다.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions는 형식이 지정된 HTML 텍스트 문자열로 표시됩니다. 이 콘텐츠는 있는 그대로 읽어야 합니다. 이 콘텐츠는 표시 전용입니다. 프로그래매틱 방식으로 파싱하지 마세요.

ReferenceRoute

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

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

ComputeRoutesResponse

응답 메시지를 ComputeRoutes합니다.

입력란
routes[]

Route

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

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은 정동 방향을 지정합니다. 이 필드는 DRIVETWO_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 거리 이름 변경을 나타내는 데 사용됩니다.

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

입력란
maneuver

Maneuver

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

instructions

string

이 단계를 탐색하기 위한 안내

Polyline

인코딩된 폴리라인을 캡슐화합니다.

입력란
통합 필드 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 옵션을 사용할 때보다 요청 지연 시간이 짧아집니다.

경로

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

입력란
route_labels[]

RouteLabel

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

legs[]

RouteLeg

경로를 구성하는 구간 (경유지 사이의 경로 세그먼트) 모음입니다. 각 구간은 via이 아닌 두 Waypoints 간의 이동에 해당합니다. 예를 들어 중간 경유지가 없는 경로의 경우 구간이 하나만 있습니다. via가 아닌 중간 경유지가 한 개 포함된 경로의 경우 구간이 2개입니다. 하나의 via 중간 경유지가 포함된 경로의 경우 하나의 구간이 있습니다. 구간의 순서는 origin에서 intermediates, destination 사이의 경유지 순서와 일치합니다.

distance_meters

int32

경로의 이동 거리(미터)입니다.

duration

Duration

경로를 탐색하는 데 필요한 시간입니다. routing_preferenceTRAFFIC_UNAWARE로 설정하면 이 값은 static_duration와 동일합니다. routing_preferenceTRAFFIC_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, 중간 경유지: Dallas, Bangor, Phoenix, Destination: New York을 입력하고 최적화된 중간 경유지 순서가 Phoenix, Dallas, Bangor인 경우 이 필드에는 [2, 0, 1] 값이 포함됩니다. 색인은 입력에 제공된 첫 번째 중간 경유지에 대해 0으로 시작합니다.

localized_values

RouteLocalizedValues

Route 속성의 텍스트 표현

route_token

string

Navigation SDK에 전달할 수 있는 웹 안전 base64 인코딩 경로 토큰입니다. 이 토큰을 사용하면 Navigation SDK가 탐색 중에 경로를 재구성할 수 있습니다. 경로 재설정 시에는 ComputeRoutes를 호출하여 경로를 만들 때 원래 의도를 따릅니다. 고객은 이 토큰을 불투명 blob으로 취급해야 합니다. 읽기 또는 변형을 위한 것이 아닙니다. 참고: Route.route_tokenComputeRoutesRequest.routing_preferenceTRAFFIC_AWARE 또는 TRAFFIC_AWARE_OPTIMAL로 설정한 요청에만 사용할 수 있습니다. Route.route_token는 경유지가 포함된 요청에는 지원되지 않습니다.

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 연비 최적 경로 이 값으로 라벨이 지정된 경로는 연료 소비량과 같은 절전 매개변수에 최적화된 것으로 확인됩니다.

RouteLeg

via이 아닌 경유지 사이의 세그먼트를 포함합니다.

입력란
distance_meters

int32

경로 구간의 이동 거리(미터)입니다.

duration

Duration

구간을 탐색하는 데 필요한 시간입니다. route_preferenceTRAFFIC_UNAWARE로 설정된 경우 이 값은 static_duration과 동일합니다. route_preferenceTRAFFIC_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의 단계에 대한 개요 정보입니다. 이 필드는 Transit 경로에 대해서만 채워집니다.

RouteLegLocalizedValues

특정 속성의 텍스트 표현

입력란
distance

LocalizedText

텍스트 형식으로 표시된 이동 거리입니다.

duration

LocalizedText

텍스트 형식으로 표시된 교통상황을 고려한 시간입니다. 참고: 교통정보를 요청하지 않은 경우 이 값은 static_duration과 동일한 값이 됩니다.

static_duration

LocalizedText

교통상황을 고려하지 않은 지속 시간으로, 텍스트 형식으로 표시됩니다.

StepsOverview

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

입력란
multi_modal_segments[]

MultiModalSegment

RouteLeg.steps의 여러 멀티 모달 세그먼트에 관한 정보를 요약했습니다. RouteLeg의 단계에 다중 모달 세그먼트가 포함되어 있지 않으면 이 필드가 채워지지 않습니다.

MultiModalSegment

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

입력란
navigation_instruction

NavigationInstruction

다중 모달 세그먼트의 NavigationDirections

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'은 평일 15시 10분에 캘리포니아주 산호세에서 출발하여 캘리포니아주 새크라멘토로 가는 암트랙 열차의 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_AWARETRAFFIC_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에서 출발지/목적지 쌍에 대해 계산된 경로 정보를 포함합니다. 이 proto는 클라이언트로 스트리밍할 수 있습니다.

입력란
status

Status

이 요소의 오류 상태 코드입니다.

condition

RouteMatrixElementCondition

경로를 찾았는지 여부를 나타냅니다. 상태와 무관합니다.

distance_meters

int32

경로의 이동 거리(미터)입니다.

duration

Duration

경로를 탐색하는 데 필요한 시간입니다. routing_preferenceTRAFFIC_UNAWARE로 설정하면 이 값은 static_duration와 동일합니다. routing_preferenceTRAFFIC_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로 설정하면 적절한 경우 유료 도로를 제외하며 유료 도로를 포함하지 않는 경로를 우선시합니다. DRIVETWO_WHEELER RouteTravelMode에만 적용됩니다.

avoid_highways

bool

true로 설정하면 적절한 경우 고속도로를 제외하며 고속도로를 포함하지 않는 경로를 우선시합니다. DRIVETWO_WHEELER RouteTravelMode에만 적용됩니다.

avoid_ferries

bool

true로 설정하면 합당한 경우 페리를 제외하며 페리를 포함하지 않는 경로를 우선시합니다. DRIVETWO_WHEELER RouteTravelMode에만 적용됩니다.

avoid_indoor

bool

true로 설정하면 적절한 경우 실내 탐색을 방지하고 실내 내비게이션이 포함되지 않은 경로를 우선시합니다. WALK RouteTravelMode에만 적용됩니다.

vehicle_info

VehicleInfo

차량 정보를 지정합니다.

toll_passes[]

TollPass

톨 패스에 대한 정보를 캡슐화합니다. 톨 패스가 제공되면 API에서 패스 가격을 반환하려고 시도합니다. 통행료가 제공되지 않으면 API는 톨 패스를 알 수 없는 것으로 취급하고 현금 가격을 반환하려고 시도합니다. DRIVETWO_WHEELER RouteTravelMode에만 적용됩니다.

RouteTravelAdvisory

가능한 교통 구역 제한과 같이 사용자에게 알려야 하는 추가 정보가 포함되어 있습니다.

입력란
toll_info

TollInfo

경로에 있는 통행료에 대한 정보가 포함됩니다. 이 필드는 경로에 유료 요금이 예상되는 경우에만 채워집니다. 이 필드는 설정되었지만 estimatedPrice 하위 필드가 채워지지 않은 경우 경로에 유료도로는 포함되지만 예상 가격을 알 수 없습니다. 이 필드를 설정하지 않으면 경로에 유료 도로가 없습니다.

speed_reading_intervals[]

SpeedReadingInterval

트래픽 밀도를 자세히 설명하는 속도 읽기 간격 TRAFFIC_AWARETRAFFIC_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 DRIVETWO_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 인도네시아 통행료를 지불하는 데 사용되는 여러 은행에서 제공하는 전자 카드입니다. 은행을 통한 모든 e-카드는 동일하게 청구되므로 하나의 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 Japan 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 알래스카주, 미국.
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 미국 플로리다주입니다.
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, USA
US_KS_BESTPASS_HORIZON 미국 캔자스주
US_KS_KTAG 미국 캔자스주
US_KS_NATIONALPASS 미국 캔자스주
US_KS_PREPASS_ELITEPASS 미국 캔자스주
US_LA_GEAUXPASS LA, 미국
US_LA_TOLL_TAG LA, 미국
US_MA_EZPASSMA 미국 매사추세츠주
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

미국 미시간주. 이 패스 유형이 더 이상 존재하지 않으므로 지원 중단되었습니다.

US_MI_IQ_TAG 미국 미시간주.
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 NH, USA(미국)입니다.
US_NJ_DOWNBEACH_EXPRESS_PASS 미국 뉴저지주입니다.
US_NJ_EZPASSNJ 미국 뉴저지주입니다.
US_NY_EXPRESSPASS 뉴욕시, 미국.
US_NY_EZPASSNY 뉴욕시, 미국.
US_OH_EZPASSOH 오, 미국.
US_PA_EZPASSPA 펜실베이니아주: 미국.
US_RI_EZPASSRI RI, USA.
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 워싱턴주.
US_WA_GOOD_TO_GO 워싱턴주.
US_WV_EZPASSWV 미국 웨스트버지니아주에 있습니다.
US_WV_MEMORIAL_BRIDGE_TICKETS 미국 웨스트버지니아주에 있습니다.
US_WV_MOV_PASS 미국 웨스트버지니아주
US_WV_NEWELL_TOLL_BRIDGE_TICKET 미국 웨스트버지니아주에 있습니다.

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 Avenue Local').

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 이외의 경유지는 포함되지 않습니다. 이 옵션은 DRIVETWO_WHEELER 이동 모드에서 그리고 location_typeLocation인 경우에만 작동합니다.

side_of_road

bool

이 경유지의 위치가 도로의 특정 쪽에 정차하는 것을 선호한다는 것을 나타냅니다. 이 값을 설정하면 경로가 위치를 통과하므로 차량이 도로의 중심에서 쪽으로 편중되는 도로가에 정차할 수 있습니다. 이 옵션은 DRIVETWO_WHEELER RouteTravelMode에서만 작동합니다.

통합 필드 location_type. 위치를 나타내는 다양한 방법 location_type은 다음 중 하나여야 합니다.
location

Location

지리적 좌표를 사용하여 지정된 지점입니다(선택적 방위 포함).

place_id

string

경유지와 연결된 관심 장소 장소 ID입니다.

address

string

사람이 읽을 수 있는 주소 또는 Plus Code입니다. 자세한 내용은 https://plus.codes를 참고하세요.