Map View

JourneySharingMapView類別

google.maps.journeySharing.JourneySharingMapView 類別

地圖檢視。

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

JourneySharingMapView
JourneySharingMapView(options)
參數: 
建立地圖檢視的例項。
automaticViewportMode
這是唯讀欄位。自動檢視可視區域模式。
element
類型:  Element
這是唯讀欄位。支援檢視畫面的 DOM 元素。
enableTraffic
類型:  boolean
啟用或停用車流量圖層。
locationProviders
類型:  Array<LocationProvider> optional
這是唯讀欄位。要在追蹤地圖檢視中顯示的已追蹤地點來源。如要新增或移除地點供應商,請使用 JourneySharingMapView.addLocationProviderJourneySharingMapView.removeLocationProvider 方法。
map
類型:  Map
這是唯讀欄位。地圖檢視中包含的地圖物件。
mapOptions
類型:  MapOptions
這是唯讀欄位。透過地圖檢視傳入地圖的地圖選項。
locationProvider
類型:  LocationProvider optional
這是唯讀欄位。追蹤地圖檢視中顯示的已追蹤地點。
destinationMarkerSetup
類型:  MarkerSetup
設定目的地位置標記的選項。完成新的目的地標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
originMarkerSetup
類型:  MarkerSetup
設定起點位置標記的選項。算繪新的起點標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
taskOutcomeMarkerSetup
類型:  MarkerSetup
設定工作結果位置標記的選項。完成新的工作結果位置標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
unsuccessfulTaskMarkerSetup
類型:  MarkerSetup
為失敗的工作位置標記設定選項。完成新的失敗工作標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
vehicleMarkerSetup
類型:  MarkerSetup
設定車輛位置標記的選項。每次轉譯新車輛標記時都會叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
waypointMarkerSetup
類型:  MarkerSetup
設定路線控點位置標記的選項。完成新的路線控點標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
anticipatedRoutePolylineSetup
類型:  PolylineSetup
設定預期路線折線的選項。每次算繪新的預期路線折線時都會叫用。

如果指定函式,該函式必須且應該修改包含 google.maps.PolylineOptions 物件的 input 和 defaultPolylineOptions 欄位,並在輸出的 PolylineSetupOptions 物件中將其以 polylineOptions 的形式傳回。

指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件。如果 polylineOptions 或不設定或 null,則會以預設值覆寫。系統會忽略針對 polylineOptions.map 或 polylineOptions.path 設定的任何值。
takenRoutePolylineSetup
類型:  PolylineSetup
設定所拍攝路線折線的選項。算繪新的路線折線時叫用。

如果指定函式,該函式必須且應該修改包含 google.maps.PolylineOptions 物件的 input 和 defaultPolylineOptions 欄位,並在輸出的 PolylineSetupOptions 物件中將其以 polylineOptions 的形式傳回。

指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件。

系統會忽略針對 polylineOptions.map 或 polylineOptions.path 設定的任何值。系統會以預設值覆寫任何未設定或空值。
pingMarkerSetup
類型:  MarkerSetup
設定連線偵測 (ping) 位置標記的選項。每次轉譯新的連線偵測標記時都會叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
successfulTaskMarkerSetup
類型:  MarkerSetup
為成功的工作位置標記設定選項。完成新的成功工作標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
destinationMarkers
類型:  Array<Marker>
傳回目的地標記 (如果有的話)。
originMarkers
類型:  Array<Marker>
傳回原始標記 (如果有的話)。
successfulTaskMarkers
類型:  Array<Marker>
傳回成功的工作標記 (如果有的話)。
taskOutcomeMarkers
類型:  Array<Marker>
傳回工作結果標記 (如果有的話)。
unsuccessfulTaskMarkers
類型:  Array<Marker>
傳回失敗的工作標記 (如果有的話)。
vehicleMarkers
類型:  Array<Marker>
傳回車輛標記 (如果有的話)。
waypointMarkers
類型:  Array<Marker>
傳迴路線控點標記 (如果有的話)。
anticipatedRoutePolylines
類型:  Array<Polyline>
傳回預期的路線折線 (如果有的話)。
takenRoutePolylines
類型:  Array<Polyline>
傳回取得的路線折線 (如果有的話)。
addLocationProvider
addLocationProvider(locationProvider)
參數: 
傳回值:
在地圖檢視中加入位置提供者。如果已經新增位置提供者,則不會執行任何動作。
removeLocationProvider
removeLocationProvider(locationProvider)
參數: 
傳回值:
從地圖檢視中移除位置提供者。如果位置提供者尚未新增至地圖檢視,系統就不會執行任何動作。

JourneySharingMapViewOptions介面

google.maps.journeySharing.JourneySharingMapViewOptions 介面

地圖檢視選項。

element
類型:  Element
支援檢視畫面的 DOM 元素。這是必填欄位。
anticipatedRoutePolylineSetup optional
類型:  PolylineSetup optional
設定預期路線折線的選項。每次算繪新的預期路線折線時都會叫用。

如果指定函式,該函式必須且應該修改包含 google.maps.PolylineOptions 物件的 input 和 defaultPolylineOptions 欄位,並在輸出的 PolylineSetupOptions 物件中將其以 polylineOptions 的形式傳回。

指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件。如果 polylineOptions 或不設定或 null,則會以預設值覆寫。系統會忽略針對 polylineOptions.map 或 polylineOptions.path 設定的任何值。
automaticViewportMode optional
類型:  AutomaticViewportMode optional
自動檢視可視區域模式。預設值為 FIT_ANTICIPATED_ROUTE,可讓地圖檢視自動調整可視區域,以符合車輛標記、位置標記和任何可見的預期路線折線。將此值設為「NONE」,即可關閉自動合框功能。
destinationMarkerSetup optional
類型:  MarkerSetup optional
設定目的地位置標記的選項。完成新的目的地標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
locationProvider optional
類型:  LocationProvider optional
追蹤地圖檢視中顯示的已追蹤地點。選用。
locationProviders optional
類型:  Array<LocationProvider> optional
要在追蹤地圖檢視中顯示的已追蹤地點來源。選用。
mapOptions optional
類型:  MapOptions optional
地圖選項傳遞至 google.maps.Map 建構函式。
originMarkerSetup optional
類型:  MarkerSetup optional
設定起點位置標記的選項。算繪新的起點標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

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

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
successfulTaskMarkerSetup optional
類型:  MarkerSetup optional
為成功的工作位置標記設定選項。完成新的成功工作標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
takenRoutePolylineSetup optional
類型:  PolylineSetup optional
設定所拍攝路線折線的選項。算繪新的路線折線時叫用。

如果指定函式,該函式必須且應該修改包含 google.maps.PolylineOptions 物件的 input 和 defaultPolylineOptions 欄位,並在輸出的 PolylineSetupOptions 物件中將其以 polylineOptions 的形式傳回。

指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件。

系統會忽略針對 polylineOptions.map 或 polylineOptions.path 設定的任何值。系統會以預設值覆寫任何未設定或空值。
taskOutcomeMarkerSetup optional
類型:  MarkerSetup optional
設定工作結果位置標記的選項。完成新的工作結果位置標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
unsuccessfulTaskMarkerSetup optional
類型:  MarkerSetup optional
為失敗的工作位置標記設定選項。完成新的失敗工作標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
vehicleMarkerSetup optional
類型:  MarkerSetup optional
設定車輛位置標記的選項。每次轉譯新車輛標記時都會叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。
waypointMarkerSetup optional
類型:  MarkerSetup optional
設定路線控點位置標記的選項。完成新的路線控點標記時叫用。

如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.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。傳回此事件監聽器的 ID,可搭配 event.removeListener 使用。

PollingLocationProvider 抽象類別

google.maps.journeySharing.PollingLocationProvider 抽象類別

投票地點提供者的上層類別。

這個抽象類別會擴充 LocationProvider

isPolling
類型:  boolean
如果這個位置提供者正在進行輪詢,則為「是」。唯讀。
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
導致輪詢狀態變更的錯誤 (這是因錯誤所致)。狀態因作業正常而變更時未定義。