Directions

DirectionsService class

google.maps.DirectionsService class

用來計算兩個以上位置之間路線的導航服務。

撥打 const {DirectionsService} = await google.maps.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，則指示 Directions 服務盡可能避開渡輪。選填。
avoidHighways optional
類型：  boolean optional
如為 true，路線規劃服務會盡可能避開高速公路。選填。
avoidTolls optional
類型：  boolean optional
如果為 true，路線規劃服務會盡可能避開收費路段。選填。
drivingOptions optional
類型：  DrivingOptions optional
這些設定僅適用於 travelMode 為 DRIVING 的要求。這個物件不會影響其他交通方式。
language optional
類型：  string optional
盡可能以指定語言傳回結果的語言 ID。請參閱支援語言清單。
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。

撥打 const {DirectionsStatus} = await google.maps.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 物件。
request
類型：  DirectionsRequest
產生這項結果的 DirectionsRequest。
routes
類型：  Array<DirectionsRoute>
DirectionsRoute 的陣列，每個 DirectionsRoute 都包含組成路段和步驟的相關資訊。除非 DirectionsRequest 是以 provideRouteAlternatives 設為 true 製作，否則只會有一條路線。
available_travel_modes optional
類型：  Array<TravelMode> optional
包含可用交通方式的陣列。要求指定交通方式但未取得任何結果時，系統會傳回這個欄位。這個陣列包含指定路線控點所在國家/地區的可用交通方式。如果一或多個路線控點是「途經路線控點」，系統就不會傳回這個欄位。
geocoded_waypoints optional
類型：  Array<DirectionsGeocodedWaypoint> optional
DirectionsGeocodedWaypoint 的陣列，每個 DirectionsGeocodedWaypoint 都包含起點、目的地和路線控點地理編碼的相關資訊。

DirectionsRenderer class

google.maps.DirectionsRenderer class

顯示從 DirectionsService 取得的路線。

這個類別會擴充 MVCObject。

撥打 const {DirectionsRenderer} = await google.maps.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)
參數： 
  • routeIndex：number
傳回值：無
在 DirectionsResult 物件中，設定要轉譯的路徑索引 (從零開始)。根據預設會呈現陣列中的第一條路徑。
已繼承： addListener、 bindTo、 get、 notify、 set、 setValues、 unbind、 unbindAll
directions_changed
function()
引數：無
當算繪的路線變更時 (設定新的 DirectionsResult 或使用者拖曳變更路線路徑時)，系統會觸發這個事件。

DirectionsRendererOptions interface

google.maps.DirectionsRendererOptions 介面

這個物件會定義可在 DirectionsRenderer 物件上設定的屬性。
directions optional
類型：  DirectionsResult optional
要顯示在地圖和/或 <div> 面板中的路線，從 DirectionsService 擷取為 DirectionsResult 物件。
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 地圖中的特定地點。如要進一步瞭解地點 ID，請參閱 Places API 開發人員指南。
types optional
類型：  Array<string> optional
註明傳回地理編碼元素類型的字串陣列。如需可能字串的清單，請參閱《開發人員指南》的「 地址元件類型」一節。

DirectionsRoute 介面

google.maps.DirectionsRoute 介面

單一路線，包含 DirectionsResult 中的一組路段。請注意，雖然這個物件「類似 JSON」，但並非嚴格的 JSON，因為它直接和間接包含 LatLng 物件。
bounds
類型：  LatLngBounds
這個路線的界限。
copyrights
類型：  string
這個路線要顯示的版權文字。
legs
類型：  Array<DirectionsLeg>
DirectionsLeg 的陣列，每個 DirectionsLeg 都包含組成步驟的相關資訊。每指定一個中途停靠路線控點或目的地時，就會有一個路段。因此，如果路線沒有中途停靠點路線控點，就會包含一個 DirectionsLeg；如果路線有一個中途停靠點路線控點，就會包含兩個。
overview_path
類型：  Array<LatLng>
代表這條路線完整過程的 LatLng 陣列。已將路徑簡化以讓路徑適用於需要少量端點的情況 (例如 Static Maps API 網址)。
overview_polyline
類型：  string
路線的編碼折線表示法，位於 overview_path 中。這條折線是導航路線的近似 (順暢) 路徑。
summary
類型：  string
包含路線的簡短文字說明，適合用來命名路線，並與替代路線區別。
warnings
類型：  Array<string>
顯示路線時要顯示的警告
waypoint_order
類型：  Array<number>
如果 optimizeWaypoints 設為 true，這個欄位會包含輸入航點的重新排序排列。舉例來說，如果輸入內容為：
  起點：洛杉磯
  中途點：達拉斯、班戈、鳳凰城
  目的地：紐約
最佳化輸出內容的順序如下：
  起點：洛杉磯
  中途點：鳳凰城、達拉斯、班戈
  目的地：紐約
則這個欄位會是 Array，包含值 [2, 0, 1]。請注意，路點的編號以零為基準。
如果任何輸入的中途點將 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 的陣列，其中包含這個路段中各個步驟的相關資訊。
traffic_speed_entry
類型：  Array<*>
行程路段的車速資訊。
via_waypoints
類型：  Array<LatLng>
這個路段的非中途停留點陣列，是在原始要求中指定。

替代路線中已淘汰。3.27 版是最新版 API，可在替代路線中新增額外的via_waypoints。

使用路線規劃服務導入可拖曳的路線時，建議停用替代路線的拖曳功能。只有主要路線可拖曳。使用者可以拖曳主要路線，直到該路線與替代路線相符為止。
arrival_time optional
類型：  Time optional
這個路段的預計到達時間。僅適用於大眾運輸要求。
departure_time optional
類型：  Time optional
這個路段的預計出發時間。僅適用於大眾運輸要求。
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
這個步驟的終點位置。
end_point
類型：  LatLng
這個步驟的終點位置。
instructions
類型：  string
這個步驟的指示。
lat_lngs
類型：  Array<LatLng>
一系列 LatLng，用於說明目前步驟的過程。這是步驟的近似 (順暢) 路徑。
maneuver
類型：  string
包含目前步驟要執行的動作 (turn-left、merge、straight 等)。值可能會變更，我們也可能在未事先通知的情況下導入新值。
path
類型：  Array<LatLng>
一系列 LatLng，用於說明目前步驟的過程。這是步驟的近似 (順暢) 路徑。
start_location
類型：  LatLng
這個步驟的起點位置。
start_point
類型：  LatLng
這個步驟的起點位置。
travel_mode
類型：  TravelMode
此步驟中使用的旅行模式。
distance optional
類型：  Distance optional
這個步驟涵蓋的距離。這項屬性可能會是 undefined，因為距離可能不明。
duration optional
類型：  Duration optional
一般執行此步驟所需的時間 (單位為秒數)，以及在文字表單中執行此步驟一般所需的時間。這項屬性可能是 undefined，因為時間長度可能不明。
polyline optional
類型：  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
地點的 Place ID (例如商家或搜尋點)。地點 ID 是 Google 地圖資料庫中地點的專屬 ID，請注意，placeId 是識別地點最準確的方式。如有可能，請指定 placeId，而非 query。您可以從任何 Places API 要求 (例如 TextSearch) 擷取地點 ID。您也可以從傳送至 Geocoding API 的要求中擷取地點 ID。詳情請參閱地點 ID 總覽。
query optional
類型：  string optional
描述地點的搜尋查詢 (例如商家或搜尋點)。例如「Quay, 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。

撥打 const {TravelMode} = await google.maps.importLibrary("routes") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
BICYCLING 指定單車導航要求。
DRIVING 指定行車導航要求。
TRANSIT 指定大眾運輸路線要求。
BetaTWO_WHEELER 指定機車路線要求。
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。

撥打 const {TrafficModel} = await google.maps.importLibrary("routes") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
BEST_GUESS 使用歷來路況資料，盡可能準確預估塞車時間。
OPTIMISTIC 根據歷來流量資料，樂觀預估交通時間。
PESSIMISTIC 使用歷來交通資料，悲觀地估算交通時間。

TransitOptions interface

google.maps.TransitOptions 介面

當交通方式設為 TRANSIT 時，要納入 DirectionsRequest 的 TransitOptions 物件。
arrivalTime optional
類型：  Date optional
路線的預計抵達時間，以 Date 物件的形式指定。Date 物件會以自 1970 年 1 月 1 日起的毫秒數計算時間。如果指定了抵達時間，則系統會忽略出發時間。
departureTime optional
類型：  Date optional
路線的預計出發時間，以 Date 物件的形式指定。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。

撥打 const {TransitMode} = await google.maps.importLibrary("routes") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
BUS 指定偏好的交通方式為公車。
BetaLIGHT_RAIL 指定輕軌為偏好的交通方式。
RAIL 指定鐵路為偏好的交通方式。
SUBWAY 指定地鐵為偏好的交通方式。
TRAIN 指定偏好的交通方式為火車。
TRAM 指定電車為偏好的交通方式。

TransitRoutePreference 常數

google.maps.TransitRoutePreference 常數

可在 TransitOptions 中指定的有效大眾運輸路線類型。您可以依值指定這些項目，也可以使用常數名稱。例如 'LESS_WALKING' 或 google.maps.TransitRoutePreference.LESS_WALKING。

撥打 const {TransitRoutePreference} = await google.maps.importLibrary("routes") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
FEWER_TRANSFERS 指定計算出的路線應優先選擇轉乘次數較少的選項。
LESS_WALKING 指定計算出的路線應優先選擇步行距離較短的選項。

TransitFare 介面

google.maps.TransitFare 介面

由值和幣別組成的 DirectionsRoute 票價。
currency
類型：  string
ISO 4217 貨幣代碼，表示票價採用的貨幣。
text
類型：  string
以指定 currency 表示的車資值 (字串)。
value
類型：  number
以指定 currency 表示的票價數值。

TransitDetails interface

google.maps.TransitDetails 介面

這個步驟的詳細資料，包括出發時間、抵達時間和使用的大眾運輸模式。
arrival_stop
類型：  TransitStop
這項大眾運輸步驟的抵達停靠站。
arrival_time
類型：  Time
這個步驟的抵達時間，以 Time 物件的形式指定。
departure_stop
類型：  TransitStop
這項大眾運輸步驟的出發停靠站。
departure_time
類型：  Time
這個步驟的出發時間，以 Time 物件的形式指定。
headsign
類型：  string
這條路線的行進方向，如交通工具或出發站上所標示的方向。
headway
類型：  number
這個停靠站的同類車輛預計間隔秒數。
line
類型：  TransitLine
目前步驟中使用的大眾運輸路線相關詳細資料。
num_stops
類型：  number
這個步驟中的停靠站數量。其中包含抵達站，但不包含出發站。
trip_short_name
類型：  string
時刻表和看板上顯示的文字，可供乘客識別大眾運輸行程，例如識別通勤列車行程的列車號碼。這段文字可做為服務當天行程的專屬 ID。

TransitStop 介面

google.maps.TransitStop 介面

大眾運輸停靠站或車站的詳細資料。
location
類型：  LatLng
這個停靠點的位置。
name
類型：  string
這個大眾運輸停靠站的名稱。

TransitLine interface

google.maps.TransitLine 介面

營運此大眾運輸步驟的路線相關資訊。
agencies
類型：  Array<TransitAgency>
營運這條大眾運輸路線的運輸公司。
color
類型：  string
這條路線常用的顏色，以十六進位字串表示。
icon
類型：  string
這條路線相關圖示的網址。
name
類型：  string
這條大眾運輸路線的全名，例如「8 Avenue Local」。
short_name
類型：  string
這條大眾運輸路線的簡稱，例如「E」。
text_color
類型：  string
這條大眾運輸路線常用的標誌文字顏色，以十六進位字串表示。
url
類型：  string
運輸公司專屬這條大眾運輸路線的網址。
vehicle
類型：  TransitVehicle
使用的交通工具類型，例如火車或公車。

TransitAgency 介面

google.maps.TransitAgency 介面

經營大眾運輸路線的機構相關資訊。
name
類型：  string
這間運輸公司的名稱。
phone
類型：  string
運輸公司的電話號碼。
url
類型：  string
運輸公司的網址。

TransitVehicle 介面

google.maps.TransitVehicle 介面

大眾運輸路線使用的交通工具相關資訊。
icon
類型：  string
與這條路線使用的交通工具類型相符的圖示網址。
local_icon
類型：  string
與該區域使用的交通工具類型相符的圖示網址，而非較為通用的圖示。
name
類型：  string
這類 TransitVehicle 的名稱，例如「火車」或「公車」。
type
類型：  VehicleType
使用的車輛類型，例如火車、公車或渡輪。

VehicleType 常數

google.maps.VehicleType 常數

車輛類型可能的值。

撥打 const {VehicleType} = await google.maps.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 中指定的有效單位系統。

撥打 const {UnitSystem} = await google.maps.importLibrary("core") 即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
IMPERIAL 指定 DirectionsResult 中的距離應以英制單位表示。
METRIC 指定 DirectionsResult 中的距離應以公制單位表示。

距離 介面

google.maps.Distance 介面

以數值和顯示字串代表距離。
text
類型：  string
距離值的字串表示法，使用要求中指定的 UnitSystem。
value
類型：  number
距離 (公制單位)。

時間長度 介面

google.maps.Duration 介面

以數值和顯示字串代表期間。
text
類型：  string
代表期間值的字串。
value
類型：  number
期間 (單位為秒數)。

時間 介面

google.maps.Time 介面

時間的表示方式，包括 Date 物件、本地化字串和時區。
text
類型：  string
代表時間值的字串。顯示的時間以大眾運輸車站所在的時區為準。
time_zone
類型：  string
這個停靠站所在的時區。這個值是時區名稱 (如 IANA 時區資料庫中所定義)，例如「America/New_York」。
value
類型：  Date
出發或抵達時間，以 JavaScript Date 物件的形式指定。

DirectionsTravelMode 常數

google.maps.DirectionsTravelMode 常數

DirectionsUnitSystem 常數

google.maps.DirectionsUnitSystem 常數