DirectionsService 類別
google.maps.DirectionsService
類別
用來計算兩個以上位置之間路線的導航服務。
使用 v=beta
時,可透過呼叫 const {DirectionsService} = await google.map.importLibrary("routes")
來存取請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
---|---|
DirectionsService |
DirectionsService() 參數:無
建立新的 DirectionsService 執行個體,將路線查詢傳送至 Google 伺服器。 |
方法 | |
---|---|
route |
route(request[, callback]) 參數:
傳回值:
Promise<DirectionsResult> 發出路線搜尋要求。 |
DirectionsRequest 介面
google.maps.DirectionsRequest
介面
要傳送到 DirectionsService
的方向查詢。
屬性 | |
---|---|
destination |
類型:
string|LatLng|Place|LatLngLiteral 目的地位置。可指定為要進行地理編碼的字串,或是 LatLng 或 Place 。這是必填欄位。 |
origin |
類型:
string|LatLng|Place|LatLngLiteral 起點位置。可指定為要進行地理編碼的字串,或是 LatLng 或 Place 。這是必填欄位。 |
travelMode |
類型:
TravelMode 要求的路線類型。這是必填欄位。 |
avoidFerries optional |
類型:
boolean optional 如果為 true ,則指示「路線」服務盡量避開渡輪。選用。 |
avoidHighways optional |
類型:
boolean optional 如果為 true ,則指示路線規劃服務盡量避開高速公路。選用。 |
avoidTolls optional |
類型:
boolean optional 如果為 true ,則指示路線規劃服務盡量避開收費道路。選用。 |
drivingOptions optional |
類型:
DrivingOptions optional 這些設定僅適用於 travelMode 為 DRIVING 的要求。這個物件對其他交通方式沒有影響。 |
language optional |
類型:
string optional 如果可以的話,應傳回結果的語言語言識別碼。請參閱支援語言清單。 |
optimizeWaypoints optional |
類型:
boolean optional 如果設為 true ,DirectionsService 會嘗試重新排序所提供中繼路線控點,以降低路徑的整體費用。如果路線控點經過最佳化,請檢查回應中的 DirectionsRoute.waypoint_order ,確定新的排序方式。 |
provideRouteAlternatives optional |
類型:
boolean optional 無論是否提供替代路徑。選用。 |
region optional |
類型:
string optional 用於地理編碼要求自訂調整的區域代碼。區域代碼接受 ccTLD (「頂層網域」) 這兩個字元值。多數 ccTLD 代碼與 ISO 3166-1 代碼相同,只有少數例外。舉例來說,英國的 ccTLD 為「uk」( .co.uk ),其 ISO 3166-1 代碼卻是「gb」(技術上適用於「英國與北愛爾蘭的英國王國」)。 |
transitOptions optional |
類型:
TransitOptions optional 這項設定僅適用於 travelMode 為 TRANSIT 的要求。這個物件對其他交通方式沒有影響。 |
unitSystem optional |
類型:
UnitSystem optional 預設值:來源國家/地區使用的單位系統。
顯示距離時使用的常用單位系統。 |
waypoints optional |
類型:
Array<DirectionsWaypoint> optional 中間路點陣列。系統會按照這個陣列中的每個路線控點,計算從起點到目的地的路線。如需瞭解允許的路線點數量上限,請參閱開發人員指南。大眾運輸路線不支援路線控點。選用。 |
DirectionsStatus 常數
google.maps.DirectionsStatus
常數
呼叫route()
後DirectionsService
傳回的狀態。您可以使用值或透過常數名稱指定這些值。例如,'OK'
或 google.maps.DirectionsStatus.OK
。
使用 v=beta
時,可透過呼叫 const {DirectionsStatus} = await google.map.importLibrary("routes")
來存取請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
INVALID_REQUEST |
提供的 DirectionsRequest 無效。 |
MAX_WAYPOINTS_EXCEEDED |
在 DirectionsRequest 中提供的 DirectionsWaypoint 過多。如需瞭解允許的路線點數量上限,請參閱開發人員指南。 |
NOT_FOUND |
起點、目的地或路點中至少有一項無法進行地理編碼。 |
OK |
回應包含有效的 DirectionsResult 。 |
OVER_QUERY_LIMIT |
網頁已在過短的時間內超過要求限制。 |
REQUEST_DENIED |
不允許這個網頁使用導航服務。 |
UNKNOWN_ERROR |
因為伺服器發生錯誤,無法處理導航要求。如果您再試一次,該要求可能會成功。 |
ZERO_RESULTS |
在起點和目的地之間找不到路線。 |
DirectionsResult 介面
google.maps.DirectionsResult
介面
擷取自路線伺服器的路線回應。您可以使用 DirectionsRenderer
來轉譯這些內容,或是剖析此物件並自行算繪。您必須按照《Google 地圖平台服務條款》的規定,顯示警告和版權資訊。請注意,雖然這個結果與 JSON 類似,但並非 JSON 格式,因為它間接包含 LatLng
物件。
屬性 | |
---|---|
routes |
類型:
Array<DirectionsRoute> 由 DirectionsRoute 組成的陣列,每個陣列包含其組成的腿部和組成步驟的相關資訊。除非 DirectionsRequest 使用 provideRouteAlternatives 為 true 。 |
available_travel_modes optional |
類型:
Array<TravelMode> optional 包含多種可用的交通方式。要求指定交通方式且沒有任何結果時,系統會傳回這個欄位。陣列包含一組指定路線控點的國家/地區可用的交通方式。如果一或多個路線控點為「透過路線控點」,這個欄位則不會傳回。 |
geocoded_waypoints optional |
類型:
Array<DirectionsGeocodedWaypoint> optional DirectionsGeocodedWaypoint 陣列,每個陣列包含起點、目的地和路線控點的地理編碼相關資訊。 |
DirectionsRenderer 類別
google.maps.DirectionsRenderer
類別
轉譯從 DirectionsService
取得的路線。
此類別會擴充 MVCObject
。
使用 v=beta
時,可透過呼叫 const {DirectionsRenderer} = await google.map.importLibrary("routes")
來存取請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) 參數:
使用指定的選項建立轉譯器。路線可以在地圖上 (以視覺重疊方式顯示) 或另外顯示在 <div> 面板上 (以文字說明表示)。 |
方法 | |
---|---|
getDirections |
getDirections() 參數:無
傳回值:
DirectionsResult 傳回轉譯器目前的路線集。 |
getMap |
getMap() 參數:無
傳回值:
Map 傳回算繪 DirectionsResult 的地圖。 |
getPanel |
getPanel() 參數:無
傳回值:
HTMLElement|null 傳回轉譯 DirectionsResult 的面板 <div> 。 |
getRouteIndex |
getRouteIndex() 參數:無
傳回值:
number 傳回這個 DirectionsRenderer 物件目前使用的 (零) 路徑索引。 |
setDirections |
setDirections(directions) 參數:
傳回值:無
設定轉譯器以使用 DirectionsService 的結果。如果以這種方式設定有效的路線集,則會在轉譯器指定的地圖和面板上顯示路線。 |
setMap |
setMap(map) 參數:
傳回值:無
這個方法可指定呈現路線的地圖。傳送 null ,以移除地圖上的路線。 |
setOptions |
setOptions(options) 參數:
傳回值:無
初始化後,請變更這個 DirectionsRenderer 的選項設定。 |
setPanel |
setPanel(panel) 參數:
傳回值:無
這個方法會呈現 <div> 中的路線。傳遞 null 即可將內容從面板中移除。 |
setRouteIndex |
setRouteIndex(routeIndex) 參數:
傳回值:無
在 DirectionsResult 物件中設定要顯示的路徑 (零) 索引。根據預設會呈現陣列中的第一條路徑。 |
繼承:
addListener 、
bindTo 、
get 、
notify 、
set 、
setValues 、
unbind 、
unbindAll
|
事件 | |
---|---|
directions_changed |
function() 引數:無
當轉譯的路線變更時,無論是設定新的 DirectionsResult ,或是使用者完成將變更拖曳到路線路徑時,都會觸發這個事件。 |
DirectionsRendererOptions 介面
google.maps.DirectionsRendererOptions
介面
這個物件定義可在 DirectionsRenderer
物件上設定的屬性。
屬性 | |
---|---|
directions optional |
類型:
DirectionsResult optional 地圖和/或 <div> 面板中顯示的路線,擷取自 DirectionsResult 物件的 DirectionsService 。 |
draggable optional |
類型:
boolean optional 如果設為 true ,可讓使用者拖曳及修改此 DirectionsRenderer 轉譯的路徑路徑。 |
hideRouteList optional |
類型:
boolean optional 預設:
false 這個屬性可指出轉譯器是否應提供使用者可選擇在路線面板中顯示的路線清單。 |
infoWindow optional |
類型:
InfoWindow optional 在使用者點擊標記時顯示文字資訊的 InfoWindow 。將會覆寫現有資訊視窗內容,同時移動其位置。如未指定資訊視窗,DirectionsRenderer 將建立及使用自己的資訊視窗。如果 suppressInfoWindows 設為 true ,系統會忽略這個屬性。 |
map optional |
類型:
Map optional 要顯示導航的地圖。 |
markerOptions optional |
類型:
MarkerOptions optional 標記選項。 DirectionsRenderer 轉譯的所有標記都會使用這些選項。 |
panel optional |
類型:
HTMLElement optional 顯示路線步驟的 <div> 。 |
polylineOptions optional |
類型:
PolylineOptions optional 折線選項。 DirectionsRenderer 算繪的所有折線都會使用這些選項。 |
preserveViewport optional |
類型:
boolean optional 預設:
false 如果將這個選項設為 true ,或從地圖中心到中心設定從未設定,輸入地圖會置中,並放大至這組路線的定界框。 |
routeIndex optional |
類型:
number optional DirectionsResult 物件內的路徑索引。預設值為 0。 |
suppressBicyclingLayer optional |
類型:
boolean optional 要求單車路線時,隱藏 BicyclingLayer 的算繪。 |
suppressInfoWindows optional |
類型:
boolean optional 停止呈現資訊視窗。 |
suppressMarkers optional |
類型:
boolean optional 停止呈現標記。 |
suppressPolylines optional |
類型:
boolean optional 停止呈現折線。 |
DirectionsWaypoint 介面
google.maps.DirectionsWaypoint
介面
DirectionsWaypoint
代表出發目的地和目的地之間的目的地,該目的地是您應該在哪個目的地之間規劃行程。
屬性 | |
---|---|
location optional |
類型:
string|LatLng|LatLngLiteral|Place optional 路點位置。可以是位址字串、 LatLng 或 Place 。選用。 |
stopover optional |
類型:
boolean optional 預設:
true 如果為 true ,表示這個路線控點是起點和目的地之間的停靠站。這樣會將路線分成兩條路段。如果為 false ,表示路線應設有偏誤經過這個路線控點,但不分成兩條路段。如果您想建立路線來回應使用者拖曳地圖上的路線控點,這個方法就很實用。 |
DirectionsGeocodedWaypoint 介面
google.maps.DirectionsGeocodedWaypoint
介面
單一地理編碼路線控點。
屬性 | |
---|---|
partial_match optional |
類型:
boolean optional 是否允許地理編碼器傳回與指定地址部分完全相符的地理編碼點。 |
place_id optional |
類型:
string optional 與路線控點相關聯的地點 ID。地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。請參閱 Places API 開發人員指南,進一步瞭解地點 ID。 |
types optional |
類型:
Array<string> optional 註明傳回地理編碼元素類型的字串陣列。如需可能的字串清單,請參閱《開發人員指南》的地址元件類型一節。 |
DirectionsRoute 介面
google.maps.DirectionsRoute
介面
包含 DirectionsResult
中一組腿部的單一路線。請注意,雖然這個物件與 JSON 類似,但並非 JSON,因為直接或間接包含 LatLng
物件。
屬性 | |
---|---|
bounds |
類型:
LatLngBounds 這個路線的界限。 |
copyrights |
類型:
string 這個路線要顯示的版權文字。 |
legs |
類型:
Array<DirectionsLeg> DirectionsLeg 陣列,每個陣列都包含其組合步驟的相關資訊。每個指定的中途停靠點或目的地都有一個路段。因此,沒有中途停靠點的路線會包含一個 DirectionsLeg ,而具有一個停靠路線控點的路徑會包含兩個。 |
overview_path |
代表此路線完整課程的 LatLng 陣列。已將路徑簡化以讓路徑適用於需要少量端點的情況 (例如 Static Maps API 網址)。 |
overview_polyline |
類型:
string 總覽的路徑的 編碼折線表示法。此折線是最終路線的概略 (平滑) 路徑。 |
summary |
類型:
string 包含路線的簡短文字說明,適合為命名和區分路徑與替代選項。 |
warnings |
類型:
Array<string> 顯示路線時要顯示的警告 |
waypoint_order |
類型:
Array<number> 如果 optimizeWaypoints 設為 true ,這個欄位會包含重新排序的輸入路線控點。請注意,路點的編號以零為基準。 如果任何輸入路線控點的 stopover 已設為 false ,則此欄位為空白,因為這類查詢無法使用路徑最佳化。 |
fare optional |
類型:
TransitFare optional 整趟行程的票價總價。僅適用於大眾運輸要求。 |
DirectionsLeg 介面
google.maps.DirectionsLeg
介面
由 DirectionsResult
中的一組步驟組成的單一腿。系統可能不會為所有要求傳回航段中的部分欄位 請注意,雖然這個結果與 JSON 類似,但並非 JSON,因為直接或間接包含 LatLng
物件。
屬性 | |
---|---|
end_address |
類型:
string 這個腿的目的地目的地地址。這是正常顯示的內容。請勿以程式輔助方式剖析格式化的地址。 |
end_location |
類型:
LatLng DirectionsService 會使用開始和結束地點最近的交通選項 (通常是道路) 來計算位置之間的路線。end_location 表示實際的地理編碼目的地,如果道路不在這個腿的目的地附近,可能與最後一個步驟的 end_location 不同。 |
start_address |
類型:
string 這個腿的起點地址。這是正常顯示的內容。請勿以程式輔助方式剖析格式化的地址。 |
start_location |
類型:
LatLng DirectionsService 會使用開始和結束地點最近的交通選項 (通常是道路) 來計算位置之間的路線。start_location 表示實際的地理編碼起點,如果道路不在這個航段的起點附近,可能與第一個步驟的 start_location 不同。 |
steps |
類型:
Array<DirectionsStep> DirectionsStep 陣列,每個陣列包含這個航段中個別步驟的相關資訊。 |
|
類型:
Array<?> 沿途的車流量資訊。 |
via_waypoints |
這個航段的一連串直達路線控點,如原始要求中指定的。 而已在替代路徑中淘汰。3.27 版本是 API 的最後一個版本,可在替代路徑中新增額外 使用「路線規劃服務」實作可拖曳的路線時,建議您停用替代路線的拖曳功能。只有主要路線可拖曳。使用者可以拖曳主要路徑,直到該路徑與替代路徑相符為止。 |
arrival_time optional |
類型:
Time optional 這個腿的預估抵達時間。僅適用於 TRANSIT 要求。 |
departure_time optional |
類型:
Time optional 這個腿的預估出發時間。僅適用於 TRANSIT 要求。 |
distance optional |
類型:
Distance optional 這個航段涵蓋的總距離。因為距離不明,這個屬性可能未定義。 |
duration optional |
類型:
Duration optional 這個航段的總期間。這項屬性可能是 undefined ,因為時間長度可能不明。 |
duration_in_traffic optional |
類型:
Duration optional 這個路段的總時間長度,以 trafficModel 屬性指定的車流量條件納入考量。這項屬性可能是 undefined ,因為時間長度可能不明。 |
DirectionsStep
google.maps.DirectionsStep
介面
DirectionsResult
中的單一 DirectionsStep
。部分欄位可以是 undefined
。請注意,雖然這個物件與 JSON 類似,但並非 JSON,因為直接包含 LatLng
物件。
屬性 | |
---|---|
encoded_lat_lngs |
類型:
string 步驟的編碼折線表示法。這是步驟的概略 (平滑) 路徑。 |
end_location |
類型:
LatLng 這個步驟的終點位置。 |
|
類型:
LatLng 這個步驟的終點位置。 |
instructions |
類型:
string 這個步驟的指示。 |
|
一系列步驟說明 LatLng 。這是步驟的概略 (平滑) 路徑。 |
maneuver |
類型:
string 包含針對目前步驟採取的行動 ( turn-left 、merge 、straight 等)。值隨時可能變動,而且在未事先通知的情況下導入新值。 |
path |
一系列步驟說明 LatLng 。這是步驟的概略 (平滑) 路徑。 |
start_location |
類型:
LatLng 這個步驟的起點位置。 |
|
類型:
LatLng 這個步驟的起點位置。 |
travel_mode |
類型:
TravelMode 此步驟中使用的旅行模式。 |
distance optional |
類型:
Distance optional 這個步驟涵蓋的距離。此屬性可能是 undefined ,因為距離可能不明。 |
duration optional |
類型:
Duration optional 一般執行此步驟所需的時間 (單位為秒數),以及在文字表單中執行此步驟一般所需的時間。這項屬性可能是 undefined ,因為時間長度可能不明。 |
|
類型:
DirectionsPolyline optional 包含具有單一屬性「points」的物件,包含該步驟的編碼折線表示法。此折線是步驟的概略 (平滑) 路徑。 |
steps optional |
類型:
Array<DirectionsStep> optional 這個步驟的子步驟適用於大眾運輸路線的非大眾運輸路線。 |
transit optional |
類型:
TransitDetails optional 這個步驟的大眾運輸專屬詳細資料。除非這個步驟的交通方式為 TRANSIT ,否則此屬性無法定義。 |
transit_details optional |
類型:
TransitDetails optional 如果交通方式為 TRANSIT ,則適用於這個步驟的詳細資料。 |
DirectionsPolyline 介面
google.maps.DirectionsPolyline
介面
包含 points
屬性的物件,用於描述 DirectionsStep
的折線。
屬性 | |
---|---|
points |
類型:
string 編碼折線。 |
Place 介面
google.maps.Place
介面
包含為 DirectionsRequest
或 DistanceMatrixRequest
尋找、識別或描述地點所需的資訊。在這種情況下,「地點」係指商家、搜尋點或地理位置。如要擷取地點相關資訊,請參閱 PlacesService
。
屬性 | |
---|---|
location optional |
類型:
LatLng|LatLngLiteral optional 此地點描述的實體的 LatLng 。 |
placeId optional |
類型:
string optional 地點的地點 ID (例如商家或搜尋點)。地點 ID 是 Google 地圖資料庫中地點的專屬識別碼。請注意, placeId 是辨識地點最精確的方式。如果可以的話,請指定 placeId ,而不是 query 。任何向 Places API 發出的要求 (例如 TextSearch) 都能擷取地點 ID。您也可以從傳送至 Geocoding API 的要求擷取地點 ID。詳情請參閱地點 ID 總覽。 |
query optional |
類型:
string optional 用來描述該地點的搜尋查詢 (例如商家或搜尋點)。查詢範例:「Qua, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW」。如果可以的話,請指定 placeId ,而不是 query 。API 無法保證將查詢字串解析成特定位置的準確度。如果同時提供 placeId 和 query ,就會發生錯誤。 |
TravelMode 常數
google.maps.TravelMode
常數
可在 DirectionsRequest
中指定的有效交通方式,以及 DirectionsStep
中傳回的交通方式。您可以使用值或透過常數名稱指定這些值。例如,'BICYCLING'
或 google.maps.TravelMode.BICYCLING
。
使用 v=beta
時,可透過呼叫 const {TravelMode} = await google.map.importLibrary("routes")
來存取請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
BICYCLING |
指定單車導航要求。 |
DRIVING |
指定行車導航要求。 |
TRANSIT |
指定大眾運輸路線要求。 |
WALKING |
指定步行導航要求。 |
DrivingOptions 介面
google.maps.DrivingOptions
介面
將交通方式設為 DRIVING
時,設定 DirectionsRequest
。
屬性 | |
---|---|
departureTime |
類型:
Date 路線的出發出發時間,指定為 Date 物件。Date 物件會測量從 1970 年 1 月 1 日開始至今的時間 (以毫秒為單位)。必須指定 DrivingOptions 才算有效。出發時間必須設為目前時間或未來時間。不得設為過去的日期。 |
trafficModel optional |
類型:
TrafficModel optional 預測流量持續時間時的首選假設。預設為 BEST_GUESS 。 |
TrafficModel 常數
google.maps.TrafficModel
常數
預測流量時間長度時使用的假設。指定為 DirectionsRequest
或 DistanceMatrixRequest
的一部分。您可以使用值或透過常數名稱指定這些值。例如,'bestguess'
或 google.maps.TrafficModel.BEST_GUESS
。
使用 v=beta
時,可透過呼叫 const {TrafficModel} = await google.map.importLibrary("routes")
來存取請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
BEST_GUESS |
運用歷來流量資料,估算出流量所花費的時間。 |
OPTIMISTIC |
使用歷來流量資料,即可估算出流量持續時間。 |
PESSIMISTIC |
使用歷來流量資料,即可精準預測流量持續時間。 |
TransitOptions 介面
google.maps.TransitOptions
介面
當交通方式設為 TRANSIT 時,要在 DirectionsRequest
中加入 TransitOptions 物件。
屬性 | |
---|---|
arrivalTime optional |
類型:
Date optional 所需的路線抵達時間,指定為 Date 物件。Date 物件會測量從 1970 年 1 月 1 日開始至今的時間 (毫秒)。如果指定了抵達時間,則系統會忽略出發時間。 |
departureTime optional |
類型:
Date optional 路線的出發時間,以日期物件指定。Date 物件會測量從 1970 年 1 月 1 日開始至今的時間 (毫秒)。如未指定出發時間和抵達時間,系統會假設該時間是「現在」。 |
modes optional |
類型:
Array<TransitMode> optional 有一或多個偏好的大眾運輸模式,例如公車或火車。如果沒有指定偏好設定,API 會傳回預設最佳路線。 |
routingPreference optional |
類型:
TransitRoutePreference optional 偏好設定可能偏離大眾運輸路線的偏好設定,例如步行距離更短。如果沒有指定偏好設定,API 會傳回預設最佳路線。 |
TransitMode 常數
google.maps.TransitMode
常數
有效的大眾運輸模式,例如可在 TransitOptions
中指定的公車。您可以使用值或透過常數名稱指定這些值。例如,'BUS'
或 google.maps.TransitMode.BUS
。
使用 v=beta
時,可透過呼叫 const {TransitMode} = await google.map.importLibrary("routes")
來存取請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
BUS |
將公車指定為偏好的大眾運輸工具。 |
RAIL |
為鐵路指定偏好的交通方式。 |
SUBWAY |
將捷運指定為偏好的交通方式。 |
TRAIN |
將火車指定為偏好的大眾運輸工具。 |
TRAM |
將電車指定為偏好的大眾運輸方式。 |
TransitRoutePreference 常數
google.maps.TransitRoutePreference
常數
可在 TransitOptions
中指定的有效大眾運輸路線類型。您可以使用值或透過常數名稱指定這些值。例如,'LESS_WALKING'
或 google.maps.TransitRoutePreference.LESS_WALKING
。
使用 v=beta
時,可透過呼叫 const {TransitRoutePreference} = await google.map.importLibrary("routes")
來存取請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
FEWER_TRANSFERS |
指定計算的路線應採用的轉乘次數有限。 |
LESS_WALKING |
指定計算的路線應步行數量有限。 |
TransitFare 介面
google.maps.TransitFare
介面
由價值和貨幣組成的 DirectionsRoute
票價。
屬性 | |
---|---|
currency |
類型:
string ISO 4217 貨幣代碼,用於表示車資的表示貨幣。 |
value |
類型:
number 車資的數值,以指定的 currency 表示。 |
TransitDetails 介面
google.maps.TransitDetails
介面
在這個步驟中使用的出發、抵達和大眾運輸模式詳細資料。
屬性 | |
---|---|
arrival_stop |
類型:
TransitStop 此大眾運輸路線的抵達站。 |
arrival_time |
類型:
Time 這個步驟的抵達時間,指定為時間物件。 |
departure_stop |
類型:
TransitStop 此大眾運輸路線的出發停靠站。 |
departure_time |
類型:
Time 這個步驟的出發時間,指定為時間物件。 |
headsign |
類型:
string 這條路線的移動路線,因為標示在車輛上或出發停靠站。 |
headway |
類型:
number 這個停靠站之間同等車輛之間的預期秒數。 |
line |
類型:
TransitLine 在這個步驟中使用的大眾運輸路線詳細資料。 |
num_stops |
類型:
number 這個步驟中的停靠次數。包含抵達目的地,但不含出發停靠站。 |
trip_short_name |
類型:
string 顯示在時間表和看板看板上的文字,可用來識別乘客的大眾運輸行程,例如找出通勤火車行程的火車號碼。這段文字可明確識別服務日內的行程。 |
TransitStop 介面
google.maps.TransitStop
介面
大眾運輸站或車站的詳細資料。
屬性 | |
---|---|
location |
類型:
LatLng 這個停靠站的位置。 |
name |
類型:
string 此大眾運輸停靠站的名稱。 |
TransitLine 介面
google.maps.TransitLine
介面
提供這個大眾運輸步驟的大眾運輸路線相關資訊。
屬性 | |
---|---|
agencies |
類型:
Array<TransitAgency> 經營此大眾運輸路線的運輸公司。 |
color |
類型:
string 此大眾運輸路線的招牌顏色,以十六進位字串表示。 |
icon |
類型:
string 與這行相關聯的圖示網址。 |
name |
類型:
string 此大眾運輸路線的全名,例如「8 號大道」。 |
short_name |
類型:
string 此大眾運輸路線的簡稱,例如「E」。 |
text_color |
類型:
string 此大眾運輸路線的招牌文字顏色,以十六進位字串表示。 |
url |
類型:
string 這個大眾運輸路線專屬的運輸公司網址。 |
vehicle |
使用的車輛類型,例如火車或公車。 |
TransitAgency 介面
google.maps.TransitAgency
介面
運輸系統的運輸公司相關資訊。
屬性 | |
---|---|
name |
類型:
string 這間運輸公司的名稱。 |
phone |
類型:
string 運輸公司的電話號碼。 |
url |
類型:
string 運輸公司的網址。 |
TransitVehicle 介面
google.maps.TransitVehicle
介面
搭乘大眾運輸工具的車輛相關資訊。
屬性 | |
---|---|
icon |
類型:
string 對應於此路線使用的車輛類型之圖示的網址。 |
local_icon |
類型:
string 對應這個地區使用的車輛類型圖示,而不是較籠統的圖示。 |
name |
類型:
string 這類型大眾運輸車輛的名稱,例如「火車」或「公車」。 |
type |
類型:
VehicleType 使用的車輛類型,例如火車、公車或渡輪。 |
VehicleType 常數
google.maps.VehicleType
常數
可能的車輛類型值。
使用 v=beta
時,可透過呼叫 const {VehicleType} = await google.map.importLibrary("routes")
來存取請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
BUS |
公車。 |
CABLE_CAR |
靠電纜運作的交通工具,通常在地面上行駛。空中纜車的類型可能是 GONDOLA_LIFT 。 |
COMMUTER_TRAIN |
通勤鐵路。 |
FERRY |
渡輪。 |
FUNICULAR |
車輛用傳輸線向上陡坡。 |
GONDOLA_LIFT |
空中纜車。 |
HEAVY_RAIL |
重軌電車。 |
HIGH_SPEED_TRAIN |
高速火車。 |
INTERCITY_BUS |
城際巴士。 |
METRO_RAIL |
輕軌電車。 |
MONORAIL |
單軌電車。 |
OTHER |
其他車輛。 |
RAIL |
火車。 |
SHARE_TAXI |
共乘式計程車是一種公車交通服務,可在路線上的任何地方下車和接送乘客。通常會共用計程車服務。 |
SUBWAY |
地下輕軌電車。 |
TRAM |
地上輕軌電車。 |
TROLLEYBUS |
無軌電車。 |
UnitSystem 常數
google.maps.UnitSystem
常數
可在 DirectionsRequest
中指定的有效單位系統。
使用 v=beta
時,可透過呼叫 const {UnitSystem} = await google.map.importLibrary("core")
來存取請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
IMPERIAL |
指定 DirectionsResult 中的距離應以英數單位表示。 |
METRIC |
指定 DirectionsResult 中的距離應以指標單位表示。 |
Distance 介面
google.maps.Distance
介面
以數值和顯示字串代表距離。
屬性 | |
---|---|
text |
類型:
string 使用要求中指定的 UnitSystem 表示距離值的字串。 |
value |
類型:
number 距離 (公制單位)。 |
Duration 介面
google.maps.Duration
介面
以數值和顯示字串代表期間。
屬性 | |
---|---|
text |
類型:
string 代表期間值的字串。 |
value |
類型:
number 期間 (單位為秒數)。 |
Time 介面
google.maps.Time
介面
表示日期物件的時間、本地化字串和時區。
屬性 | |
---|---|
text |
類型:
string 代表時間值的字串。顯示的時間以大眾運輸車站所在的時區為準。 |
time_zone |
類型:
string 此停靠站所在的時區。這個值是 IANA 時區資料庫所定義的時區名稱 (例如「America/New_York」)。 |
value |
類型:
Date 此出發或抵達的時間,以 JavaScript Date 物件指定。 |
DirectionsTravelMode 常數
google.maps.DirectionsTravelMode
常數
DirectionsUnitSystem 常數
google.maps.DirectionsUnitSystem
常數