索引
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」。詳情請參閱 Unicode 語言代碼 ID。如需支援的語言清單,請參閱語言支援。如果未提供這個值,系統會根據第一個起點的位置推斷顯示語言。 |
region_code |
選用設定。區碼,指定為 ccTLD (「頂層網域」) 的兩位字元值詳情請參閱國家/地區代碼頂層網域。 |
extra_computations[] |
選用設定。額外運算清單,可用於完成要求。注意:這些額外運算可能會在回應中傳回額外的欄位。您必須在欄位遮罩中指定這些額外欄位,才能在回應中傳回。 |
traffic_model |
選用設定。指定計算交通時間時要採用的假設。這項設定會影響 |
transit_preferences |
選用設定。指定會影響 |
ExtraComputation
完成要求時要執行的額外運算。
列舉 | |
---|---|
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」。詳情請參閱 Unicode 語言代碼 ID。如需支援的語言清單,請參閱語言支援。如果未提供這個值,系統會根據路線要求的位置推測顯示語言。 |
region_code |
選用設定。區碼,指定為 ccTLD (「頂層網域」) 的兩位字元值詳情請參閱國家/地區代碼頂層網域。 |
units |
選用設定。為顯示欄位指定測量單位。這些欄位包含 |
optimize_waypoint_order |
選用設定。如果設為 true,服務會調整指定中繼路線控點,嘗試降低路線的整體費用。如果任何中繼路線控點都是 |
requested_reference_routes[] |
選用設定。指定除了預設路徑外,要在要求中計算哪些參照路徑。參考路徑是指與預設路徑不同的路徑計算目標。舉例來說, |
extra_computations[] |
選用設定。額外運算清單,可用於完成要求。注意:這些額外運算可能會在回應中傳回額外的欄位。您必須在欄位遮罩中指定這些額外欄位,才能在回應中傳回。 |
traffic_model |
選用設定。指定計算交通時間時要採用的假設。這項設定會影響 |
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[] |
指定 |
fallback_info |
在某些情況下,當伺服器無法以所有輸入偏好設定計算路線結果時,可能會改用其他計算方式。如果您使用備用模式,這個欄位會包含備用回應的詳細資訊。否則就不會設定這個欄位。 |
geocoding_results |
包含指定為地址的路線控點的地理編碼回應資訊。 |
FallbackInfo
相關資訊,瞭解使用備用結果的方式和原因。如果設定這個欄位,就表示伺服器使用了你偏好模式的其他轉送模式做為備用模式。
欄位 | |
---|---|
routing_mode |
用於回應的轉送模式。如果觸發備用廣告,模式可能與原始用戶端要求中設定的轉送偏好設定不同。 |
reason |
使用備用回應 (而非原始回應) 的原因。只有在觸發備用模式並傳回備用回應時,系統才會填入這個欄位。 |
FallbackReason
使用備用回應的原因。
列舉 | |
---|---|
FALLBACK_REASON_UNSPECIFIED |
未指定備用原因。 |
SERVER_ERROR |
使用您偏好的轉送模式計算路線時,發生伺服器錯誤,但我們可以傳回其他模式計算的結果。 |
LATENCY_EXCEEDED |
我們無法準時採用您偏好的路線模式,但能夠傳回以其他模式計算的結果。 |
FallbackRoutingMode
用於傳回備用回應的實際轉送模式。
列舉 | |
---|---|
FALLBACK_ROUTING_MODE_UNSPECIFIED |
未使用。 |
FALLBACK_TRAFFIC_UNAWARE |
表示 TRAFFIC_UNAWARE 用於計算回應。 |
FALLBACK_TRAFFIC_AWARE |
表示 TRAFFIC_AWARE 用於計算回應。 |
GeocodedWaypoint
做為路線控點使用的地點詳細資料。僅為地址路線控點填入資料。包含地理編碼結果的詳細資訊,以便判斷地址的地理編碼。
欄位 | |
---|---|
geocoder_status |
指出地理編碼作業產生的狀態碼。 |
type[] |
結果的類型,以零或多個類型標記的形式表示。支援的類型:地址類型和地址元件類型。 |
partial_match |
指出地理編碼器沒有傳回與原始要求完全相符的結果,但可以比對部分要求的地址。建議您比對原始要求,檢查是否有拼寫錯誤和/或不完整的地址。 |
place_id |
這項結果的地點 ID。 |
intermediate_waypoint_request_index |
要求中對應中繼路線控點的索引。只有在對應的路線控點為中繼路線控點時才會填入。 |
GeocodingResults
包含起點、目的地和中繼路線控點的
。僅為地址路線控點填入資料。GeocodedWaypoints
欄位 | |
---|---|
origin |
起點地理編碼路線控點 |
destination |
目的地地理編碼路線控點。 |
intermediates[] |
一份中間地理編碼路線控點清單,每個路徑點皆包含一個索引欄位,對應在要求中指定的路線控點位置,該欄位對應於零開始的位置。 |
LocalizedTime
本地化的時間說明。
欄位 | |
---|---|
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 。封裝折線的類型。預設為 coded_polyline。polyline_type 只能是下列其中一項: |
|
encoded_polyline |
使用折線編碼演算法的折線字串編碼 |
geo_json_linestring |
使用 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[] |
|
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 |
未將路況納入考量的時間長度,以文字形式表示。 |
transit_fare |
以文字呈現的大眾運輸車資。 |
RouteLabel
的標籤,可用於識別路徑的特定屬性,以便與其他路徑進行比較。Route
列舉 | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
預設 - 未使用。 |
DEFAULT_ROUTE |
針對路徑計算傳回的預設「最佳」路徑。 |
DEFAULT_ROUTE_ALTERNATE |
預設「最佳」路線的替代方案。指定 時,系統會傳回類似路徑。 |
FUEL_EFFICIENT |
燃油效率路線。標有這個值的路徑會經過最佳化處理,例如燃油消耗等。 |
RouteLeg
包含非 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 |
未將路況納入考量的時間長度,以文字形式表示。 |
StepsOverview
提供 RouteLegStep
清單的總覽資訊。
欄位 | |
---|---|
multi_modal_segments[] |
關於 |
MultiModalSegment
提供 RouteLeg.steps
不同多模組區段的摘要資訊。多模態區隔定義為具有相同 RouteTravelMode
的一或多個連續 RouteLegStep
。如果步驟中的 RouteLeg
不包含任何多模組區隔,系統就不會填入這個欄位。
欄位 | |
---|---|
navigation_instruction |
多模組區段的 NavigationInstruction。 |
travel_mode |
多模式區段的交通方式。 |
step_start_index |
做為多模組區隔開頭的對應 |
step_end_index |
是多模態區隔結尾的對應 |
RouteLegStep
包含
的區段。每個步驟對應單一導覽指示。路線路段是由步數組成。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 站,stop_count 會傳回 3。 |
trip_short_text |
時間表和看板上顯示的文字,用於向乘客識別大眾運輸行程。這段文字應用於識別服務日內的特定行程。舉例來說,「538」是阿姆特拉克火車的 |
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 |
要求中的目的地索引 (從零開始)。 |
LocalizedValues
特定屬性的文字表示法。
欄位 | |
---|---|
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 |
(如果有的話) 包含這條路線的總車資或票券費用。這個屬性只會針對 |
RouteTravelMode
用來指定交通方式的一組值。注意:WALK
、BICYCLE
和 TWO_WHEELER
路線目前為 Beta 版,有時可能缺少清楚的人行道、人行道或單車道。您必須在應用程式中顯示的所有步行、單車和雙輪路線顯示這則警告。
列舉 | |
---|---|
TRAVEL_MODE_UNSPECIFIED |
未指定交通方式。預設值為 DRIVE 。 |
DRIVE |
搭乘客車。 |
BICYCLE |
騎單車出門。 |
WALK |
步行路線。 |
TWO_WHEELER |
雙輪機動車輛。例如摩托車。請注意,這與涵蓋人工動力模式的 BICYCLE 交通方式不同。 |
TRANSIT |
搭乘大眾運輸工具 (如有)。 |
RoutingPreference
一組值,用於指定計算路線時要考量的因素。
列舉 | |
---|---|
ROUTING_PREFERENCE_UNSPECIFIED |
未指定轉送偏好設定。預設為 TRAFFIC_UNAWARE 。 |
TRAFFIC_UNAWARE |
計算路線時,不會將即時路況納入考量。適用於不受路況影響或不適用的路況。使用這個值會產生最短延遲時間。注意:針對 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 |
偵測到交通壅塞, |
TollInfo
欄位 | |
---|---|
estimated_price[] |
相應 |
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 核發的乾淨空氣車 (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 |
美國肯亞。 |
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 |
MN,美國 |
US_NC_EZPASSNC |
NC、NC. |
US_NC_PEACH_PASS |
NC、NC. |
US_NC_QUICK_PASS |
NC、NC. |
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 |
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 |
VA, USA。 |
US_WA_BREEZEBY |
美國華盛頓州 |
US_WA_GOOD_TO_GO |
美國華盛頓州 |
US_WV_EZPASSWV |
WV,美國 |
US_WV_MEMORIAL_BRIDGE_TICKETS |
WV,美國 |
US_WV_MOV_PASS |
美國西維吉尼亞州 |
US_WV_NEWELL_TOLL_BRIDGE_TICKET |
WV,美國 |
TrafficModel
指定計算交通時間時要採用的假設。這項設定會影響回應中 duration
欄位傳回的值,其中包含根據歷來平均值預估的交通時間。
列舉 | |
---|---|
TRAFFIC_MODEL_UNSPECIFIED |
未使用。如已指定,則預設值為 BEST_GUESS 。 |
BEST_GUESS |
表示傳回的 duration 應是最準確的預估交通時間 (根據歷來路況和即時車流量兩者的已知相關資訊計算而得)。departure_time 距離現在的時間越近,即時車流量的影響力就越大。 |
PESSIMISTIC |
表示傳回的持續時間在大多數日子應比實際交通時間長,但偶爾路況特別差時,實際交通時間可能會超過這個值。 |
OPTIMISTIC |
表示傳回的持續時間在大多數日子應比實際交通時間短,但偶爾路況特別好時,實際交通時間可能會短於這個值。 |
TransitAgency
提供大眾運輸路線的運輸公司。
欄位 | |
---|---|
name |
這間運輸公司的名稱。 |
phone_number |
運輸公司使用的地區特定格式電話號碼。 |
uri |
運輸公司的 URI。 |
TransitLine
包含目前步驟中使用的大眾運輸路線資訊。
欄位 | |
---|---|
agencies[] |
是大眾運輸路線的運輸公司 (或運輸公司)。 |
name |
這條大眾運輸路線的全名,例如「8 Avenue Local」。 |
uri |
此大眾運輸路線的 URI (由運輸公司提供)。 |
color |
這條路線常用的顏色。以十六進製表示。 |
icon_uri |
這條路線相關圖示的 URI。 |
name_short |
這條大眾運輸路線的簡稱。這個名稱通常是一行編號,例如「M7」或「355」。 |
text_color |
這條路線常用的文字顏色。以十六進製表示。 |
vehicle |
這條大眾運輸路線的車輛類型。 |
TransitPreferences
以 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 的組合。 |
TransitStop
大眾運輸停靠站相關資訊。
欄位 | |
---|---|
name |
轉運站的名稱。 |
location |
以經緯度座標表示的停靠站位置。 |
TransitVehicle
大眾運輸路線中使用的車輛相關資訊。
欄位 | |
---|---|
name |
這輛車的名稱 (大寫)。 |
type |
使用的交通工具類型。 |
icon_uri |
此交通工具類型相關圖示的 URI。 |
local_icon_uri |
此交通工具類型相關圖示的 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 |
說明車輛排放類型,僅適用於 |
途經點
封裝路線控點。路線控點會同時標出路線的起點和終點,以及路線沿途的中繼站。
欄位 | |
---|---|
via |
將這個路線點標示為里程碑,而不是停靠點。針對要求中的每個非透過路線控點,回應會將項目附加至 |
vehicle_stopover |
指出路線控點是用來停靠的車輛,其用途為上車或下車。設定這個值後,計算的路線就不會在不適合上車和下車的道路包含非 |
side_of_road |
表示此路線控點的位置可讓您優先於特定道路停靠。設定這個值後,路線會經過位置,讓車輛可以在道路的中央停止位置,直到該道路的中心偏離道路的中心點。這個選項僅適用於 |
聯集欄位 location_type 。呈現某個地點的不同方式。location_type 只能是下列其中一項: |
|
location |
使用地理座標 (包括選用方向) 指定的點。 |
place_id |
與路線控點相關聯的搜尋點地點 ID。 |
address |
使用者可理解的地址或 Plus Code。詳情請參閱 https://plus.codes。 |