索引
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 |
NavigationInstructions 會以格式化的 HTML 文字字串形式呈現。這類內容應按原樣閱讀。本內容僅供檢視,請勿以程式輔助方式剖析。 |
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[] |
結果的類型,格式為 0 或多個型別標記。支援的類型:地址類型和地址元件類型。 |
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_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 |
多模態區隔的導覽指示。 |
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 中針對起點/目的地組合計算的路線資訊。此原型可以串流至用戶端。
欄位 | |
---|---|
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 |
Japan 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 |
美國阿拉巴馬州 |
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_KY_RIVERLINK |
美國肯塔基州 |
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_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 |
美國北卡羅來納州 |
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_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 |
美國西維吉尼亞州 |
US_WV_MEMORIAL_BRIDGE_TICKETS |
美國西維吉尼亞州 |
US_WV_MOV_PASS |
美國西維吉尼亞州 |
US_WV_NEWELL_TOLL_BRIDGE_TICKET |
美國西維吉尼亞州 |
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。 |