Directions

DirectionsService 類別

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
目的地位置。您可以將其指定為要進行地理編碼的字串、LatLngPlace。必填。
origin
類型:  string|LatLng|Place|LatLngLiteral
起點位置。您可以將其指定為要進行地理編碼的字串、LatLngPlace。必填。
travelMode
類型:  TravelMode
要求的路線類型。必填。
avoidFerries optional
類型:  boolean optional
如果為 true,則會指示 Directions 服務盡可能避開渡輪。選填。
avoidHighways optional
類型:  boolean optional
如果為 true,則會指示路線規劃服務盡量避開高速公路。選填。
avoidTolls optional
類型:  boolean optional
如果為 true,則會指示路線規劃服務盡可能避開收費路段。選填。
drivingOptions optional
類型:  DrivingOptions optional
僅適用於 travelModeDRIVING 的要求。這個物件不會影響其他交通模式。
language optional
類型:  string optional
語言 ID,用於指定應傳回結果的語言 (如有可能)。請參閱支援語言清單
optimizeWaypoints optional
類型:  boolean optional
如果設為 trueDirectionsService 會嘗試重新排序所提供的中繼路線點,以便盡可能降低路線的整體成本。如果路線控點已進行最佳化,請檢查回應中的 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 常數

DirectionsService 在完成對 route() 的呼叫時傳回的狀態。您可以使用值或常數名稱來指定這些值。例如 '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 類別

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)
參數: 
  • routeIndexnumber
傳回值:
設定要轉譯的 DirectionsResult 物件中路徑的索引 (從零開始)。根據預設會呈現陣列中的第一條路徑。
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
directions_changed
function()
引數:
此事件會在算繪的路線變更時觸發,例如設定新的 DirectionsResult,或是使用者完成將變更拖曳至路線時。

DirectionsRendererOptions 介面

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
路點位置。可以是地址字串、LatLngPlace。選填。
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 地圖中的特定地點。如要進一步瞭解 Place 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,而有一個中途停靠點的路線會包含兩個 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 陣列,其中每個 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-leftmergestraight 等)。值可能會變更,且我們可能會在未事先通知的情況下導入新值。
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 介面

包含用來找出、識別或描述 DirectionsRequestDistanceMatrixRequest 地點所需的資訊。在這種情況下,「地點」是指商家、搜尋點或地理位置。如要擷取地點資訊,請參閱 PlacesService

location optional
類型:  LatLng|LatLngLiteral optional
這個地點所描述實體的 LatLng
placeId optional
類型:  string optional
地點 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 無法保證解析查詢字串至地點的準確度。如果同時提供 placeIdquery,系統會發生錯誤。

TravelMode 常數

google.maps.TravelMode 常數

可在 DirectionsRequest 中指定的有效交通方式,以及 DirectionsStep 中傳回的交通方式。您可以使用值或常數名稱來指定這些值。例如 'BICYCLING'google.maps.TravelMode.BICYCLING

請呼叫 const {TravelMode} = await google.maps.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 常數

預測交通量持續時間時使用的假設。在 DirectionsRequestDistanceMatrixRequest 中指定。您可以使用值或常數名稱來指定這些值。例如 'bestguess'google.maps.TrafficModel.BEST_GUESS

請呼叫 const {TrafficModel} = await google.maps.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 物件指定。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 指定公車為偏好的大眾運輸方式。
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 貨幣代碼,表示票價採用的貨幣。
value
類型:  number
以指定 currency 表示的車資數值。

TransitDetails 介面

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
時刻表和路線指示牌上顯示的文字,可供乘客識別大眾運輸行程,例如識別通勤列車行程的列車號碼。這段文字可用於識別服務日內的行程。

TransitStop 介面

google.maps.TransitStop 介面

大眾運輸停靠站或車站的詳細資料。

location
類型:  LatLng
這個停靠站的位置。
name
類型:  string
此大眾運輸停靠站的名稱。

TransitLine 介面

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 中的距離應以公制單位表示。

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 常數