Package google.maps.routes.v1

索引

RoutesPreferred

Routes Preferred API。

ComputeCustomRoutes

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

指定一組航廈和中繼路線控點以及路線目標,即可計算路線目標的最佳路徑。系統也會傳回最快路線和最短路線做為參考路線。

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

舉例來說,在這個方法中:

  • 所有可用欄位的欄位遮罩 (用於手動檢查):X-Goog-FieldMask: *
  • 路線距離、所需時間、符記和收費路段的欄位遮罩:X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

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

  • 只選取您需要的欄位有助於我們的伺服器節省運算週期,讓我們以更短的延遲時間將結果傳回給您。
  • 僅選取實際工作環境工作中所需的欄位,可確保延遲時間保持穩定。我們日後可能會新增更多回應欄位,且這些新欄位可能需要額外的計算時間。如果您選取所有欄位,或是選取頂層的所有欄位,則可能會出現成效降低的情況,因為我們新增的所有欄位都會自動納入回應中。
  • 如果只選取您需要的欄位,回應大小會縮減,網路處理量也會因此增加。
授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

詳情請參閱 OAuth 2.0 總覽

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 不建議您使用萬用字元 (*) 回應欄位遮罩,原因如下:

  • 只選取您需要的欄位有助於我們的伺服器節省運算週期,讓我們以更短的延遲時間將結果傳回給您。
  • 僅選取實際工作環境工作中所需的欄位,可確保延遲時間保持穩定。我們日後可能會新增更多回應欄位,且這些新欄位可能需要額外的計算時間。如果您選取所有欄位,或是選取頂層的所有欄位,則可能會出現成效降低的情況,因為我們新增的所有欄位都會自動納入回應中。
  • 如果只選取您需要的欄位,回應大小會縮減,網路處理量也會因此增加。
授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

詳情請參閱 OAuth 2.0 總覽

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) 指定欄位遮罩,原因如下:

  • 只選取您需要的欄位有助於我們的伺服器節省運算週期,讓我們以更短的延遲時間將結果傳回給您。
  • 僅選取實際工作環境工作中所需的欄位,可確保延遲時間保持穩定。我們日後可能會新增更多回應欄位,且這些新欄位可能需要額外的計算時間。如果您選取所有欄位,或是選取頂層的所有欄位,則可能會出現成效降低的情況,因為我們新增的所有欄位都會自動納入回應中。
  • 如果只選取您需要的欄位,回應大小會縮減,網路處理量也會因此增加。
授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

詳情請參閱 OAuth 2.0 總覽

ComputeCustomRoutesRequest

ComputeCustomRoutes 要求訊息。

欄位
origin

Waypoint

必要欄位。來源路線控點。

destination

Waypoint

必要欄位。目的地路線控點。

intermediates[]

Waypoint

選用設定。沿途一組路線控點 (不含終點站),用來在 或 經過。最多支援 25 個中繼路線控點。

travel_mode

RouteTravelMode

選用設定。指定交通方式,目前僅支援「DRIVE」。

routing_preference

RoutingPreference

選用設定。指定如何計算路徑。伺服器會嘗試使用所選轉送偏好設定來計算路徑。如果轉送偏好設定導致錯誤或過長的延遲時間,則會傳回錯誤。日後如果偏好的選項無法提供有效結果,我們可能會導入備用機制,以便使用其他選項。只有在 travel_modeDRIVETWO_WHEELER 時,您才能指定此選項,否則要求會失敗。

polyline_quality

PolylineQuality

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

polyline_encoding

PolylineEncoding

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

departure_time

Timestamp

選用設定。出發時間。如未設定這個值,則這個值會預設為您提出要求的時間。如果將這個值設為已發生的時間,要求就會失敗。

route_modifiers

RouteModifiers

選用設定。一組滿足條件,這些條件會影響路線的計算方式。

route_objective

RouteObjective

必要欄位。要最佳化的路徑目標。

language_code

string

選用設定。BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如需支援的語言清單,請參閱語言支援。如未提供這個值,系統會根據路線要求的位置推斷顯示語言。

units

Units

選用設定。指定顯示欄位的測量單位。這包括 NavigationInstruction 中的 instruction 欄位。路線、路段、步數和所需時間的測量單位不受這個值影響。如未提供這個值,系統會根據要求的位置推斷顯示單位。

ComputeCustomRoutesResponse

ComputeCustomRoutes 回應訊息。

欄位
routes[]

CustomRoute

輸入路徑目標的「最佳」路徑。

fastest_route

CustomRoute

最快參考路徑。

shortest_route

CustomRoute

最短的參照路徑。

fallback_info

FallbackInfo

自訂路徑的備用資訊。

FallbackInfo

封裝 ComputeCustomRoutes 的備用資訊。ComputeCustomRoutes 會執行兩種備用類型:

  1. 如果這項服務無法使用客戶要求的 route_preference 計算路徑,就會改回採用其他轉送模式。在這種情況下,faback_routing_mode 和轉送_mode_fallback_reason 用來傳達備用轉送模式和備用原因。

  2. 如果無法計算「最佳」可能會改回其他目標的路徑Fallback_route_objective 用於傳達備用路徑目標。

欄位
routing_mode

FallbackRoutingMode

回應使用的轉送模式。如果觸發備用廣告,模式可能會與原始用戶端要求中設定的轉送偏好設定不同。

routing_mode_reason

FallbackReason

為何系統只使用備用回應,而非原始回應。只有在觸發備用模式並傳回備用回應的情況下,系統才會填入這個欄位。

route_objective

FallbackRouteObjective

用於回應的路徑目標。如果觸發了備用廣告,目標可能與原始用戶端要求中提供的路徑目標不同。

FallbackRouteObjective

用於回應的路徑目標。

列舉
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED 未指定備用路徑目標。
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA 如果客戶要求 RateCard,並將 include_tolls 設為 true,且 Google 沒有路線的通行費資料,API 會在不考慮付費費的情況下將價格資料改回 RateCard。

ComputeRouteMatrixRequest

ComputeRouteMatrix 要求訊息

欄位
origins[]

RouteMatrixOrigin

必要欄位。來源陣列,用於決定回應矩陣的資料列。以下幾項大小限制適用於起點和目的地的基數:

  • 無論如何,元素 (起點 × 目的地) 數量不得超過 625 個。
  • 如果將 route_preference 設為 TRAFFIC_AWARE_OPTIMAL,元素 (起點 × 目的地) 數不得超過 100。
  • 指定為 place_id 的路線控點數量 (起點 + 目的地) 不得超過 50 個。
destinations[]

RouteMatrixDestination

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

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

選用設定。指定如何計算路徑。伺服器會嘗試使用所選轉送偏好設定來計算路徑。如果轉送偏好設定導致錯誤或過長延遲,則會傳回錯誤。日後如果偏好的選項無法提供有效結果,我們可能會導入備用機制,以便使用其他選項。只有在 travel_modeDRIVETWO_WHEELER 時,您才能指定此選項,否則要求會失敗。

departure_time

Timestamp

選用設定。出發時間。如未設定這個值,系統會使用您提出要求的時間。如果將這個值設為已經發生的時間,要求就會失敗。

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

選用設定。出發時間。如未設定這個值,則這個值會預設為您提出要求的時間。如果將這個值設為已發生的時間,要求就會失敗。

compute_alternative_routes

bool

指定是否要計算路線以外的替代路徑。

route_modifiers

RouteModifiers

選用設定。一組滿足條件,這些條件會影響路線的計算方式。

language_code

string

選用設定。BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如需支援的語言清單,請參閱語言支援。如未提供這個值,系統會根據路線要求的位置推斷顯示語言。

units

Units

選用設定。指定顯示欄位的測量單位。這包括 NavigationInstruction 中的 instruction 欄位。路線、路段、步數和所需時間的測量單位不受這個值影響。如未提供這個值,系統會根據要求的位置推斷顯示單位。

optimize_waypoint_order

bool

如果 optWaypointOrder 設定為 true,系統會嘗試重新排序指定的中間路點,盡可能降低路線的整體成本。如果有任何中繼路點是透過路線控點傳送,要求就會失敗。使用 ComputeRoutesResponse.Routes.optimized_中間_waypoint_index 尋找新的排序方式。如果 X-Goog-FieldMask 標頭未要求 route.optimized_中繼_waypoint_index ,要求失敗。如果將 optWaypointOrder 設為 false,ComputeRoutesResponse.optimized_中繼_waypoint_index 為空白。

ComputeRoutesResponse

ComputeRoute 會回應回應訊息。

欄位
routes[]

Route

包含指定 compute_alternatives_routes 時,包含的計算路徑陣列 (最多三個),且在不需要時只會包含一個路徑。如果這個陣列包含多個項目,則第一項是最建議的路線。如果陣列空白,表示找不到路線。

fallback_info

FallbackInfo

在某些情況下,當伺服器無法根據所有輸入偏好設定計算路線結果時,可能會改回使用其他運算方式。使用備用模式時,這個欄位會包含備用回應的詳細資訊。否則,系統會取消設定這個欄位。

CustomRoute

封裝自訂路徑 (根據客戶指定的路徑目標計算)。CustomRoute 包含路徑和路徑符記,可將該符記傳遞至 NavSDK,用於重建即時路線導航的自訂路徑。

欄位
route

Route

這條路線被視為「最佳」做為輸入路徑目標的向量

token

string

可傳遞至 NavSDK 的 Web 安全 Base64 編碼路徑符記,讓 NavSDK 在導航期間重建路徑,並在呼叫 RoutesPreferred ComputeCustomRoutes 時,重新轉送原始意圖。客戶應將此權杖視為不透明 blob。

FallbackInfo

有關使用備用結果的方式和原因的相關資訊。如果設定了這個欄位,伺服器就會使用偏好模式以外的路線做為備用模式。

欄位
routing_mode

FallbackRoutingMode

回應使用的轉送模式。如果觸發備用廣告,模式可能會與原始用戶端要求中設定的轉送偏好設定不同。

reason

FallbackReason

為何系統只使用備用回應,而非原始回應。只有在觸發備用模式並傳回備用回應的情況下,系統才會填入這個欄位。

FallbackReason

使用備用回應的原因。

列舉
FALLBACK_REASON_UNSPECIFIED 未指定備用原因。
SERVER_ERROR 以您偏好的轉送模式計算路線時發生伺服器錯誤,但我們能夠傳回其他模式計算的結果。
LATENCY_EXCEEDED 我們無法按照你偏好的路線模式準時完成計算,但我們可以傳回透過其他模式計算的結果。

FallbackRoutingMode

用於傳回的備用回應的實際轉送模式。

列舉
FALLBACK_ROUTING_MODE_UNSPECIFIED 未使用。
FALLBACK_TRAFFIC_UNAWARE 表示「TRAFFIC_UNAWARE」轉送模式用於計算回應
FALLBACK_TRAFFIC_AWARE 表示「TRAFFIC_AWARE」轉送模式用於計算回應

位置

包含位置 (地理位置和選用標題)。

欄位
lat_lng

LatLng

路線控點的地理座標。

heading

Int32Value

與車流方向相關聯的指南針方向。這個值是用於指定道路的邊,供上車和下車地點使用。標題值可以介於 0 到 360 之間,其中 0 指定截止日期的方向,90 則指定向東方向的方向,依此類推。這個欄位僅適用於 DRIVETWO_WHEELER 交通方式。

製造

一組值,用於指定目前步驟要採取的瀏覽動作 (例如向左轉、合併、直線等)。

列舉
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 在圓環處右轉。
欄位
maneuver

Maneuver

封裝目前步驟的導航指示 (例如向左轉、合併、直線等)。這個欄位會決定要顯示的圖示。

instructions

string

瀏覽此步驟的操作說明。

折線

封裝編碼折線。

欄位
聯集欄位 polyline_type。封裝折線的類型。預設為 encoded_polyline。polyline_type 只能是下列其中一項:
encoded_polyline

string

使用折線編碼演算法的折線字串編碼

geo_json_linestring

Struct

使用 GeoJSON LineString 格式指定折線

PolylineEncoding

指定要傳回的折線類型。

列舉
POLYLINE_ENCODING_UNSPECIFIED 未指定折線類型偏好設定。預設值為 ENCODED_POLYLINE
ENCODED_POLYLINE 指定使用折線編碼演算法編碼的折線。
GEO_JSON_LINESTRING 使用 GeoJSON LineString 格式指定折線

PolylineQuality

一組指定折線品質的值。

列舉
POLYLINE_QUALITY_UNSPECIFIED 未指定折線品質偏好設定。預設值為 OVERVIEW
HIGH_QUALITY 指定高品質的折線 (使用超過 OVERVIEW 個點組成),但會增加回應大小。如果您需要更準確的精確度,請使用這個值。
OVERVIEW 指定總覽折線 - 由少量的點組成。顯示路線總覽時,請使用這個值。與使用 HIGH_QUALITY 選項相比,使用這個選項的要求延遲時間較短。

路線

包含路線,其中包含一系列連接起點、終點和中間路線控點的相連路段。

欄位
legs[]

RouteLeg

組成路線的航段 (路線控點之間的路徑區段)。每個路段皆對應至兩個非 via 路線控點之間的行程。舉例來說,沒有中繼路線控點的路線只有一個路段。路線若包含一個非 via 的中繼路線控點,則有兩個路段。包含一個 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

如果 ComputeRoutesRequest.optimize_waypoint_order 設為 true,這個欄位會包含最佳化中繼路線控點的最佳化順序。如果沒有,則這個欄位會留空。舉例來說,假設輸入內容為 Origin: LA;中級:達拉斯、邦哥爾、鳳凰城;目的地:紐約;而最佳化的中繼路線控點順序為:鳳凰城、達拉斯、Bangor。然後,這個欄位會包含 [2, 0, 1] 值。第一個中繼路線控點的索引從 0 開始。

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

封裝需告知使用者的其他資訊,例如路線路段上可能的交通區域限制等。

RouteLegStep

封裝 RouteLeg 的區段。步驟對應單一導覽指示。路線路段包含步數。

欄位
distance_meters

int32

這個步驟的移動距離 (以公尺為單位)。在某些情況下,這個欄位可能沒有值。

static_duration

Duration

在不考量路況的情況下,通過此步驟所需的時間。在某些情況下,這個欄位可能沒有值。

polyline

Polyline

與這個步驟相關聯的折線。

start_location

Location

這個步驟的開始位置。

end_location

Location

這個步驟的結束位置。

navigation_instruction

NavigationInstruction

導航指示。

travel_advisory

RouteLegStepTravelAdvisory

封裝應告知使用者的其他相關資訊,例如腿部步驟可能出現的交通區域限制。

RouteLegStepTravelAdvisory

封裝應告知使用者的其他相關資訊,例如腿部步驟可能出現的交通區域限制。

欄位
speed_reading_intervals[]

SpeedReadingInterval

速度讀取間隔,詳細說明交通密度。適用於 TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL 轉送偏好設定時段涵蓋 RouteLegStep 的完整折線,但不重疊。指定間隔的開始時間與前一個間隔的端點相同。

範例:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteLegTravelAdvisory

封裝需告知使用者的其他資訊,例如路線路段上可能的交通區域限制等。

欄位
toll_info

TollInfo

封裝特定 RouteLeg 上收費路段的資訊。這個欄位只有在 RouteLeg 上會有收費站時,才會填入這個欄位。如果已設定這個欄位,但未填入預估_price 子欄位,系統則會預期道路含有收費路段,但不會知道預估價格。如果沒有這個欄位,RouteLeg 上就不會有任何收費站。

speed_reading_intervals[]

SpeedReadingInterval

速度讀取間隔,詳細說明交通密度。適用於 TRAFFIC_AWARETRAFFIC_AWARE_OPTIMAL 轉送偏好設定間隔會涵蓋 RouteLg 的整條折線沒有重疊。指定間隔的開始時間與前一個間隔的端點相同。

範例:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

ComputeRouteMatrixRequest 的單一目的地

欄位
waypoint

Waypoint

必要欄位。目的地路線控點

RouteMatrixElement

封裝在 ComputeRouteMatrix API 中針對起點/目的地組合計算出的路線資訊。此原型可以串流至用戶端。

欄位
origin_index

int32

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

destination_index

int32

要求中的目的地索引為零的索引。

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

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

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

指定是否要在合理情況下避開收費道路。系統會優先遵循不含收費路段的路線。僅適用於 DRIVETWO_WHEELER 交通方式。

avoid_highways

bool

指定是否要在合理情況下避開高速公路。針對不含高速公路的路線,我們會優先處理。僅適用於 DRIVETWO_WHEELER 交通方式。

avoid_ferries

bool

指定是否要在合理情況下避開渡輪。針對不含渡輪的行經路線,系統會優先採用。僅適用於DRIVETWO_WHEELER交通方式。

avoid_indoor

bool

指定是否要避免在合理範圍內導航。系統會優先採用不含室內導航的路線。僅適用於 WALK 交通方式。

vehicle_info

VehicleInfo

指定車輛資訊。

toll_passes[]

TollPass

封裝過路通行證的相關資訊。如有提供收費通行證,API 會嘗試傳回票證價格。如未提供收費通行證,API 會將收費通行證視為未知,並嘗試傳回現金價格。僅適用於「DRIVE」和「TWO_WHEELER」交通方式。

RouteObjective

封裝用於 ComputeCustomRoutes 最佳化的目標。

欄位
rate_card

RateCard

價目表目標。

RateCard

封裝 RateCard 路徑目標。

欄位
cost_per_minute

MonetaryCost

選用設定。每分鐘費用。

cost_per_km

MonetaryCost

選用設定。每公里費用

include_tolls

bool

選用設定。是否在整體費用中納入過路費。

MonetaryCost

封裝價目表中的使用費用。

欄位
value

double

必要欄位。從要求中推測的當地幣別費用值。

RouteTravelAdvisory

封裝使用者應知的其他資訊,例如可能的交通區域限制等。

欄位
toll_info

TollInfo

封裝路線上收費路段的相關資訊。這個欄位只有在預期路線上設有交通事故時,才會填入此欄位。如果已設定這個欄位,但未填入預估_price 子欄位,系統則會預期道路含有收費路段,但不會知道預估價格。如未設定這個欄位,路線上就不會有路人。

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

RouteTravelMode

一組值,用來指定交通方式。

列舉
TRAVEL_MODE_UNSPECIFIED 未指定交通方式。預設值為 DRIVE
DRIVE 提供乘客汽車。
BICYCLE 騎單車旅遊。
WALK 而且是步行前往。
TWO_WHEELER 雙輪機動車輛。例如機車。請注意,這與涵蓋人機模式的 BICYCLE 交通模式不同。
TAXI

搭乘領有執照的計程車前往部分區域的指定計程車車道。

TAXI 模式是一項實驗功能。如果客戶要求在無法取得計程車車道資料的城市中規劃 TAXI 路線,會傳回「DRIVE」路線。

RoutingPreference

一組值,指定計算路線時要考量的因素。

列舉
ROUTING_PREFERENCE_UNSPECIFIED 未指定轉送偏好設定。預設值為 TRAFFIC_AWARE
TRAFFIC_UNAWARE 計算路線,但不考量路況。適用於不重要路況的時段。使用這個值會產生最低延遲時間。
TRAFFIC_AWARE 計算將路況納入考量的路線。相較於 TRAFFIC_AWARE_OPTIMAL,某些最佳化作業可大幅縮短延遲時間。
TRAFFIC_AWARE_OPTIMAL 計算將路況納入考量的路線,但不套用大多數效能最佳化設定。使用這個值會產生最長延遲時間。

SpeedReadingInterval

折線或路徑連續段上的交通密度指標。如果路徑包含點 P_0、P_1、...、P_N (以零為基礎的索引),則 SpeedReadingInterval 會定義間隔,並使用以下類別描述流量。

欄位
start_polyline_point_index

int32

這個間隔在折線中的起始索引。在 JSON 中,當索引為 0 時,該欄位似乎未填入內容。

end_polyline_point_index

int32

折線中這個間隔的結束索引。在 JSON 中,當索引為 0 時,該欄位似乎未填入內容。

speed

Speed

這段時間的車流速度。

速度

根據路況資料顯示的折線速度分類。

列舉
SPEED_UNSPECIFIED 預設值。這個值未使用。
NORMAL 速度正常,未偵測到車多擁擠情形。
SLOW 偵測到車多擁擠情形,但並未形成交通壅塞。
TRAFFIC_JAM 偵測到交通壅塞。

TollInfo

RouteRouteLeg 上封裝過路資訊。

欄位
estimated_price[]

Money

對應路線或 RouteLeg 的收費金額。這份清單包含收費站預計需要用到的各種幣別的相應金額。一般來說,這份清單只包含一個貨幣的收費路線。如果是國外旅遊,這份清單可能包含多項以不同幣別計算的收費項目。

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 州級車牌豁免。
MX_TAG_IAVE 墨西哥通行費。
MX_TAG_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 美國科羅拉多州
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 美國堪薩斯州。
US_KS_KTAG 美國堪薩斯州。
US_KS_NATIONALPASS 美國堪薩斯州。
US_KS_PREPASS_ELITEPASS 美國堪薩斯州。
US_LA_GEAUXPASS 美國洛杉磯
US_LA_TOLL_TAG 美國洛杉磯
US_MA_EZPASSMA 美國麻薩諸塞州
US_MD_EZPASSMD 美國馬裡蘭州
US_ME_EZPASSME 美國緬因州
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD 美國密西根州
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG 美國密西根州
US_MI_IQ_PROX_CARD 美國密西根州
US_MI_MACKINAC_BRIDGE_MAC_PASS 美國密西根州
US_MI_NEXPRESS_TOLL 美國密西根州
US_MN_EZPASSMN MN、美國。
US_NC_EZPASSNC 美國北卡羅來納州
US_NC_PEACH_PASS 美國北卡羅來納州
US_NC_QUICK_PASS 美國北卡羅來納州
US_NH_EZPASSNH 美國新罕布夏,
US_NJ_DOWNBEACH_EXPRESS_PASS 美國紐澤西州。
US_NJ_EZPASSNJ 美國紐澤西州。
US_NY_EXPRESSPASS 美國紐約
US_NY_EZPASSNY 美國紐約
US_OH_EZPASSOH 美國俄亥俄州。
US_PA_EZPASSPA 美國賓州
US_RI_EZPASSRI 美國羅裡,
US_SC_PALPASS 美國卡羅來納
US_TX_BANCPASS 美國德克薩斯州
US_TX_DEL_RIO_PASS 美國德克薩斯州
US_TX_EFAST_PASS 美國德克薩斯州
US_TX_EAGLE_PASS_EXPRESS_CARD 美國德克薩斯州
US_TX_EPTOLL 美國德克薩斯州
US_TX_EZ_CROSS 美國德克薩斯州
US_TX_EZTAG 美國德克薩斯州
US_TX_LAREDO_TRADE_TAG 美國德克薩斯州
US_TX_PLUSPASS 美國德克薩斯州
US_TX_TOLLTAG 美國德克薩斯州
US_TX_TXTAG 美國德克薩斯州
US_TX_XPRESS_CARD 美國德克薩斯州
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD 美國猶他州
US_VA_EZPASSVA 美國維吉尼亞州
US_WA_BREEZEBY 美國華盛頓州
US_WA_GOOD_TO_GO 美國華盛頓州
US_WV_EZPASSWV 美國西維吉尼亞州
US_WV_MEMORIAL_BRIDGE_TICKETS 美國西維吉尼亞州
US_WV_NEWELL_TOLL_BRIDGE_TICKET 美國西維吉尼亞州

單位

一組值,用於指定顯示畫面使用的測量單位。

列舉
UNITS_UNSPECIFIED 未指定測量單位。預設為從要求推斷的測量單位。
METRIC 指標測量單位。
IMPERIAL 英制測量單位。

VehicleEmissionType

一組說明車輛排放類型的值。僅適用於「驅動」交通方式。

列舉
VEHICLE_EMISSION_TYPE_UNSPECIFIED 未指定排放類型,預設為 GASOLINE。
GASOLINE 汽油/汽油動力車輛。
ELECTRIC 電動車。
HYBRID 油電混合車 (例如汽油 + 電動車)。

VehicleInfo

封裝車輛資訊,例如車牌的最後一個字元。

欄位
emission_type

VehicleEmissionType

說明車輛的排放類型。僅適用於「驅動」交通方式。

途經點

封裝路線控點。路線控點會標記路線的起點和終點,並在路線沿途包含中繼停靠站。

欄位
via

bool

將這個路線控點標示為里程碑,而不是停靠點。對於要求中的每個非透過路線控點,回應會在 legs 陣列中附加一個項目,提供行程中該路段的停靠站詳細資料。如果您想讓路線經過這個路線點而不停靠,請將這個值設為 true。透過路線控點,系統不會將項目加入 legs 陣列,但會讓路線經過路線控點。您只能在為中繼的路線控點設定此值。如果您在終端路線控點設定這個欄位,要求就會失敗。如果 ComputeRoutesRequest.optimize_waypoint_order 設為 true,這個欄位就無法設為 true;否則要求失敗。

vehicle_stopover

bool

表示路線控點是供車輛停靠,主要目的是讓使用者在上車或下車。設定這個值後,如果不適合上車和下車的道路,計算的路線就不會包含非 via 路線控點。這個選項僅適用於 DRIVETWO_WHEELER 交通方式,以及 location_typelocation 的情況。

side_of_road

bool

表示這個路線控點的位置是用來指定車輛在特定側面停靠的位置。設定這個值後,路線就會通過位置,這樣車輛就能在道路側停靠,該位置是從道路中心偏離位置。這個選項僅適用於「DRIVE」和「TWO_WHEELER」交通方式,而「location_type」的值已設為「location」。

聯集欄位 location_type。以不同方式表示地點。location_type 只能是下列其中一項:
location

Location

使用地理座標指定的點,包含選擇性的方向。

place_id

string

與路線控點相關聯的搜尋點地點 ID。