Map View

JourneysharingMapView 類別

google.maps.journeySharing.JourneySharingMapView 類別

地圖檢視。

呼叫 const {JourneySharingMapView} = await google.maps.importLibrary("journeySharing") 即可存取。請參閱 Maps JavaScript API 中的程式庫

JourneySharingMapView
JourneySharingMapView(options)
參數: 
將地圖檢視執行個體化。
anticipatedRoutePolylines
類型:  Array<Polyline>
傳回預期路徑折線 (如果有的話)。
anticipatedRoutePolylineSetup
類型:  PolylineSetup
設定預期路徑折線的選項。每當顯示新的預期路徑折線時,就會叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.PolylineOptions 物件的輸入預設 PolylineOptions 欄位,並在輸出 PolylineSetupOptions 物件中,以 PolylineOptions 的形式傳回。

指定 PolylineSetupOptions 物件的效果等同於指定傳回該靜態物件的函式。

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中,將 PolylineOptions 鍵值用於 polylineOptions 鍵。如果 PolylineOptions 或可見,未設定或為空值,就會以預設值覆寫。系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的值。
automaticViewportMode
這是唯讀欄位。自動可視區域模式。
element
類型:  Element
這是唯讀欄位。支援檢視畫面的 DOM 元素。
enableTraffic
類型:  boolean
啟用或停用路況圖層。
locationProvider
類型:  LocationProvider
這是唯讀欄位。要顯示在追蹤地圖檢視中的追蹤位置來源。
map
類型:  Map
這是唯讀欄位。地圖檢視中包含的地圖物件。
mapOptions
類型:  MapOptions
這是唯讀欄位。透過地圖檢視傳送到地圖的地圖選項。
takenRoutePolylines
類型:  Array<Polyline>
傳回所擷取的路徑折線 (如果有的話)。
takenRoutePolylineSetup
類型:  PolylineSetup
設定採用的路線折線折線選項。在每次轉譯新的新路徑折線時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.PolylineOptions 物件的輸入預設 PolylineOptions 欄位,並在輸出 PolylineSetupOptions 物件中,以 PolylineOptions 的形式傳回。

指定 PolylineSetupOptions 物件的效果等同於指定傳回該靜態物件的函式。

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中,將 PolylineOptions 鍵值用於 polylineOptions 鍵。

系統會忽略任何為 polylineOptions.map 或 polylineOptions.path 設定的值。任何預設值或空值都會以預設值覆寫。
destinationMarkerSetup
類型:  MarkerSetup
設定目的地位置標記的選項。每次顯示新的目的地標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
originMarkerSetup
類型:  MarkerSetup
為起點位置標記設定選項。每次顯示新的來源標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
pingMarkerSetup
類型:  MarkerSetup
設定連線偵測 (ping) 位置標記的選項。每次顯示新的 ping 標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
successfulTaskMarkerSetup
類型:  MarkerSetup
設定成功的工作位置標記選項。每次成功顯示新的工作標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
taskOutcomeMarkerSetup
類型:  MarkerSetup
設定工作結果位置標記的選項。每次顯示新的工作結果位置標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
unsuccessfulTaskMarkerSetup
類型:  MarkerSetup
為失敗的工作地點標記設定選項。每當顯示新的失敗工作標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
vehicleMarkerSetup
類型:  MarkerSetup
設定車輛位置標記的選項。每次顯示新車輛標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
waypointMarkerSetup
類型:  MarkerSetup
設定路線控點位置標記的選項。每次顯示新的路線控點標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
destinationMarkers
類型:  Array<Marker>
傳回目的地標記 (如果有的話)。
originMarkers
類型:  Array<Marker>
傳回來源標記 (如果有的話)。
successfulTaskMarkers
類型:  Array<Marker>
傳回成功的工作標記 (如果有的話)。
taskOutcomeMarkers
類型:  Array<Marker>
傳回工作結果標記 (如果有的話)。
unsuccessfulTaskMarkers
類型:  Array<Marker>
傳回失敗的工作標記 (如果有的話)。
vehicleMarkers
類型:  Array<Marker>
傳回車輛標記 (如果有的話)。
waypointMarkers
類型:  Array<Marker>
傳迴路線控點標記 (如果有的話)。

JourneysharingMapViewOptions 介面

google.maps.journeySharing.JourneySharingMapViewOptions 介面

地圖檢視的選項。

element
類型:  Element
支援檢視畫面的 DOM 元素。這是必填欄位。
locationProvider
類型:  LocationProvider
要顯示在追蹤地圖檢視中的追蹤位置來源。這是必填欄位。
anticipatedRoutePolylineSetup optional
類型:  PolylineSetup optional
設定預期路徑折線的選項。每當顯示新的預期路徑折線時,就會叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.PolylineOptions 物件的輸入預設 PolylineOptions 欄位,並在輸出 PolylineSetupOptions 物件中,以 PolylineOptions 的形式傳回。

指定 PolylineSetupOptions 物件的效果等同於指定傳回該靜態物件的函式。

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中,將 PolylineOptions 鍵值用於 polylineOptions 鍵。如果 PolylineOptions 或可見,未設定或為空值,就會以預設值覆寫。系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的值。
automaticViewportMode optional
類型:  AutomaticViewportMode optional
自動可視區域模式。預設值為 FIT_ANTICIPATED_ROUTE,可讓地圖檢視自動調整可視區域,以配合車輛標記、位置標記以及任何可見的預期路徑折線。設為「無」即可關閉自動調節功能。
destinationMarkerSetup optional
類型:  MarkerSetup optional
設定目的地位置標記的選項。每次顯示新的目的地標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
mapOptions optional
類型:  MapOptions optional
傳送至 google.maps.Map 建構函式的地圖選項。
originMarkerSetup optional
類型:  MarkerSetup optional
為起點位置標記設定選項。每次顯示新的來源標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
pingMarkerSetup optional
類型:  MarkerSetup optional
設定連線偵測 (ping) 位置標記的選項。每次顯示新的 ping 標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
successfulTaskMarkerSetup optional
類型:  MarkerSetup optional
設定成功的工作位置標記選項。每次成功顯示新的工作標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
takenRoutePolylineSetup optional
類型:  PolylineSetup optional
設定採用的路線折線折線選項。在每次轉譯新的新路徑折線時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.PolylineOptions 物件的輸入預設 PolylineOptions 欄位,並在輸出 PolylineSetupOptions 物件中,以 PolylineOptions 的形式傳回。

指定 PolylineSetupOptions 物件的效果等同於指定傳回該靜態物件的函式。

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中,將 PolylineOptions 鍵值用於 polylineOptions 鍵。

系統會忽略任何為 polylineOptions.map 或 polylineOptions.path 設定的值。任何預設值或空值都會以預設值覆寫。
taskOutcomeMarkerSetup optional
類型:  MarkerSetup optional
設定工作結果位置標記的選項。每次顯示新的工作結果位置標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
unsuccessfulTaskMarkerSetup optional
類型:  MarkerSetup optional
為失敗的工作地點標記設定選項。每當顯示新的失敗工作標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
vehicleMarkerSetup optional
類型:  MarkerSetup optional
設定車輛位置標記的選項。每次顯示新車輛標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。
waypointMarkerSetup optional
類型:  MarkerSetup optional
設定路線控點位置標記的選項。每次顯示新的路線控點標記時叫用。

在指定函式時,該函式可以且應該修改包含 google.maps.MarkerOptions 物件的輸入預設 MarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中,將其傳回 MarkOptions。

指定 MarkerSetupOptions 物件的效果與指定該靜態物件的函式相同。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用 MarkOptions 鍵的同一個 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。

AutomaticViewportMode 常數

google.maps.journeySharing.AutomaticViewportMode 常數

自動可視區域模式。

呼叫 const {AutomaticViewportMode} = await google.maps.importLibrary("journeySharing") 即可存取。請參閱 Maps JavaScript API 中的程式庫

FIT_ANTICIPATED_ROUTE 自動調整可視區域,以符合標記和任何可見的預期路徑折線。此為預設值。
NONE 不要自動調整可視區域。

LocationProvider 抽象類別

google.maps.journeySharing.LocationProvider 抽象類別

所有位置提供者的父項類別。

addListener
addListener(eventName, handler)
參數: 
  • eventNamestring要監聽的事件名稱。
  • handlerFunction事件處理常式。
傳回值:  MapsEventListener
為這個位置提供者觸發的事件新增 MapsEventListener。傳回可與 event.removeListener 搭配使用的此事件監聽器的識別碼。

PollingLocationProvider 抽象類別

google.maps.journeySharing.PollingLocationProvider 抽象類別

輪詢位置提供者的父項類別。

這個抽象類別可擴充了 LocationProvider

isPolling
類型:  boolean
如果這個位置提供者正在輪詢,則傳回 True。(唯讀)。
pollingIntervalMillis
類型:  number
擷取位置資訊更新的時間下限 (以毫秒為單位)。如果擷取位置更新的時間超過 pollingIntervalMillis,則系統會等到下一次更新作業完成,才會開始更新位置資訊。

如果將這個值設為 0、Infinity 或負值,系統就會停用自動更新位置功能。追蹤 ID 參數 (例如運送地點供應商的運送追蹤 ID) 或篩選選項 (例如可視區域位置的貨運公司邊界或屬性篩選器) 有所變更時,系統則會擷取一次新的位置更新。

預設和最小輪詢間隔為 5000 毫秒。如果將輪詢間隔設為較低的正數值,系統會儲存並使用 5000 個。
繼承: addListener
ispollingchange
function(event)
當位置提供者的輪詢狀態更新時觸發的事件。使用 PollingLocationProvider.isPolling 來判斷目前的輪詢狀態。

PollingLocationProviderIsPollingChangeEvent介面

google.maps.journeySharing.PollingLocationProviderIsPollingChangeEvent 介面

觸發 PollingLocationProvider.ispollingchange 事件時傳送至事件處理常式的事件物件。

error optional
類型:  Error optional
導致狀態變更的錯誤 (如果狀態變更是由錯誤所造成)。如果狀態變更是正常作業造成的,則未定義。