指數
Routes
(介面)ComputeRouteMatrixRequest
(訊息)ComputeRouteMatrixRequest.ExtraComputation
(列舉)ComputeRoutesRequest
(訊息)ComputeRoutesRequest.ExtraComputation
(列舉)ComputeRoutesRequest.ReferenceRoute
(列舉)ComputeRoutesResponse
(訊息)FallbackInfo
(訊息)FallbackReason
(列舉)FallbackRoutingMode
(列舉)GeocodedWaypoint
(訊息)GeocodingResults
(訊息)LocalizedTime
(訊息)Location
(訊息)Maneuver
(列舉)NavigationInstruction
(訊息)Polyline
(訊息)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 |
---|
擷取起點和目的地清單,並傳回包含每組起點與目的地組合的資訊。 注意:這個方法會要求您在輸入內容中指定回應欄位遮罩。如要提供回應欄位遮罩,您可以使用網址參數 例如,在這個方法中:
請務必在遮罩遮罩中納入
|
ComputeRoutes |
---|
指定一組終端機和中繼路線控點,傳回主要路線和選用的替代路線。 注意:這個方法會要求您在輸入內容中指定回應欄位遮罩。如要提供回應欄位遮罩,您可以使用網址參數 例如,在這個方法中:
Google 不建議使用萬用字元 (
|
ComputeRouteMatrixRequest
ComputeRouteMatrix 要求訊息
欄位 | |
---|---|
origins[] |
必要欄位。來源陣列,用於決定回應矩陣的資料列。起點與目的地的基數具有多種大小限制:
|
destinations[] |
必要欄位。目的地陣列,用於決定回應矩陣的資料欄。 |
travel_mode |
(選填) 指定交通方式。 |
routing_preference |
(選填) 指定路線的計算方式。伺服器會嘗試使用所選轉送偏好設定來計算路徑。如果轉送偏好設定導致錯誤或超長的延遲時間,則系統會傳回錯誤。只有在 |
departure_time |
(選填) 出發時間。如果您並未設定這個值,這個值預設為您發出請求的時間。注意:只有在 |
arrival_time |
(選填) 抵達時間。注意:只有在 |
language_code |
(選填) BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。請參閱「語言支援」部分,查看支援的語言清單。如未提供這個值,系統會從第一個來源的位置推測顯示語言。 |
region_code |
(選填) 區碼,以 ccTLD (「頂層網域」) 的兩位字元值指定詳情請參閱 https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains |
extra_computations[] |
(選填) 可能會用來完成要求的額外運算清單。注意:這些額外計算可能會傳回回應中的額外欄位。這些額外欄位也必須在回應遮罩中傳回, |
traffic_model |
(選填) 指定計算交通時間時要採用的假設。這項設定會影響 |
transit_preferences |
(選填) 指定會影響 |
額外運算
完成要求時要執行的額外運算。
列舉 | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
未使用。包含這個值的要求將會失敗。 |
TOLLS |
矩陣元素的收費資訊。 |
ComputeRoutesRequest
ComputeRoutes 要求訊息。
欄位 | |
---|---|
origin |
必要欄位。起點路線控點。 |
destination |
必要欄位。目的地路線控點。 |
intermediates[] |
(選填) 路線沿途的一組路線控點 (路線控點),可停止或通過。最多可支援 25 個中繼路線控點。 |
travel_mode |
(選填) 指定交通方式。 |
routing_preference |
(選填) 指定路線的計算方式。伺服器會嘗試使用所選轉送偏好設定來計算路徑。如果轉送偏好設定導致錯誤或超長的延遲時間,則系統會傳回錯誤。只有在 |
polyline_quality |
(選填) 指定折線品質的偏好設定。 |
polyline_encoding |
(選填) 指定折線的偏好編碼。 |
departure_time |
(選填) 出發時間。如果您並未設定這個值,這個值預設為您發出請求的時間。注意:只有在 |
arrival_time |
(選填) 抵達時間。注意:只有在 |
compute_alternative_routes |
(選填) 指定除了路線以外,是否計算替代路徑。如果要求具有中繼路線控點,就不會傳回替代路徑。 |
route_modifiers |
(選填) 滿足一組條件會影響路線的計算方式。 |
language_code |
(選填) BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。請參閱「語言支援」部分,查看支援的語言清單。如果未提供這個值,系統會根據路徑要求的位置推測顯示語言。 |
region_code |
(選填) 區碼,以 ccTLD (「頂層網域」) 的兩位字元值指定詳情請參閱 https://en.wikipedia.org/wiki/List_of_Internet_top-level_domains#Country_code_top-level_domains |
units |
(選填) 指定顯示欄位的測量單位。這些欄位包含 |
optimize_waypoint_order |
(選填) 設為 True 時,服務會重新排序指定的中繼路線控點,藉此盡量降低路線整體費用。如有任何中繼路線控點為 |
requested_reference_routes[] |
(選填) 除了預設路徑外,請指定哪些要求路徑要做為要求的一部分。參考路徑是不同於預設路徑的路徑計算路徑。舉例來說, |
extra_computations[] |
(選填) 可能會用來完成要求的額外運算清單。注意:這些額外計算可能會傳回回應中的額外欄位。這些額外欄位也必須在回應遮罩中傳回, |
traffic_model |
(選填) 指定計算交通時間時要採用的假設。這項設定會影響 |
transit_preferences |
(選填) 指定會影響 |
額外運算
完成要求時要執行的額外運算。
列舉 | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
未使用。包含這個值的要求將會失敗。 |
TOLLS |
路線的收費資訊。 |
FUEL_CONSUMPTION |
路線的燃料耗量。 |
TRAFFIC_ON_POLYLINE |
路線的封閉折線。 |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
導覽操作說明 (以格式化的 HTML 文字字串表示)。這類內容應依原樣讀取。此內容僅供顯示。請勿以程式輔助方式剖析。 |
參考路徑
ComputeRoutesRequest 支援的參考路徑。
列舉 | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
未使用。包含這個值的要求會失敗。 |
FUEL_EFFICIENT |
燃油效率。系統會為標有這個值的路徑,決定最佳參數 (例如燃料消耗量)。 |
ComputeRoutesResponse
ComputeRoute 轉送回應訊息。
欄位 | |
---|---|
routes[] |
包含指定 compute_alternatives_routes 時,包含經計算的路線陣列 (最多三個),而且即使您不使用,也只會有一個路線。如果這個陣列包含多個項目,第一個項目是建議採用的路徑。如果陣列為空白,則表示找不到路線。 |
fallback_info |
在某些情況下,如果伺服器無法根據所有輸入偏好設定來計算路線結果,則可改用其他運算方式。使用備用模式時,這個欄位會包含備用回應的詳細資訊。否則未設定這個欄位。 |
geocoding_results |
包含為地址指定的路線控點的地理編碼回應資訊。 |
備用資訊
使用備用結果的相關資訊和原因。如果設定了這個欄位,表示伺服器使用不同於偏好模式的備用模式。
欄位 | |
---|---|
routing_mode |
回應使用的轉送模式。如果觸發了備用廣告,該模式可能與原始用戶端請求中的轉送偏好設定不同。 |
reason |
使用備用回應的原因,而非原始回應。只有在觸發備用廣告模式且傳回備用廣告回應時,系統才會填入這個欄位。 |
備用原因
使用備用回應的原因。
列舉 | |
---|---|
FALLBACK_REASON_UNSPECIFIED |
未指定備用原因。 |
SERVER_ERROR |
使用您偏好的轉送模式計算路徑時發生伺服器錯誤,但我們能夠傳回替代模式計算的結果。 |
LATENCY_EXCEEDED |
我們無法及時搭配您偏好的轉送模式完成計算,但可以傳回替代模式計算出的結果。 |
備用轉送模式
傳回備用回應的實際轉送模式。
列舉 | |
---|---|
FALLBACK_ROUTING_MODE_UNSPECIFIED |
未使用。 |
FALLBACK_TRAFFIC_UNAWARE |
表示用於計算回應的 TRAFFIC_UNAWARE google.maps.routing.v2.RoutingPreference 。 |
FALLBACK_TRAFFIC_AWARE |
表示用於計算回應的 TRAFFIC_AWARE RoutingPreference 。 |
GeocodedWaypoint
路線控點用地點的詳細資料。僅填入地址路線控點。加入地理編碼結果,以便判斷地址的地理編碼方式。
欄位 | |
---|---|
geocoder_status |
指出地理編碼作業產生的狀態碼。 |
type[] |
結果的類型,包含 0 或多個類型標記。支援的類型:https://developers.google.com/maps/documentation/Geocoding/requests-Geocoding#Types |
partial_match |
指出地理編碼器沒有傳回與原始要求完全相符的結果,但可以比對部分要求的地址。建議您比對原始要求,檢查是否有拼寫錯誤和/或不完整的地址。 |
place_id |
這筆結果的地點 ID。 |
intermediate_waypoint_request_index |
要求中對應中繼路線控點的索引。只有在對應的路線控點為中繼路線控點時,才會填入這項資訊。 |
地理編碼結果
包含起點、目的地和中繼路線控點的 GeocodedWaypoints
。僅填入地址路線控點。
欄位 | |
---|---|
origin |
起點地理編碼的路線控點。 |
destination |
目的地地理編碼的路線控點。 |
intermediates[] |
中繼地理編碼路線控點清單,每個索引包含索引欄位,包含路線控點中以零為基準的座標點。 |
本地化時間
本地化時間說明。
欄位 | |
---|---|
time |
以指定時區的字串形式指定的時間。 |
time_zone |
包含時區。這個值是時區名稱 (如 IANA 時區資料庫中所定義),例如「America/New_York」。 |
位置
封裝位置 (地理位置點和選用的標題)。
欄位 | |
---|---|
lat_lng |
路線控點的地理座標。 |
heading |
與車流方向相關的指南針方向。這個值會指定上車地點和下車地點。下車方向值可介於 0 到 360 之間,其中 0 代表偏離北方,90 代表正指定正向的方向,依此類推。這個欄位僅適用於 |
曼努弗
一組值,用來指定目前步驟要執行的導覽動作 (例如左、合併、直接等)。
列舉 | |
---|---|
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 |
用於表示街道名稱變更。 |
Polyline
封裝經過編碼的折線。
欄位 | |
---|---|
聯集欄位 polyline_type 。封裝折線類型。預設為 encoded_polyline。polyline_type 只能是下列其中一項: |
|
encoded_polyline |
使用折線編碼演算法折線的字串編碼 |
geo_json_linestring |
使用 GeoJSON LineString 格式指定折線 |
折線編碼
指定要傳回的折線類型。
列舉 | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
未指定折線類型偏好設定。預設值為 ENCODED_POLYLINE 。 |
ENCODED_POLYLINE |
使用折線編碼演算法指定折線。 |
GEO_JSON_LINESTRING |
使用 GeoJSON LineString 格式指定折線 |
折線品質
指定折線品質的一組值。
列舉 | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
未指定折線品質偏好設定。預設值為 OVERVIEW 。 |
HIGH_QUALITY |
指定高品質折線 (使用超過 OVERVIEW 點的點),但回應大小會增加。如果需要更高的精確度,請使用這個值。 |
OVERVIEW |
指定總覽折線,使用少量點組成。顯示路徑總覽時,請使用這個值。相較於使用 HIGH_QUALITY 選項,使用這個選項會使要求延遲時間更短。 |
路線
包含一條路線,由一系列相連接的路段,包括起點、終點和中繼路線控點。
欄位 | |
---|---|
route_labels[] |
|
legs[] |
組成路線的一組路段 (路線控點之間的路徑區隔)。每個路段都會對應到兩個非 |
distance_meters |
路線的移動距離 (以公尺為單位)。 |
duration |
路線導航所需時間。如果將 |
static_duration |
行駛期間經過的路線,不考量路況。 |
polyline |
整體路線折線。這條折線是所有 |
description |
路線的說明。 |
warnings[] |
顯示路線時顯示的警告陣列。 |
viewport |
折線的可視區域邊界。 |
travel_advisory |
路線的其他資訊。 |
optimized_intermediate_waypoint_index[] |
如果將 |
localized_values |
|
route_token |
網頁式 Base64 編碼路徑權杖,可傳遞至 Navigation SDK,讓 Navigation SDK 在導航期間重新建構路徑,而且在重新轉送路徑時,則藉由呼叫 ComputeRoutes 來遵循原始意圖。客戶應將這組權杖視為不透明的 blob。本功能並不適合讀取或變動。注意: |
RouteLocalizedValues (路徑本地化值)
特定屬性的文字表示法。
欄位 | |
---|---|
distance |
以文字形式呈現的移動距離。 |
duration |
將路況納入考量的時間,以文字形式顯示。注意事項:如未要求流量資訊,這個值會與 static_duration 值相同。 |
static_duration |
將流量納入考量,並以文字形式表示。 |
transit_fare |
以文字表示的大眾運輸車資。 |
路徑標籤
Route
的標籤有助於識別路線的特定屬性,以與其他屬性比較。
列舉 | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
預設 - 未使用。 |
DEFAULT_ROUTE |
用於計算路徑的預設「最佳」路徑。 |
DEFAULT_ROUTE_ALTERNATE |
預設的「最佳」路線的替代選項。指定 compute_alternative_routes 時,將傳回這類路線。 |
FUEL_EFFICIENT |
燃油效率。系統會為標有這個值的路徑,判斷是否要針對燃料消耗量 (例如燃料消耗量) 進行最佳化。 |
路徑規劃
包含非 via
路線控點之間的區隔。
欄位 | |
---|---|
distance_meters |
路線路段的移動距離 (以公尺為單位)。 |
duration |
導航路段需要的時間長度。如果 |
static_duration |
腿部行經的交通時間,不將路況納入考量。 |
polyline |
這個路段的整體折線,包含每個 |
start_location |
這個路段的起點。這個位置可能與提供的 |
end_location |
這個路段的終點。這個位置可能與提供的 |
steps[] |
指定這個路段中路段的陣列。每個步驟都代表一項操作指示。 |
travel_advisory |
包含應告知使用者額外的資訊,例如路線路段上的可能車流量限制。 |
localized_values |
|
steps_overview |
這個 |
RouteLegLocalizedValues
特定屬性的文字表示法。
欄位 | |
---|---|
distance |
以文字形式呈現的移動距離。 |
duration |
將路況考慮到文字的時間長度,以文字形式呈現。注意事項:如未要求流量資訊,這個值會與 static_duration 值相同。 |
static_duration |
將流量納入考量,並以文字形式表示。 |
步驟總覽
提供 RouteLegStep
清單的總覽資訊。
欄位 | |
---|---|
multi_modal_segments[] |
關於 |
多模組區隔
提供 RouteLeg.steps
各種多重模組區隔的摘要資訊。多重模組區隔是指具有相同 RouteTravelMode
的一或多個連續 RouteLegStep
。如果步驟中有任何 RouteLeg
未包含任何多重模組區隔,則系統不會填入這個欄位。
欄位 | |
---|---|
navigation_instruction |
多重模組區隔的 NavigationInstruction。 |
travel_mode |
多重模組區隔的交通方式。 |
step_start_index |
多重模組區隔開始時的對應 |
step_end_index |
多重模組區隔結尾的對應 |
路線規劃步驟
包含 RouteLeg
的區隔。一個步驟可對應單一導航指示。路線路段由步數組成。
欄位 | |
---|---|
distance_meters |
這個步驟的移動距離 (以公尺為單位)。在某些情況下,這個欄位可能沒有值。 |
static_duration |
執行此步驟時,系統未將路況納入考量。在某些情況下,這個欄位可能沒有值。 |
polyline |
與這個步驟相關聯的折線。 |
start_location |
這個步驟的起點。 |
end_location |
這個步驟的終點。 |
navigation_instruction |
導航指示。 |
travel_advisory |
包含使用者應瞭解的其他資訊,例如可能的交通區域限制。 |
localized_values |
|
transit_details |
如果交通模式為 |
travel_mode |
這個步驟使用的交通方式。 |
RouteLegStepLocalizedValues
特定屬性的文字表示法。
欄位 | |
---|---|
distance |
以文字形式呈現的移動距離。 |
static_duration |
將流量納入考量,並以文字形式表示。 |
RouteLegStepTransitDetails
與TRANSIT
路徑相關的RouteLegStep
額外資訊。
欄位 | |
---|---|
stop_details |
步驟的抵達和出發站相關資訊。 |
localized_values |
|
headsign |
指定這條路線的行進方向,如車輛或出發站上標示的方向。路線通常是終點站。 |
headway |
指定從目前同一站點出發的預計間隔時間。比方說,如果某班車的門牌值為 600,則表示如果錯過上一班公車,下一班預計要等 10 分鐘。 |
transit_line |
這個步驟中使用的大眾運輸路線相關資訊。 |
stop_count |
從出發站到抵達站的停靠站數。這項數據包含抵達站,但不包含出發站。舉例來說,如果您的路線從 A 站出發,途經 B、C 兩站,最後抵達 D 站,停靠站就會傳回 3。 |
trip_short_text |
顯示在時間表和看板上的文字,用於識別乘客的大眾運輸行程。文字都應該在服務日內明確識別行程。例如,「538」是 Amtrak 火車的 |
TransitDetailsLocalizedValues
RouteTransitDetails 的本地化值說明。
欄位 | |
---|---|
arrival_time |
格式化文字格式的時間與對應的時區。 |
departure_time |
格式化文字格式的時間與對應的時區。 |
TransitStopDetails
RouteLegStep
的大眾運輸站點詳細資訊
欄位 | |
---|---|
arrival_stop |
步驟的抵達站點相關資訊。 |
arrival_time |
步數的預計抵達時間。 |
departure_stop |
步驟的出發站相關資訊。 |
departure_time |
步驟的預計出發時間。 |
RouteLegStepTravelAdvisory
列出應告知使用者的相關資訊,例如路段步驟可能的車流量限制。
欄位 | |
---|---|
speed_reading_intervals[] |
注意:這個欄位目前未填入資料。 |
RouteLegTravelAdvisory
包含使用者將在路段步驟中取得的額外資訊,例如可能的交通區域限制。
欄位 | |
---|---|
toll_info |
包含特定 |
speed_reading_intervals[] |
用於讀取流量密度的讀取速度間隔。適用於 例子:
|
RouteMatrixDestination
ComputeRouteMatrixRequest 的單一目的地
欄位 | |
---|---|
waypoint |
必要欄位。目的地路線控點 |
RouteMatrixElement
包含根據 ComputeRouteMatrix API 中起點/目的地組合計算出的路線資訊。這個 proto 可以串流至用戶端。
欄位 | |
---|---|
status |
這個元素的錯誤狀態碼。 |
condition |
指出路線是否找到。不受狀態影響。 |
distance_meters |
路線的移動距離 (以公尺為單位)。 |
duration |
路線導航所需時間。如果將 |
static_duration |
行駛期間經過路線,不考量路況。 |
travel_advisory |
路線的其他資訊。例如:限制資訊和付費資訊 |
fallback_info |
在某些情況下,如果伺服器無法使用這個特定起點/目的地組合的指定值計算路線,就會改回使用其他運算模式。使用備用模式時,這個欄位會包含備用回應的詳細資訊。否則未設定這個欄位。 |
localized_values |
|
origin_index |
要求中的起點 (從零開始)。 |
destination_index |
要求中目的地的零索引索引。 |
本地化值
特定屬性的文字表示法。
欄位 | |
---|---|
distance |
以文字形式呈現的移動距離。 |
duration |
以文字形式呈現的時間長度,會將路況納入考量。注意:如未要求流量資訊,這個值會與 static_duration 值相同。 |
static_duration |
以文字形式呈現的時間長度,但不會將路況納入考量。 |
transit_fare |
以文字表示的大眾運輸車資。 |
RouteMatrixElementCondition
傳迴路徑的條件。
列舉 | |
---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED |
僅用於元素的 status 時。 |
ROUTE_EXISTS |
找到路線,系統就會為該元素填入對應的資訊。 |
ROUTE_NOT_FOUND |
找不到路線。系統不會在元素中填入包含路線資訊的欄位 (例如 distance_meters 或 duration )。 |
RouteMatrixOrigin
ComputeRouteMatrixRequest 的單一來源
欄位 | |
---|---|
waypoint |
必要欄位。起點路線控點 |
route_modifiers |
(選填) 每個路徑都會做為起點,用來當做起點 |
RouteModifiers
封裝計算路徑時會用到的一組選用條件。
欄位 | |
---|---|
avoid_tolls |
設為 true 時,盡量避開收費路段,並優先顯示不含道路收費的路線。僅適用於 |
avoid_highways |
設為 true 時,盡量避免採用高速公路,並優先顯示不含高速公路的路線。僅適用於 |
avoid_ferries |
設為 true 時,盡量避免搭乘渡輪,因此偏好優先處理不含渡輪的路線。僅適用於 |
avoid_indoor |
設為 true 時,請盡量避免在室內瀏覽導航,且將路線優先於沒有室內導航的路徑。僅適用於 |
vehicle_info |
指定車輛資訊。 |
toll_passes[] |
封裝收費路段相關資訊。如果提供了收費路段,API 會嘗試傳回票證價格。如未提供收費路段,API 會將收費路段視為不明狀態,並嘗試傳回現金價格。僅適用於 |
RouteTravelAdvisory
提供使用者應瞭解的其他資訊,例如可能的流量區限制。
欄位 | |
---|---|
toll_info |
包含路線上的收費路段資訊。只有在路線上有收費路段時,才會填入這個欄位。如果設定了這個欄位,但系統未填寫估計價格子欄位,那麼路線就會包含收費路段,但預估價格不明。如果不設定這個欄位,路線上就不會出現收費路段。 |
speed_reading_intervals[] |
用於讀取流量密度的讀取速度間隔。適用於 例子:
|
fuel_consumption_microliters |
預測的燃料消耗量 (以百萬分之一為單位)。 |
route_restrictions_partially_ignored |
傳回的路線可能因為要求的交通方式或路線修飾符而不適用。 |
transit_fare |
如果有的話,包含這條路線的總車資或車票費。系統只會針對 |
路徑旅遊模式
用來指定交通方式的一組值。注意:WALK
、BICYCLE
和 TWO_WHEELER
路線目前仍為 Beta 版,有時可能會缺少明確的人行道、人行道或單車道。您必須針對向使用者顯示的所有步行、單車和機車路線,向使用者顯示這則警告。
列舉 | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
未指定交通方式。預設值為 DRIVE 。 |
DRIVE |
旅客搭乘的車輛。 |
BICYCLE |
騎單車。 |
WALK |
散步, |
TWO_WHEELER |
雙輪驅動車輛。例如摩托車。請注意,這與採用人體模式的 BICYCLE 交通方式不同。 |
TRANSIT |
根據大眾運輸路線 (如有) 搭乘大眾運輸工具。 |
轉送偏好設定
一組值,指定計算路線時要考量的因素。
列舉 | |
---|---|
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 (零個索引),SpeedReadingInterval 會定義間隔,並使用下列類別說明流量。
欄位 | |
---|---|
start_polyline_point_index |
此間隔中的起始索引起始線。 |
end_polyline_point_index |
以折線為單位,表示這個間隔的結束索引。 |
聯集欄位
|
|
speed |
這個時間間隔內的流量速度。 |
速度
根據流量資料區分折線速度。
列舉 | |
---|---|
SPEED_UNSPECIFIED |
預設值。此值未使用。 |
NORMAL |
正常速度,不會偵測到速度變慢。 |
SLOW |
偵測到車多擁塞情形,但未發生交通壅塞情形。 |
TRAFFIC_JAM |
系統偵測到交通壅塞情形。 |
收費資訊
欄位 | |
---|---|
estimated_price[] |
相應 |
收費通行卡
我們支援的全球道路收費通行證清單。
列舉 | |
---|---|
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 |
印度商品 |
MX_IAVE |
墨西哥收費站。https://iave.capufe.gob.mx/#/ |
MX_PASE |
墨西哥 https://www.pase.com.mx |
MX_QUICKPASS |
墨西哥 https://初次 davial.com/fast-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 |
ALAL,美國。 |
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_KY_RIVERLINK |
KY,美國。 |
US_LA_GEAUXPASS |
洛杉磯,美國。 |
US_LA_TOLL_TAG |
洛杉磯,美國。 |
US_MA_EZPASSMA |
美國麻薩諸塞州 |
US_MD_EZPASSMD |
美國 MD, |
US_ME_EZPASSME |
MEA,美國。 |
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 |
美國 MN |
US_NC_EZPASSNC |
NC、美國。 |
US_NC_PEACH_PASS |
NC、美國。 |
US_NC_QUICK_PASS |
NC、美國。 |
US_NH_EZPASSNH |
美國新西蘭。 |
US_NJ_DOWNBEACH_EXPRESS_PASS |
NJ,美國。 |
US_NJ_EZPASSNJ |
NJ,美國。 |
US_NY_EXPRESSPASS |
美國紐約。 |
US_NY_EZPASSNY |
美國紐約。 |
US_OH_EZPASSOH |
美國俄亥俄州 |
US_PA_EZPASSPA |
PA、美國。 |
US_RI_EZPASSRI |
插頁式 |
US_SC_PALPASS |
南卡羅來納州, |
US_TX_AVI_TAG |
美國 TX |
US_TX_BANCPASS |
美國 TX |
US_TX_DEL_RIO_PASS |
美國 TX |
US_TX_EFAST_PASS |
美國 TX |
US_TX_EAGLE_PASS_EXPRESS_CARD |
美國 TX |
US_TX_EPTOLL |
美國 TX |
US_TX_EZ_CROSS |
美國 TX |
US_TX_EZTAG |
美國 TX |
US_TX_FUEGO_TAG |
美國 TX |
US_TX_LAREDO_TRADE_TAG |
美國 TX |
US_TX_PLUSPASS |
美國 TX |
US_TX_TOLLTAG |
美國 TX |
US_TX_TXTAG |
美國 TX |
US_TX_XPRESS_CARD |
美國 TX |
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD |
UT,美國。 |
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 |
美國維吉尼亞州 |
車流量模型
指定計算交通時間時要採用的假設。這項設定會影響回應中 duration
欄位傳回的值,其中包含根據歷來平均值預估的交通時間。
列舉 | |
---|---|
TRAFFIC_MODEL_UNSPECIFIED |
未使用。指定時,預設值為 BEST_GUESS 。 |
BEST_GUESS |
表示傳回的 duration 應是最準確的預估交通時間 (根據歷來路況和即時車流量兩者的已知相關資訊計算而得)。departure_time 距離現在的時間越近,即時車流量的影響力就越大。 |
PESSIMISTIC |
表示傳回的傳回的天多應該是大多數時間,但偶爾路況特別差時,實際交通時間可能會超過這個值。 |
OPTIMISTIC |
表示傳回的時間長度相較於大多數實際交通時間短,但偶爾路況特別好時,實際交通時間可能會短於這個值。 |
運輸公司
經營大眾運輸路線的運輸公司。
欄位 | |
---|---|
name |
這間運輸公司的名稱。 |
phone_number |
運輸公司在地區專屬的電話號碼。 |
uri |
運輸公司的 URI。 |
大眾運輸路線
包含這個步驟中使用的大眾運輸路線相關資訊。
欄位 | |
---|---|
agencies[] |
經營此大眾運輸路線的運輸公司 (或代理商)。 |
name |
此大眾運輸路線的全名,例如「8 Avenue Local」。 |
uri |
運輸公司提供的大眾運輸路線 URI。 |
color |
這條路線常用的顏色,以十六進位表示。 |
icon_uri |
與此行相關聯的圖示 URI。 |
name_short |
這條大眾運輸路線的簡稱。此名稱通常為路線編號,例如「M7」或「355」。 |
text_color |
這條路線的文字中常用的顏色。以十六進位表示。 |
vehicle |
這條大眾運輸路線的交通工具類型。 |
大眾運輸偏好設定
影響 TRANSIT
所傳迴路線的偏好設定。
欄位 | |
---|---|
allowed_travel_modes[] |
取得 |
routing_preference |
指定時,如果偏好設定如下,就會影響傳回的 |
TransitRoutingPreference
指定大眾運輸路線的轉送偏好設定。
列舉 | |
---|---|
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED |
未指定偏好設定。 |
LESS_WALKING |
表示計算的路線應優先選擇步行距離較短的選項。 |
FEWER_TRANSFERS |
表示計算出的路線應優先選擇轉乘次數較少的選項。 |
TransitTravelMode
用來指定大眾運輸模式的一組值。
列舉 | |
---|---|
TRANSIT_TRAVEL_MODE_UNSPECIFIED |
未指定大眾運輸交通方式。 |
BUS |
搭公車。 |
SUBWAY |
搭乘地鐵。 |
TRAIN |
火車班次。 |
LIGHT_RAIL |
搭乘輕軌電車或電車搭乘。 |
RAIL |
搭火車。這相當於 SUBWAY 、TRAIN 和 LIGHT_RAIL 的組合。 |
大眾運輸站
大眾運輸站點的相關資訊。
欄位 | |
---|---|
name |
轉運站的名稱。 |
location |
以經緯度座標表示停靠站的位置。 |
大眾運輸車輛
大眾運輸路線中使用的車輛相關資訊。
欄位 | |
---|---|
name |
這輛車的名稱 (大小寫)。 |
type |
使用的交通工具類型。 |
icon_uri |
與這個交通工具類型相關聯的圖示 URI。 |
local_icon_uri |
與這個交通工具類型相關的圖示 URI,以本地交通標誌為準。 |
大眾運輸交通工具類型
大眾運輸路線的交通工具類型。
列舉 | |
---|---|
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 |
英制單位 (英文)。 |
交通工具排放量類型
描述車輛排放量類型的一組值。僅適用於 DRIVE
RouteTravelMode
。
列舉 | |
---|---|
VEHICLE_EMISSION_TYPE_UNSPECIFIED |
未指定排放量類型。預設為 GASOLINE 。 |
GASOLINE |
汽油/柴油車。 |
ELECTRIC |
電動車。 |
HYBRID |
混合燃料 (例如汽油 + 電動車) |
DIESEL |
柴油車。 |
車輛資訊
包含車輛資訊,例如車輛排放量類型。
欄位 | |
---|---|
emission_type |
說明車輛的排放量類型。僅適用於 |
途經點
封裝路線控點。路線控點會標明路線的起點和終點,沿線包含中繼停靠站。
欄位 | |
---|---|
via |
將這個路線控點標示為里程碑,而非停靠點。針對要求中的每個非路線控點,回應會將項目附加至 |
vehicle_stopover |
指出路線控點是指車輛停靠站,其意圖為上車或下車。設定這個值時,計算的路線不包含不適合自取和下車的道路的非 |
side_of_road |
指出這個路線控點的位置,是要讓車輛在特定路段的方向停靠。設定這個值時,系統會傳遞該位置的路線,讓車輛能根據該地點的中心地調整位置。這個選項僅適用於「DRIVE」和「TWO_WHEELER」 |
聯集欄位 location_type 。代表位置的不同方式。location_type 只能是下列其中一項: |
|
location |
使用地理座標指定的點,包括選用的標題。 |
place_id |
與路線控點相關聯的搜尋點地點 ID。 |
address |
清楚易懂的地址或 Plus Code。詳情請參閱 https://plus.codes。 |