Map View

JourneySharedMapView 類別

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 物件的 defaultPolylineOptions 欄位,然後以輸出 PolylineSetupOptions 物件中的 polylineOptions 形式傳回。

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

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,或是在不同的 PolylineSetupOptions 物件中,為 polylineOptions 鍵重複使用相同的 google.maps.PolylineOptions 物件。如果 polylineOptions 或 Visible 未設定或為空值,則會以預設值覆寫。系統會忽略針對 polylineOptions.map 或 polylineOptions.path 設定的值。
automaticViewportMode
這是唯讀欄位。自動可視區域模式。
element
類型:  Element
這是唯讀欄位。支援檢視畫面的 DOM 元素。
enableTraffic
類型:  boolean
啟用或停用路況圖層。
locationProviders
類型:  Array<LocationProvider> optional
這是唯讀欄位。追蹤地圖檢視中顯示的追蹤地點來源。如要新增或移除位置提供者,請使用 JourneySharingMapView.addLocationProviderJourneySharingMapView.removeLocationProvider 方法。
map
類型:  Map
這是唯讀欄位。地圖檢視中包含的地圖物件。
mapOptions
類型:  MapOptions
這是唯讀欄位。透過地圖檢視傳送至地圖的地圖選項。
takenRoutePolylines
類型:  Array<Polyline>
傳回所拍攝的路線折線 (如果有的話)。
takenRoutePolylineSetup
類型:  PolylineSetup
設定行駛的路線折線選項。每次算繪出新的行駛路線折線時叫用。

如果指定函式,該函式可以且應該修改包含 google.maps.PolylineOptions 物件的 defaultPolylineOptions 欄位,然後以輸出 PolylineSetupOptions 物件中的 polylineOptions 形式傳回。

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

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

系統會忽略所有為 polylineOptions.map 或 polylineOptions.path 設定的值。任何未設定或為空值的值都會以預設值覆寫。
locationProvider
類型:  LocationProvider optional
這是唯讀欄位。要在追蹤地圖檢視中顯示的追蹤地點來源。
destinationMarkerSetup
類型:  MarkerSetup
設定目的地位置標記的選項。每次算繪新的目的地標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
originMarkerSetup
類型:  MarkerSetup
設定起點位置標記的選項。每次算繪新的起點標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
pingMarkerSetup
類型:  MarkerSetup
設定連線偵測 (ping) 位置標記的選項。每次算繪新的連線偵測 (ping) 標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
successfulTaskMarkerSetup
類型:  MarkerSetup
設定成功工作位置標記的選項。每次算繪出新的成功工作標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

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

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
unsuccessfulTaskMarkerSetup
類型:  MarkerSetup
設定失敗工作位置標記的選項。轉譯失敗的新工作標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
vehicleMarkerSetup
類型:  MarkerSetup
設定車輛位置標記的選項。每次算繪新車輛標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
waypointMarkerSetup
類型:  MarkerSetup
設定路線控點位置標記的選項。每次呈現新的路線控點標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
destinationMarkers
類型:  Array<Marker>
傳回目的地標記 (如果有的話)。
originMarkers
類型:  Array<Marker>
傳回起點標記 (如果有的話)。
successfulTaskMarkers
類型:  Array<Marker>
傳回成功的工作標記 (如果有的話)。
taskOutcomeMarkers
類型:  Array<Marker>
傳回工作結果標記 (如果有的話)。
unsuccessfulTaskMarkers
類型:  Array<Marker>
傳回失敗的工作標記 (如果有的話)。
vehicleMarkers
類型:  Array<Marker>
傳回車輛標記 (如果有的話)。
waypointMarkers
類型:  Array<Marker>
傳迴路線控點標記 (如果有的話)。
addLocationProvider
addLocationProvider(locationProvider)
參數: 
傳回值:None
將位置提供者新增至地圖檢視。如果已新增這個位置提供者,則不會執行任何動作。
removeLocationProvider
removeLocationProvider(locationProvider)
參數: 
傳回值:None
從地圖檢視中移除位置提供者。如果位置提供者尚未新增至地圖檢視,則不會執行任何動作。

JourneySharedMapViewOptions 介面

google.maps.journeySharing.JourneySharingMapViewOptions 介面

地圖檢視選項。

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

如果指定函式,該函式可以且應該修改包含 google.maps.PolylineOptions 物件的 defaultPolylineOptions 欄位,然後以輸出 PolylineSetupOptions 物件中的 polylineOptions 形式傳回。

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

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,或是在不同的 PolylineSetupOptions 物件中,為 polylineOptions 鍵重複使用相同的 google.maps.PolylineOptions 物件。如果 polylineOptions 或 Visible 未設定或為空值,則會以預設值覆寫。系統會忽略針對 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 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.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 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
pingMarkerSetup optional
類型:  MarkerSetup optional
設定連線偵測 (ping) 位置標記的選項。每次算繪新的連線偵測 (ping) 標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
successfulTaskMarkerSetup optional
類型:  MarkerSetup optional
設定成功工作位置標記的選項。每次算繪出新的成功工作標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
takenRoutePolylineSetup optional
類型:  PolylineSetup optional
設定行駛的路線折線選項。每次算繪出新的行駛路線折線時叫用。

如果指定函式,該函式可以且應該修改包含 google.maps.PolylineOptions 物件的 defaultPolylineOptions 欄位,然後以輸出 PolylineSetupOptions 物件中的 polylineOptions 形式傳回。

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

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

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

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
unsuccessfulTaskMarkerSetup optional
類型:  MarkerSetup optional
設定失敗工作位置標記的選項。轉譯失敗的新工作標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
vehicleMarkerSetup optional
類型:  MarkerSetup optional
設定車輛位置標記的選項。每次算繪新車輛標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.position 所設定的任何值。
waypointMarkerSetup optional
類型:  MarkerSetup optional
設定路線控點位置標記的選項。每次呈現新的路線控點標記時叫用。

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

指定 MarkerSetupOptions 物件,相當於指定傳回該靜態物件的函式。

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,使用相同的 google.maps.MarkerOptions 物件處理標記選項。如果將 MarkerOptions 未設定或為空值,則會使用預設值覆寫。系統會忽略針對 markerOptions.map 或 markerOptions.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 搭配使用的事件監聽器 ID。

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
如果狀態變更是由錯誤造成,則會導致輪詢狀態變更的錯誤。如果狀態變更是因為正常作業而發生,未定義。