JourneySharingMapView 類別
class
google.maps.journeySharing.JourneySharingMapView
library "journeySharing"
地圖檢視畫面。
const {JourneySharingMapView} = await google.maps.importLibrary("journeySharing");
建構函式 | |
|---|---|
JourneySharingMapView |
JourneySharingMapView(options)參數:
例項化地圖檢視。 |
屬性 | |
|---|---|
automaticViewportMode |
這個欄位為唯讀。自動可視區域模式。 |
element |
類型:
Element這個欄位為唯讀。支援檢視畫面的 DOM 元素。 |
enableTraffic |
類型:
boolean啟用或停用車流量圖層。 |
locationProviders |
類型:
Array<LocationProvider> optional這個欄位為唯讀。追蹤位置的來源,會顯示在追蹤地圖檢視畫面中。如要新增或移除位置資訊提供者,請使用 JourneySharingMapView.addLocationProvider 和 JourneySharingMapView.removeLocationProvider 方法。 |
map |
類型:
Map這個欄位為唯讀。地圖檢視畫面中包含的地圖物件。 |
mapOptions |
類型:
MapOptions這個欄位為唯讀。透過地圖檢視傳入地圖的地圖選項。 |
|
類型:
LocationProvider optional這個欄位為唯讀。追蹤位置的來源,會顯示在追蹤地圖檢視畫面中。 |
|
類型:
設定目的地位置標記的選項。每當系統算繪新的目的地標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
設定起點標記的選項。每當系統算繪新的起點標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
設定工作結果位置標記的選項。每當系統算繪新的工作結果位置標記時,就會叫用這個函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
設定失敗任務位置標記的選項。每當系統顯示新的失敗任務標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
設定車輛位置標記的選項。每當轉譯新的車輛標記時,系統就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
設定路線控點位置標記的選項。每當系統算繪新的路線控點標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
設定預期路線折線的選項。每當系統算繪新的預期路線折線時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入的 defaultPolylineOptions 欄位 (包含 google.maps.PolylineOptions 物件),並在輸出 PolylineSetupOptions 物件中以 polylineOptions 形式傳回。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用同一個 PolylineSetupOptions 物件,也不要在不同 PolylineSetupOptions 物件中,為 polylineOptions 鍵重複使用同一個 google.maps.PolylineOptions 物件。如果 polylineOptions 或 visible 未設定或為空值,系統會以預設值覆寫。系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。 |
|
類型:
設定所選路線折線的選項。每當系統轉譯新的行經路線折線時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入的 defaultPolylineOptions 欄位 (包含 google.maps.PolylineOptions 物件),並在輸出 PolylineSetupOptions 物件中以 polylineOptions 形式傳回。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用同一個 PolylineSetupOptions 物件,也不要在不同 PolylineSetupOptions 物件中,為 polylineOptions 鍵重複使用同一個 google.maps.PolylineOptions 物件。 系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。任何未設定或空值都會覆寫為預設值。 |
|
類型:
設定偵測點位置標記的選項。每當系統算繪新的偵測標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
設定成功任務位置標記的選項。每當成功算繪新的工作標記時,系統就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
傳回目的地標記 (如有)。 |
|
傳回起點標記 (如有)。 |
|
傳回成功的工作標記 (如有)。 |
|
傳回工作結果標記 (如果有的話)。 |
|
傳回失敗的工作標記 (如有)。 |
|
傳回車輛標記 (如有)。 |
|
傳回路線控點標記 (如有)。 |
|
傳回預期路線折線 (如有)。 |
|
傳回行經路線折線 (如有)。 |
方法 | |
|---|---|
addLocationProvider |
addLocationProvider(locationProvider)參數:
傳回值:無
在地圖檢視畫面中新增位置資訊提供者。如果已新增位置資訊提供者,系統不會執行任何動作。 |
removeLocationProvider |
removeLocationProvider(locationProvider)參數:
傳回值:無
從地圖檢視畫面中移除位置資訊提供者。如果地圖檢視畫面尚未加入位置資訊提供者,系統就不會執行任何動作。 |
JourneySharingMapViewOptions 介面
介面
google.maps.journeySharing.JourneySharingMapViewOptions
地圖檢視畫面的選項。
屬性 | |
|---|---|
element |
類型:
Element支援檢視畫面的 DOM 元素。必填。 |
選填 |
類型:
設定預期路線折線的選項。每當系統算繪新的預期路線折線時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入的 defaultPolylineOptions 欄位 (包含 google.maps.PolylineOptions 物件),並在輸出 PolylineSetupOptions 物件中以 polylineOptions 形式傳回。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用同一個 PolylineSetupOptions 物件,也不要在不同 PolylineSetupOptions 物件中,為 polylineOptions 鍵重複使用同一個 google.maps.PolylineOptions 物件。如果 polylineOptions 或 visible 未設定或為空值,系統會以預設值覆寫。系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。 |
automaticViewportMode
選填 |
類型:
AutomaticViewportMode optional自動可視區域模式。預設值為 FIT_ANTICIPATED_ROUTE,可讓地圖檢視畫面自動調整可視區域,以容納車輛標記、位置標記,以及任何可見的預期路線折線。將此值設為 NONE,即可關閉自動調整功能。 |
選填 |
類型:
設定目的地位置標記的選項。每當系統算繪新的目的地標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
選填 |
類型:
LocationProvider optional追蹤位置的來源,會顯示在追蹤地圖檢視畫面中。選用項目。 |
locationProviders
選填 |
類型:
Array<LocationProvider> optional追蹤位置的來源,會顯示在追蹤地圖檢視畫面中。選用項目。 |
mapOptions
選填 |
類型:
MapOptions optional傳入 google.maps.Map 建構函式的地圖選項。 |
選填 |
類型:
設定起點標記的選項。每當系統算繪新的起點標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
選填 |
類型:
設定偵測點位置標記的選項。每當系統算繪新的偵測標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
選填 |
類型:
設定成功任務位置標記的選項。每當成功算繪新的工作標記時,系統就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
選填 |
類型:
設定所選路線折線的選項。每當系統轉譯新的行經路線折線時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入的 defaultPolylineOptions 欄位 (包含 google.maps.PolylineOptions 物件),並在輸出 PolylineSetupOptions 物件中以 polylineOptions 形式傳回。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用同一個 PolylineSetupOptions 物件,也不要在不同 PolylineSetupOptions 物件中,為 polylineOptions 鍵重複使用同一個 google.maps.PolylineOptions 物件。 系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。任何未設定或空值都會覆寫為預設值。 |
選填 |
類型:
設定工作結果位置標記的選項。每當系統算繪新的工作結果位置標記時,就會叫用這個函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
選填 |
類型:
設定失敗任務位置標記的選項。每當系統顯示新的失敗任務標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
選填 |
類型:
設定車輛位置標記的選項。每當轉譯新的車輛標記時,系統就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
選填 |
類型:
設定路線控點位置標記的選項。每當系統算繪新的路線控點標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (包含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
AutomaticViewportMode 常數
constants
google.maps.journeySharing.AutomaticViewportMode
library "journeySharing"
自動可視區域模式。
這些常數也可以做為字串使用。在 TypeScript 中,字串常值是由 AutomaticViewportModeString 類型定義。
const {AutomaticViewportMode} = await google.maps.importLibrary("journeySharing");
常數 | |
|---|---|
FIT_ANTICIPATED_ROUTE |
自動調整可視區域,以容納標記和任何可見的預期路線折線。此為預設值。 |
NONE |
不要自動調整可視區域。 |
LocationProvider 抽象類別
抽象類別
google.maps.journeySharing.LocationProvider
由 FleetEngineDeliveryFleetLocationProvider, FleetEngineDeliveryVehicleLocationProvider, FleetEngineFleetLocationProvider, FleetEngineShipmentLocationProvider, FleetEngineTripLocationProvider, FleetEngineVehicleLocationProvider, PollingLocationProvider 擴充
所有位置供應器的父項類別。
方法 | |
|---|---|
addListener |
addListener(eventName, handler)參數:
傳回值:
MapsEventListener為這個位置供應器觸發的事件新增 MapsEventListener。傳回這個事件監聽器的 ID,可與 event.removeListener 搭配使用。 |
PollingLocationProvider 抽象類別
abstract class
google.maps.journeySharing.PollingLocationProvider
extends LocationProvider
extended by FleetEngineDeliveryFleetLocationProvider, FleetEngineDeliveryVehicleLocationProvider, FleetEngineFleetLocationProvider, FleetEngineShipmentLocationProvider, FleetEngineTripLocationProvider, FleetEngineVehicleLocationProvider
投票地點提供者的父項類別。
屬性 | |
|---|---|
isPolling |
類型:
boolean如果這個位置資訊提供者正在輪詢,則為 True。唯讀。 |
pollingIntervalMillis |
類型:
number擷取位置更新的最短時間間隔 (以毫秒為單位)。如果擷取位置更新的時間超過 pollingIntervalMillis,系統會等到目前的位置更新完成後,才會開始下一次位置更新。如果將這個值設為 0、無限大或負值,系統會停用自動位置更新功能。如果追蹤 ID 參數 (例如運送位置資訊供應商的運送追蹤 ID) 或篩選選項 (例如車隊位置資訊供應商的可視區域邊界或屬性篩選器) 變更,系統會擷取一次新的位置更新通知。 預設和最短輪詢時間間隔為 5000 毫秒。如果將輪詢時間間隔設為較低的正值,系統會儲存並使用 5000。 |
方法 | |
|---|---|
沿用:
addListener
|
事件 | |
|---|---|
ispollingchange |
function(event)引數:
位置資訊供應器的輪詢狀態更新時,系統會觸發這個事件。使用 PollingLocationProvider.isPolling 判斷目前的輪詢狀態。 |
PollingLocationProviderIsPollingChangeEvent 介面
介面
google.maps.journeySharing.PollingLocationProviderIsPollingChangeEvent
PollingLocationProvider.ispollingchange 事件觸發時,傳遞至事件處理常式的事件物件。
屬性 | |
|---|---|
error
選填 |
類型:
Error optional如果狀態變更是由錯誤造成,則為導致輪詢狀態變更的錯誤。如果狀態變更是因為正常作業,則未定義。 |