索引
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 (「頂層網域」) 的兩位字元值詳情請參閱國家/地區代碼頂層網域。 |
units |
選用設定。為顯示欄位指定測量單位。 |
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 。封裝折線的類型。預設為 encoded_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」是指 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 中針對起點/目的地組合計算出的路線資訊。這個原型可以串流至用戶端。
欄位 | |
---|---|
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 核發的「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 |
美國馬裡蘭州。 |
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 |
這家運輸公司的名稱。 |
phone_number |
運輸公司在某些地區專用的電話號碼格式。 |
uri |
運輸公司的 URI。 |
TransitLine
包含這個步驟中使用的大眾運輸路線資訊。
欄位 | |
---|---|
agencies[] |
執行這條大眾運輸路線的運輸公司 (或運輸公司)。 |
name |
這條大眾運輸路線的全名,例如「8 Avenue 當地」。 |
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。 |