Package google.maps.routing.v2

索引

路徑介面集

Routes API。

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

取得起點和目的地清單,並傳回一個串流,其中包含每個起點和目的地組合的路線資訊。

注意:這種方法需要在輸入中指定回應欄位遮罩。如要提供回應欄位遮罩,您可以使用網址參數 $fieldsfields,或是使用 HTTP/gRPC 標頭 X-Goog-FieldMask (請參閱可用的網址參數和標頭)。這個值是以半形逗號分隔的欄位路徑清單,請參閱這份詳細的說明文件,瞭解如何建立欄位路徑

例如,在這個方法中:

  • 所有可用欄位的欄位遮罩 (用於手動檢查):X-Goog-FieldMask: *
  • 路線時間長度、距離、元素狀態、條件和元素索引的欄位遮罩 (實際工作環境設定範例):X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

請務必在欄位遮罩中加入 status,否則所有訊息都不會顯示。Google 不建議您使用萬用字元 (*) 回應欄位遮罩,原因如下:

  • 只選取您需要的欄位有助於我們的伺服器節省運算週期,讓我們能夠在更短的延遲時間內傳回結果。
  • 僅選取實際工作環境工作中所需的欄位,可確保延遲時間穩定。我們日後可能會新增更多回應欄位,而這些新欄位可能需要額外的運算時間。如果您選取所有欄位,或是在頂層選取了所有欄位,可能會導致成效降低,因為新增的欄位會自動加到回應中。
  • 如果只選取您需要的欄位,回應大小就會更小,因此網路處理量也會變高。
ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

指定一組航點和中繼路線控點,然後傳回主要路線以及選用替代路線。

注意:這種方法需要在輸入中指定回應欄位遮罩。如要提供回應欄位遮罩,您可以使用網址參數 $fieldsfields,或是使用 HTTP/gRPC 標頭 X-Goog-FieldMask (請參閱可用的網址參數和標頭)。這個值是以半形逗號分隔的欄位路徑清單,請參閱建構欄位路徑的詳細說明文件。

例如,在這個方法中:

  • 所有可用欄位的欄位遮罩 (用於手動檢查):X-Goog-FieldMask: *
  • 路線層級時間長度、距離和折線的欄位遮罩 (以產品製作設定範例為例):X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google 不建議使用萬用字元 (*) 回應欄位遮罩或在頂層 (routes) 指定欄位遮罩,原因如下:

  • 只選取您需要的欄位有助於我們的伺服器節省運算週期,讓我們能夠在更短的延遲時間內傳回結果。
  • 僅選取實際工作環境工作中所需的欄位,可確保延遲時間穩定。我們日後可能會新增更多回應欄位,而這些新欄位可能需要額外的運算時間。如果您選取所有欄位,或是在頂層選取了所有欄位,可能會導致成效降低,因為新增的欄位會自動加到回應中。
  • 如果只選取您需要的欄位,回應大小就會更小,因此網路處理量也會變高。

ComputeRouteMatrixRequest

ComputeRouteMatrix 要求訊息

欄位
origins[]

RouteMatrixOrigin

必要欄位。來源陣列,用來決定回應矩陣的資料列。出發地和目的地的基數有幾種大小限制:

  • 起點總數 + 指定為 place_idaddress 的目的地數量總和不得超過 50。
  • 無論在何種情況下,起點數量 × 目的地數量都不得超過 625。
  • 如果 route_preference 設為 TRAFFIC_AWARE_OPTIMAL,則起點數量 × 目的地數量的乘積不得超過 100。
  • 如果將 travel_mode 設為 TRANSIT,則起點數 × 目的地數的乘積不可以大於 100。
destinations[]

RouteMatrixDestination

必要欄位。目的地陣列,用於決定回應矩陣的資料欄。

travel_mode

RouteTravelMode

選用設定。指定交通方式。

routing_preference

RoutingPreference

選用設定。指定路線的計算方式。伺服器會嘗試使用所選的轉送偏好設定計算路徑。如果轉送偏好設定導致錯誤或多餘的延遲時間,系統會傳回錯誤。只有在 travel_modeDRIVETWO_WHEELER 時才能指定此選項,否則要求會失敗。

departure_time

Timestamp

選用設定。出發時間。如果不設定這個值,這個值就會預設為您提出要求的時間。注意:當 RouteTravelMode 設為 TRANSIT 時,您只能指定過去的 departure_time

arrival_time

Timestamp

選用設定。抵達時間。注意:只有在 RouteTravelMode 設為 TRANSIT 時才能設定。您可以指定 departure_timearrival_time,但不能同時指定兩者。

language_code

string

選用設定。BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱「萬國碼 (Unicode) 語言代碼 ID」。如需支援的語言清單,請參閱「語言支援」一文。如未提供這個值,系統會從第一個來源的位置推測顯示語言。

region_code

string

選用設定。區碼,指定為 ccTLD (「頂層網域」) 的兩位字元值詳情請參閱國家/地區代碼頂層網域

units

Units

選用設定。為顯示欄位指定測量單位。

extra_computations[]

ExtraComputation

選用設定。可用來完成要求的額外運算清單。注意:這些額外運算可能會在回應中傳回額外欄位。您也必須在欄位遮罩中指定這些額外欄位,才能在回應中傳回。

traffic_model

TrafficModel

選用設定。指定計算交通時間時要採用的假設。這項設定會影響 RouteMatrixElement 中時間長度欄位傳回的值,其中包含根據歷來平均值預估的交通時間。將 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_modeDRIVETWO_WHEELER 時才能指定此選項,否則要求會失敗。

polyline_quality

PolylineQuality

選用設定。指定折線品質的偏好設定。

polyline_encoding

PolylineEncoding

選用設定。指定折線的偏好編碼。

departure_time

Timestamp

選用設定。出發時間。如果不設定這個值,這個值就會預設為您提出要求的時間。注意:當 RouteTravelMode 設為 TRANSIT 時,您只能指定過去的 departure_time。大眾運輸行程的時間上限為過去 7 天或未來 100 天內。

arrival_time

Timestamp

選用設定。抵達時間。注意:只有在 RouteTravelMode 設為 TRANSIT 時才能設定。您可以指定 departure_timearrival_time,但不能同時指定兩者。大眾運輸行程的時間上限為過去 7 天或未來 100 天內。

compute_alternative_routes

bool

選用設定。指定是否要同時計算和路線以外的替代路線。要求如果具有中繼路線控點,就不會傳回替代路線。

route_modifiers

RouteModifiers

選用設定。一組影響路線計算方式的條件。

language_code

string

選用設定。BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱「萬國碼 (Unicode) 語言代碼 ID」。如需支援的語言清單,請參閱「語言支援」一文。如未提供這個值,系統就會從路線要求的位置推斷顯示語言。

region_code

string

選用設定。區碼,指定為 ccTLD (「頂層網域」) 的兩位字元值詳情請參閱國家/地區代碼頂層網域

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 參考路線計算時,系統會考量各種參數來產生最佳燃油路線。

extra_computations[]

ExtraComputation

選用設定。可用來完成要求的額外運算清單。注意:這些額外運算可能會在回應中傳回額外欄位。您也必須在欄位遮罩中指定這些額外欄位,才能在回應中傳回。

traffic_model

TrafficModel

選用設定。指定計算交通時間時要採用的假設。這項設定會影響 RouteRouteLeg 中時間長度欄位傳回的值,其中包含根據歷來平均值預估的交通時間。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 以格式化的 HTML 文字字串顯示 NavigationInstructions。本內容僅供參考。此內容僅供顯示。請勿以程式輔助方式進行剖析。

ReferenceRoute

ComputeRoutesRequest 支援的參考路徑。

列舉
REFERENCE_ROUTE_UNSPECIFIED 未使用。包含這個值的要求失敗。
FUEL_EFFICIENT 省油路線。標有這個值的路徑會決定要針對燃料消耗等參數進行最佳化。

ComputeRoutesResponse

ComputeRoute 回應訊息。

欄位
routes[]

Route

指定 compute_alternatives_routes 時,包含已計算的路線陣列 (最多三條),如果不指定,則只會包含一條路線。如果這個陣列包含多個項目,建議使用第一個項目。如果陣列為空白,表示找不到路線。

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

結果的類型,會以零或多個類型標記的形式表示。支援的類型:地址類型和地址元件類型

partial_match

bool

表示地理編碼器沒有傳回與原始要求完全相符的結果,但可以比對部分要求的地址。建議您比對原始要求,檢查是否有拼寫錯誤和/或不完整的地址。

place_id

string

此結果的地點 ID。

intermediate_waypoint_request_index

int32

要求中對應中繼路線控點的索引。只有在對應的路線控點為中繼路線控點時才會填入。

GeocodingResults

包含起點、目的地和中繼路線控點的 GeocodedWaypoints。僅針對地址路線控點填入。

欄位
origin

GeocodedWaypoint

來源地理編碼路線控點。

destination

GeocodedWaypoint

目的地地理編碼路線控點。

intermediates[]

GeocodedWaypoint

一組中繼地理編碼路線控點清單,每個包含索引欄位的索引欄位,會依照在要求中指定路線控點的順序 (從零開始為單位) 對應。

LocalizedTime

本地化的時間說明。

欄位
time

LocalizedText

在指定時區中以字串形式指定的時間。

time_zone

string

包含時區。這個值是時區名稱 (如 IANA 時區資料庫中所定義),例如「America/New_York」。

位置

封裝位置 (地理位置點和選用標題)。

欄位
lat_lng

LatLng

路線控點的地理座標。

heading

Int32Value

與車流方向相關的指南針標題。這個值用於指定上車和下車的道路側邊。標題值可以介於 0 到 360 之間,其中 0 可指定朝北方的方向,90 則指定正朝向的方向等等。這個欄位僅適用於 DRIVETWO_WHEELER RouteTravelMode

芒果

一組值,用於指定目前步驟要執行的導覽動作 (例如向左轉、合併或直線)。

列舉
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 中繼路線控點的路線會有兩個路段。包含一個 via 中繼路線控點的路線會有一個路段。路段的順序與從 originintermediatesdestination 的路線控點順序相符。

distance_meters

int32

路線的移動距離 (以公尺為單位)。

duration

Duration

導航路線所需的時間。如果將 routing_preference 設為 TRAFFIC_UNAWARE,則這個值與 static_duration 相同。如果將 routing_preference 設為 TRAFFIC_AWARETRAFFIC_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

具備 Base64 編碼的網路安全路徑符記,可傳遞至 Navigation SDK,允許 Navigation SDK 在導航期間重建路線;如果路線重新傳送,則在您呼叫 ComputeRoutes 建立路徑時遵循原始意圖。客戶應將這個權杖視為不透明 blob。請勿用於讀取或變異。注意:Route.route_token 僅適用於將 ComputeRoutesRequest.routing_preference 設為 TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL 的要求。含有 Via 路線控點的要求不支援 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_preference 設為 TRAFFIC_UNAWARE,則這個值與 static_duration 相同。如果 route_preferenceTRAFFIC_AWARETRAFFIC_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

多模態區隔的 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」是指 Amtrak 列車的 trip_short_text,該列車在平日 15:10 從聖荷西前往加州沙加緬度。

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 有收費路段時,才會填入此欄位。如果已設定了這個欄位,但未填寫預估價格子欄位,我們預期該道路會包含收費站,但我們無法得知預估價格。如果這個欄位不存在,則 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 中針對起點/目的地組合計算出的路線資訊。這個原型可以串流至用戶端。

欄位
status

Status

此元素的錯誤狀態碼。

condition

RouteMatrixElementCondition

指出系統是否找到路線。與狀態無關。

distance_meters

int32

路線的移動距離 (以公尺為單位)。

duration

Duration

導航路線所需的時間。如果將 routing_preference 設為 TRAFFIC_UNAWARE,則這個值與 static_duration 相同。如果將 routing_preference 設為 TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL,則系統在計算這個值時會考量路況。

static_duration

Duration

行經路線所需的時間 (不考量路況)。

travel_advisory

RouteTravelAdvisory

路線的其他資訊。例如:限制資訊和收費資訊

fallback_info

FallbackInfo

在某些情況下,當伺服器無法按照此特定起點/目的地組合的指定偏好設定計算路徑時,可能會改回使用不同的計算模式。使用備用模式時,這個欄位會包含備用回應的詳細資訊。否則,系統不會設定這個欄位。

localized_values

LocalizedValues

RouteMatrixElement 屬性的文字表示法。

origin_index

int32

要求中來源的從零開始索引。

destination_index

int32

要求中的目的地索引 (從零開始)。

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_metersduration)。

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

用於指定交通方式的一組值。注意:WALKBICYCLETWO_WHEELER 路線仍為 Beta 版,但有時可能會遺漏清楚的人行道、人行道或單車道。您必須在應用程式中顯示的所有步行、單車和雙輪路線時,向使用者顯示這則警告。

列舉
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 (從零開始的索引),SpeedReadingInterval 會使用以下類別定義間隔並描述流量。

欄位
start_polyline_point_index

int32

在折線中,此間隔的起始索引。

end_polyline_point_index

int32

在折線中,此間隔的結束索引。

聯集欄位 speed_type

speed_type 只能採用下列其中一種設定:

speed

Speed

這個區間的流量速度。

速度

根據流量資料區分的折線速度。

列舉
SPEED_UNSPECIFIED 預設值。未使用這個值。
NORMAL 一般速度,未偵測到車多擁擠情形。
SLOW 偵測到車多擁擠,但沒有任何交通壅塞。
TRAFFIC_JAM 偵測到交通壅塞,

TollInfo

RouteRouteLeg 上封裝收費資訊。

欄位
estimated_price[]

Money

相應 RouteRouteLeg 的過路費。這份清單包含由付費車站收取的每個幣別的金額。一般來說,這份清單只會針對一種貨幣的收費路線顯示一個項目,如果是國際行程,這份清單可能包含多個項目,反映不同幣別的過路費。

TollPass

我們支援的全球收費通行證清單。

列舉
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 印尼。電子卡片由多家銀行提供,用於支付過路費。所有透過銀行的電子卡片都相同,因此只需要一個列舉值。例如: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 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 AL (美國)
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS 美國
US_CA_FASTRAK 加拿大、美國
US_CA_FASTRAK_CAV_STICKER 表示駕駛人除了 DMV 核發的「Clean Air Vehicle (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 在美國、
US_KS_BESTPASS_HORIZON KS,美國。
US_KS_KTAG KS,美國。
US_KS_NATIONALPASS KS,美國。
US_KS_PREPASS_ELITEPASS KS,美國。
US_LA_GEAUXPASS 美國洛杉磯。
US_LA_TOLL_TAG 美國洛杉磯。
US_MA_EZPASSMA 美國麻薩諸塞州
US_MD_EZPASSMD 美國馬裡蘭州。
US_ME_EZPASSME ME,美國
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。
US_NJ_DOWNBEACH_EXPRESS_PASS 美國紐澤西州。
US_NJ_EZPASSNJ 美國紐澤西州。
US_NY_EXPRESSPASS 美國紐約州紐約市
US_NY_EZPASSNY 美國紐約州紐約市
US_OH_EZPASSOH 美國俄亥俄州
US_PA_EZPASSPA PA,美國
US_RI_EZPASSRI 美國羅德島州
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 華盛頓州
US_WA_GOOD_TO_GO 華盛頓州
US_WV_EZPASSWV WV,美國。
US_WV_MEMORIAL_BRIDGE_TICKETS WV,美國。
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 Avenue 當地」。

uri

string

這條大眾運輸路線的 URI (由運輸公司提供)。

color

string

這條路線常用的顏色,以十六進製表示。

icon_uri

string

這條路線相關圖示的 URI。

name_short

string

這條大眾運輸路線的簡稱。這個名稱通常會是行號,例如「M7」或「355」。

text_color

string

這條路線通常用於標示文字的顏色。以十六進製表示。

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 搭乘火車。這相當於 SUBWAYTRAINLIGHT_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