Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

Directions (deprecated)

DirectionsService 類別

class google.maps.DirectionsService
library "routes"

const {DirectionsService} = await google.maps.importLibrary("routes");

建構函式
`DirectionsService`	`DirectionsService()` 參數：無建立新的 `DirectionsService` 執行個體，將路線查詢傳送至 Google 伺服器。

方法
`route`	`route(request[, callback])` 參數： `request: DirectionsRequest` `callback: function(DirectionsResult optional, DirectionsStatus): void optional` 傳回值： `Promise<DirectionsResult>` 發出路線搜尋要求。

DirectionsRequest 介面

介面 google.maps.DirectionsRequest

要傳送至 DirectionsService 的路線查詢。

屬性
`destination`	類型： `string\|LatLng\|Place\|LatLngLiteral` 目的地位置。您可以指定要進行地理編碼的字串、`LatLng` 或 `Place`。必填。
`origin`	類型： `string\|LatLng\|Place\|LatLngLiteral` 起點位置。您可以指定要進行地理編碼的字串、`LatLng` 或 `Place`。必填。
`travelMode`	類型： `TravelMode` 要求的路線類型。必填。
`avoidFerries` 選填	類型： `boolean optional` 如果設為 `true`，則指示路線服務盡可能避開渡輪。選用項目。
`avoidHighways` 選填	類型： `boolean optional` 如果為 `true`，則指示路線規劃服務盡可能避開高速公路。選用項目。
`avoidTolls` 選填	類型： `boolean optional` 如果設為 `true`，則指示路線規劃服務盡可能避開收費路段。選用項目。
`drivingOptions` 選填	類型： `DrivingOptions optional` 僅適用於 `travelMode` 為 `DRIVING` 的請求設定。這個物件不會影響其他交通工具。
`language` 選填	類型： `string optional` 語言 ID，用於指定傳回結果時應盡可能使用的語言。請參閱支援語言清單。
`optimizeWaypoints` 選填	類型： `boolean optional` 如果設為 `true`，`DirectionsService` 會嘗試重新排序提供的中途路線控點，盡可能降低路線的整體費用。如果路線控點已最佳化，請檢查回應中的 `DirectionsRoute.waypoint_order`，判斷新的順序。
`provideRouteAlternatives` 選填	類型： `boolean optional` 無論是否提供替代路徑。選用項目。
`region` 選填	類型： `string optional` 用於地理編碼要求自訂調整的區域代碼。區碼接受 ccTLD (「頂層網域」) 的兩位字元值。多數 ccTLD 代碼與 ISO 3166-1 代碼相同，只有少數例外。舉例來說，英國的 ccTLD 是「uk」(`.co.uk`)，而 ISO 3166-1 代碼則是「gb」(技術上代表「大不列顛暨北愛爾蘭聯合王國」)。
`transitOptions` 選填	類型： `TransitOptions optional` 僅適用於 `travelMode` 為 TRANSIT 的要求。這個物件不會影響其他交通工具。
`unitSystem` 選填	類型： `UnitSystem optional` 預設：起點國家/地區使用的單位系統。顯示距離時使用的常用單位系統。
`waypoints` 選填	類型： `Array<DirectionsWaypoint> optional` 中間路點陣列。系統會根據這個陣列中的每個路線控點，計算從起點到目的地的路線。如要瞭解路線控點數量上限，請參閱開發人員指南。大眾運輸路線不支援路線控點。選用項目。

DirectionsStatus 常數

constants google.maps.DirectionsStatus
library "routes"

呼叫 route() 完成後，DirectionsService 傳回的狀態。請依值或使用常數名稱指定這些值。例如 'OK' 或 google.maps.DirectionsStatus.OK。

這些常數也可以做為字串使用。在 TypeScript 中，字串常值是由 DirectionsStatusString 類型定義。

const {DirectionsStatus} = await google.maps.importLibrary("routes");

常數
`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 Maps Platform 服務條款》規定，顯示警告和著作權資訊。請注意，雖然這個結果「類似 JSON」，但並非嚴格意義上的 JSON，因為它間接包含 LatLng 物件。

屬性
`request`	類型： `DirectionsRequest` 產生這項結果的 DirectionsRequest。
`routes`	類型： `Array<DirectionsRoute>` `DirectionsRoute` 陣列，每個陣列都包含其組成的路段和步驟相關資訊。除非 `DirectionsRequest` 是在 `provideRouteAlternatives` 設為 `true` 的情況下建立，否則只會有一條路線。
`available_travel_modes` 選填	類型： `Array<TravelMode> optional` 包含可用交通方式的陣列。如果要求指定了交通方式，但未取得任何結果，系統就會傳回這個欄位。陣列包含指定路線控點組合所在國家/地區可用的交通方式。如果有一或多個路線控點是「途經路線控點」，系統就不會傳回這個欄位。
`geocoded_waypoints` 選填	類型： `Array<DirectionsGeocodedWaypoint> optional` `DirectionsGeocodedWaypoint` 陣列，每個陣列皆包含起點、目的地和路線控點地理編碼的相關資訊。

DirectionsRenderer 類別

class google.maps.DirectionsRenderer extends MVCObject
library "routes"

const {DirectionsRenderer} = await google.maps.importLibrary("routes");

建構函式
`DirectionsRenderer`	`DirectionsRenderer([opts])` 參數： `opts: DirectionsRendererOptions optional` 使用指定的選項建立轉譯器。路線規劃結果可以顯示在地圖上 (以視覺疊加層的形式)，或顯示在 `<div>` 面板上 (以文字指示的形式)。

方法
`getDirections`	`getDirections()` 參數：無傳回值： `DirectionsResult\|null` 傳回轉譯器目前的路線集。
`getMap`	`getMap()` 參數：無傳回值： `Map\|null` 傳回 `DirectionsResult` 算繪的地圖。
`getPanel`	`getPanel()` 參數：無傳回值： `HTMLElement\|null` 傳回顯示 `DirectionsResult` 的面板 `<div>`。
`getRouteIndex`	`getRouteIndex()` 參數：無傳回值： `number` 傳回這個 `DirectionsRenderer` 物件目前使用的路線索引 (從零開始)。
`setDirections`	`setDirections(directions)` 參數： `directions: DirectionsResult optional` 傳回值：無將轉譯器設為使用 `DirectionsService` 的結果。如果以這種方式設定有效的路線集，則會在轉譯器指定的地圖和面板上顯示路線。
`setMap`	`setMap(map)` 參數： `map: Map optional` 傳回值：無這個方法可指定呈現路線的地圖。傳遞 `null` 即可從地圖中移除路線。
`setOptions`	`setOptions(options)` 參數： `options: DirectionsRendererOptions optional` 傳回值：無初始化後，變更這個 `DirectionsRenderer` 的選項設定。
`setPanel`	`setPanel(panel)` 參數： `panel: HTMLElement optional` 傳回值：無這個方法會在 `<div>` 中算繪路線。傳遞 `null` 即可從面板中移除內容。
`setRouteIndex`	`setRouteIndex(routeIndex)` 參數： `routeIndex: number` 傳回值：無在要算繪的 `DirectionsResult` 物件中，設定路線的索引 (從零開始)。根據預設會呈現陣列中的第一條路徑。
繼承： `addListener`、`bindTo`、`get`、`notify`、`set`、`setValues`、`unbind`、`unbindAll`

事件
`directions_changed`	`function()` 引數：無當轉譯的路線變更時，無論是設定新的 `DirectionsResult`，還是使用者完成拖曳變更路線，都會觸發這個事件。

DirectionsRendererOptions 介面

介面 google.maps.DirectionsRendererOptions

這個物件定義了可在 DirectionsRenderer 物件上設定的屬性。

屬性
`directions` 選填	類型： `DirectionsResult optional` 要顯示在地圖和/或 `<div>` 面板中的路線，從 `DirectionsService` 擷取為 `DirectionsResult` 物件。
`draggable` 選填	類型： `boolean optional` 如果設為 `true`，使用者就能拖曳及修改這個 `DirectionsRenderer` 算繪的路線路徑。
`hideRouteList` 選填	類型： `boolean optional` 預設值： `false` 這項屬性會指出轉譯器是否應在路線面板中，提供使用者可選取的路線清單。
`infoWindow` 選填	類型： `InfoWindow optional` 點選標記時，用於顯示文字資訊的 `InfoWindow`。將會覆寫現有資訊視窗內容，同時移動其位置。如未指定資訊視窗，`DirectionsRenderer` 會建立並使用自己的資訊視窗。如果 `suppressInfoWindows` 設為 `true`，系統會忽略這項屬性。
`map` 選填	類型： `Map optional` 要顯示導航的地圖。
`markerOptions` 選填	類型： `MarkerOptions optional` 標記選項。`DirectionsRenderer` 算繪的所有標記都會使用這些選項。
`panel` 選填	類型： `HTMLElement optional` 用於顯示路線步驟的 `<div>`。
`polylineOptions` 選填	類型： `PolylineOptions optional` 折線選項。`DirectionsRenderer` 算繪的所有折線都會使用這些選項。
`preserveViewport` 選填	類型： `boolean optional` 預設值： `false` 如果這個選項設為 `true`，或從未設定地圖的中心和縮放，輸入地圖會根據這組路線的定界框，設定中心和縮放。
`routeIndex` 選填	類型： `number optional` `DirectionsResult` 物件中路線的索引。預設值為 0。
`suppressBicyclingLayer` 選填	類型： `boolean optional` 要求單車路線時，不顯示 `BicyclingLayer`。
`suppressInfoWindows` 選填	類型： `boolean optional` 停止呈現資訊視窗。
`suppressMarkers` 選填	類型： `boolean optional` 停止呈現標記。
`suppressPolylines` 選填	類型： `boolean optional` 停止呈現折線。

DirectionsWaypoint 介面

介面 google.maps.DirectionsWaypoint

DirectionsWaypoint 代表起點和目的地之間的位置，行程應經過該位置。

屬性
`location` 選填	類型： `string\|LatLng\|LatLngLiteral\|Place optional` 路點位置。可以是地址字串、`LatLng` 或 `Place`。選用項目。
`stopover` 選填	類型： `boolean optional` 預設值： `true` 如果為 `true`，表示這個路線控點是起點和目的地之間的停靠點。這會將路線一分為二。如果為 `false`，表示路線應偏向經過這個路線控點，但不會分割成兩個路段。如果想根據使用者在地圖上拖曳路線控點的動作建立路線，這項功能就非常實用。

DirectionsGeocodedWaypoint 介面

介面 google.maps.DirectionsGeocodedWaypoint

單一地理編碼路線控點。

屬性
`partial_match` 選填	類型： `boolean optional` 地理編碼器是否未傳回與原始路線控點完全比對的結果，但可以比對部分要求的地址。
`place_id` 選填	類型： `string optional` 與路線控點相關聯的地點 ID。地點 ID 可以用來辨識 Google 地點介面集資料庫和 Google 地圖中的特定地點。如要進一步瞭解地點 ID，請參閱 Places API 開發人員指南。
`types` 選填	類型： `Array<string> optional` 註明傳回地理編碼元素類型的字串陣列。如需可能字串的清單，請參閱開發人員指南的「地址元件類型」一節。

DirectionsRoute 介面

介面 google.maps.DirectionsRoute

單一路線，包含 DirectionsResult 中的一組路段。請注意，雖然這個物件「類似 JSON」，但並非嚴格意義上的 JSON，因為它直接和間接包含 LatLng 物件。

屬性
`bounds`	類型： `LatLngBounds` 這個路線的界限。
`copyrights`	類型： `string` 這個路線要顯示的版權文字。
`legs`	類型： `Array<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`，這個欄位會包含輸入路線控點重新排序後的排列組合。舉例來說，如果輸入內容為：起點：洛杉磯路線控點：達拉斯、班戈、鳳凰城目的地：紐約且最佳化輸出內容的排序如下：起點：洛杉磯路線控點：鳳凰城、達拉斯、班戈目的地：紐約則這個欄位會是包含值 [2, 0, 1] 的 `Array`。請注意，路點的編號以零為基準。如果任何輸入路線控點的 `stopover` 設為 `false`，這個欄位就會留空，因為這類查詢不支援路線最佳化。
`fare` 選填	類型： `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` 選填	類型： `Time optional` 這個路段的預計抵達時間。僅適用於 TRANSIT 要求。
`departure_time` 選填	類型： `Time optional` 這個路段的預計出發時間。僅適用於 TRANSIT 要求。
`distance` 選填	類型： `Distance optional` 這個航段涵蓋的總距離。因為距離不明，這個屬性可能未定義。
`duration` 選填	類型： `Duration optional` 這個航段的總期間。如果時間長度不明，這個屬性可能為 `undefined`。
`duration_in_traffic` 選填	類型： `Duration optional` 這個路段所需的總時間，會考量 `trafficModel` 屬性指出的路況。如果時間長度不明，這個屬性可能為 `undefined`。

DirectionsStep 介面

介面 google.maps.DirectionsStep

DirectionsResult 中的單一 DirectionsStep。部分欄位可能為 undefined。請注意，雖然這個物件「類似 JSON」，但並非嚴格意義上的 JSON，因為它直接包含 LatLng 物件。

屬性
`encoded_lat_lngs`	類型： `string` 步驟的編碼折線表示法。這是步驟的近似 (順暢) 路徑。
`end_location`	類型： `LatLng` 這個步驟的終點位置。
`end_point`	已淘汰：請使用 `DirectionsStep.end_location`。類型： `LatLng` 這個步驟的終點位置。
`instructions`	類型： `string` 這個步驟的指示。
`lat_lngs`	已淘汰：請使用 `DirectionsStep.path`。類型： `Array<LatLng>` `LatLng` 序列，用於說明目前步驟的過程。這是步驟的近似 (順暢) 路徑。
`maneuver`	類型： `string` 包含目前步驟要採取的動作 (`turn-left`、`merge`、`straight` 等)。值可能會變更，我們也可能在未事先通知的情況下導入新值。
`path`	類型： `Array<LatLng>` `LatLng` 序列，用於說明目前步驟的過程。這是步驟的近似 (順暢) 路徑。
`start_location`	類型： `LatLng` 這個步驟的起點位置。
`start_point`	已淘汰：請使用 `DirectionsStep.start_location`。類型： `LatLng` 這個步驟的起點位置。
`travel_mode`	類型： `TravelMode` 此步驟中使用的旅行模式。
`distance` 選填	類型： `Distance optional` 這個步驟涵蓋的距離。如果距離不明，這個屬性可能會是 `undefined`。
`duration` 選填	類型： `Duration optional` 一般執行此步驟所需的時間 (單位為秒數)，以及在文字表單中執行此步驟一般所需的時間。如果時間長度不明，這個屬性可能為 `undefined`。
`polyline` 選填	已淘汰：請使用 `DirectionsStep.encoded_lat_lngs`。類型： `DirectionsPolyline optional` 包含具有單一屬性「points」的物件，其中包含步驟的編碼折線表示法。這條折線是步驟的近似 (順暢) 路徑。
`steps` 選填	類型： `Array<DirectionsStep> optional` 這個步驟的子步驟。指定大眾運輸路線的非大眾運輸路段。
`transit` 選填	類型： `TransitDetails optional` 這個步驟的大眾運輸專屬詳細資料。除非這個步驟的交通方式是 `TRANSIT`，否則不會定義這個屬性。
`transit_details` 選填	類型： `TransitDetails optional` 如果交通方式為 `TRANSIT`，則為這個步驟的相關詳細資料。

DirectionsPolyline 介面

介面 google.maps.DirectionsPolyline

包含 points 屬性的物件，用於描述 DirectionsStep 的折線。

屬性
`points`	類型： `string` 編碼折線。

Place 介面

介面 google.maps.Place

包含 DirectionsRequest 或 DistanceMatrixRequest 的地點定位、識別或描述資訊。在這種情況下，「地點」是指商家、搜尋點或地理位置。如要擷取地點相關資訊，請參閱 PlacesService。

屬性
`location` 選填	類型： `LatLng\|LatLngLiteral optional` 這個地點描述的實體 `LatLng`。
`placeId` 選填	類型： `string optional` 地點 (例如商家或搜尋點) 的地點 ID。地點 ID 是 Google 地圖資料庫中地點的專屬 ID。請注意，`placeId` 是識別地點最準確的方式。建議您盡可能指定 `placeId`，而非 `query`。您可以透過向 Places API 發出的任何要求 (例如 TextSearch) 擷取地點 ID。您也可以透過向 Geocoding API 傳送要求，擷取地點 ID。詳情請參閱地點 ID 總覽。
`query` 選填	類型： `string optional` 描述地點 (例如商家或搜尋點) 的搜尋查詢。查詢範例：「Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW」。建議您盡可能指定 `placeId`，而非 `query`。API 不保證能準確將查詢字串解析為地點。如果同時提供 `placeId` 和 `query`，系統會發生錯誤。

TravelMode 常數

constants google.maps.TravelMode
library "routes"

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

這些常數也可以做為字串使用。在 TypeScript 中，字串常值是由 TravelModeString 類型定義。

const {TravelMode} = await google.maps.importLibrary("routes");

常數
`BICYCLING`	指定單車導航要求。
`DRIVING`	指定行車導航要求。
`TRANSIT`	指定大眾運輸路線要求。
`TWO_WHEELER`	注意：僅適用於 v=beta 版。指定兩輪車路線要求。
`WALKING`	指定步行導航要求。

DrivingOptions 介面

介面 google.maps.DrivingOptions

當交通方式設為 DRIVING 時，設定 DirectionsRequest。

屬性
`departureTime`	類型： `Date` 路線的出發時間，以 `Date` 物件指定。`Date` 物件會以毫秒為單位，測量自 1970 年 1 月 1 日起的時間。必須指定這項屬性，`DrivingOptions` 才會生效。出發時間必須設為目前時間或未來時間，不得設為過去的日期。
`trafficModel` 選填	類型： `TrafficModel optional` 預測車程時間時，偏好使用的假設。預設為 `BEST_GUESS`。

TrafficModel 常數

constants google.maps.TrafficModel
library "routes"

預測車程時間時使用的假設。指定為 DirectionsRequest 或 DistanceMatrixRequest 的一部分。請依值或使用常數名稱指定這些值。例如 'bestguess' 或 google.maps.TrafficModel.BEST_GUESS。

這些常數也可以做為字串使用。在 TypeScript 中，字串常值是由 TrafficModelString 類型定義。

const {TrafficModel} = await google.maps.importLibrary("routes");

常數
`BEST_GUESS`	使用歷來交通資料，盡可能準確估算塞車時間。
`OPTIMISTIC`	根據歷來車流量資料，樂觀預估車流量持續時間。
`PESSIMISTIC`	使用歷來車流量資料，悲觀預估車流量中的車程時間。

TransitOptions 介面

介面 google.maps.TransitOptions

當交通方式設為 TRANSIT 時，要納入 DirectionsRequest 的 TransitOptions 物件。

屬性
`arrivalTime` 選填	類型： `Date optional` 路線的預計抵達時間，以 Date 物件指定。Date 物件會以毫秒為單位，測量自 1970 年 1 月 1 日起的時間。如果指定了抵達時間，則系統會忽略出發時間。
`departureTime` 選填	類型： `Date optional` 路線的預計出發時間，以 Date 物件的形式指定。Date 物件會以毫秒為單位，測量自 1970 年 1 月 1 日起的時間。如未指定出發時間或抵達時間，系統會假設時間為「現在」。
`modes` 選填	類型： `Array<TransitMode> optional` 一或多種偏好的交通方式，例如公車或火車。如果未指定偏好設定，API 會傳回預設的最佳路線。
`routingPreference` 選填	類型： `TransitRoutePreference optional` 可影響大眾運輸路線選擇的偏好設定，例如步行距離較短。如果未指定偏好設定，API 會傳回預設的最佳路線。

TransitMode 常數

constants google.maps.TransitMode
library "routes"

可在 TransitOptions 中指定有效的大眾運輸模式，例如公車。請依值或使用常數名稱指定這些值。例如 'BUS' 或 google.maps.TransitMode.BUS。

這些常數也可以做為字串使用。在 TypeScript 中，字串常值是由 TransitModeString 類型定義。

const {TransitMode} = await google.maps.importLibrary("routes");

常數
`BUS`	指定公車為偏好的交通方式。
`LIGHT_RAIL`	注意：僅適用於 v=beta 版。指定輕軌電車為偏好的交通方式。
`RAIL`	指定鐵路為偏好的交通方式。
`SUBWAY`	指定地鐵為偏好的交通方式。
`TRAIN`	指定火車為偏好的交通方式。
`TRAM`	指定電車為偏好的交通方式。

TransitRoutePreference 常數

constants google.maps.TransitRoutePreference
library "routes"

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

這些常數也可以做為字串使用。在 TypeScript 中，字串常值是由 TransitRoutePreferenceString 類型定義。

const {TransitRoutePreference} = await google.maps.importLibrary("routes");

常數
`FEWER_TRANSFERS`	指定計算出的路線應優先選擇轉乘次數較少的選項。
`LESS_WALKING`	指定計算出的路線應優先選擇步行距離較短的選項。

TransitFare 介面

介面 google.maps.TransitFare

DirectionsRoute 的票價，包含金額和幣別。

屬性
`currency`	類型： `string` ISO 4217 貨幣代碼，表示票價採用的貨幣。
`text`	類型： `string` 車資值，以指定的 `currency` 表示，格式為字串。
`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 常數

constants google.maps.VehicleType
library "routes"

交通工具類型的可能值。

這些常數也可以做為字串使用。在 TypeScript 中，字串常值是由 VehicleTypeString 類型定義。

const {VehicleType} = await google.maps.importLibrary("routes");

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

constants google.maps.UnitSystem
library "core"

可在 DirectionsRequest 中指定的有效單位系統。

const {UnitSystem} = await google.maps.importLibrary("core");

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

以 Date 物件、本地化字串和時區表示時間。

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