Map View

JourneySharingMapView class

google.maps.journeySharing.JourneySharingMapView class

地圖檢視畫面。

撥打 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
設定目的地位置標記的選項。每當系統算繪新的目的地標記時,就會叫用這個函式。

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。
originMarkerSetup
類型:  MarkerSetup
設定起點標記的選項。每當系統算繪新的原點標記時,就會叫用這個方法。

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。
unsuccessfulTaskMarkerSetup
類型:  MarkerSetup
設定任務失敗位置標記的選項。每當系統算繪新的失敗工作標記時,就會叫用此函式。

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。
waypointMarkerSetup
類型:  MarkerSetup
設定中途點位置標記的選項。每當系統算繪新的航點標記時,就會叫用這個函式。

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。
anticipatedRoutePolylineSetup
類型:  PolylineSetup
設定預期路線折線的選項。每當系統繪製新的預期路線折線時,就會呼叫這個方法。

如果指定函式,函式可以且應該修改輸入內容的 defaultPolylineOptions 欄位 (內含 google.maps.PolylineOptions 物件),並在輸出內容的 PolylineSetupOptions 物件中將其傳回為 polylineOptions。

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

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中,重複使用 polylineOptions 鍵的相同 google.maps.PolylineOptions 物件。如果 polylineOptions 或 visible 未設定或為空值,系統會以預設值覆寫。系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。
takenRoutePolylineSetup
類型:  PolylineSetup
設定所選路線的折線選項。每當系統算繪新的已行駛路線折線時,就會呼叫這個函式。

如果指定函式,函式可以且應該修改輸入內容的 defaultPolylineOptions 欄位 (內含 google.maps.PolylineOptions 物件),並在輸出內容的 PolylineSetupOptions 物件中將其傳回為 polylineOptions。

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

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

系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。任何未設定或空值都會以預設值覆寫。
pingMarkerSetup
類型:  MarkerSetup
設定 Ping 位置標記的選項。每當系統算繪新的 Ping 標記時,就會呼叫這個函式。

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 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>
傳回航點標記 (如有)。
anticipatedRoutePolylines
類型:  Array<Polyline>
傳回預期路線的折線 (如有)。
takenRoutePolylines
類型:  Array<Polyline>
傳回所選路線的折線 (如有)。
addLocationProvider
addLocationProvider(locationProvider)
參數: 
傳回值:
將位置資訊供應器新增至地圖檢視畫面。如果已新增位置資訊供應器,系統不會執行任何動作。
removeLocationProvider
removeLocationProvider(locationProvider)
參數: 
傳回值:
從地圖檢視畫面中移除位置資訊提供者。如果地圖檢視畫面中尚未新增位置資訊提供者,系統不會執行任何動作。

JourneySharingMapViewOptions interface

google.maps.journeySharing.JourneySharingMapViewOptions 介面

地圖檢視選項。

element
類型:  Element
支援檢視區塊的 DOM 元素。必填。
anticipatedRoutePolylineSetup optional
類型:  PolylineSetup optional
設定預期路線折線的選項。每當系統繪製新的預期路線折線時,就會呼叫這個方法。

如果指定函式,函式可以且應該修改輸入內容的 defaultPolylineOptions 欄位 (內含 google.maps.PolylineOptions 物件),並在輸出內容的 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
設定目的地位置標記的選項。每當系統算繪新的目的地標記時,就會叫用這個函式。

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 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
設定起點標記的選項。每當系統算繪新的原點標記時,就會叫用這個方法。

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。
pingMarkerSetup optional
類型:  MarkerSetup optional
設定 Ping 位置標記的選項。每當系統算繪新的 Ping 標記時,就會呼叫這個函式。

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

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

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

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

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

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

如果指定函式,函式可以且應該修改輸入內容的 defaultPolylineOptions 欄位 (內含 google.maps.PolylineOptions 物件),並在輸出內容的 PolylineSetupOptions 物件中將其傳回為 polylineOptions。

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

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

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

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

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

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

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。
waypointMarkerSetup optional
類型:  MarkerSetup optional
設定中途點位置標記的選項。每當系統算繪新的航點標記時,就會叫用這個函式。

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 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 abstract class

google.maps.journeySharing.LocationProvider abstract class

所有位置資訊供應商的父項類別。

addListener
addListener(eventName, handler)
參數: 
  • eventNamestring要監聽的事件名稱。
  • handlerFunction事件處理常式。
傳回值:  MapsEventListener
為這個位置資訊提供者觸發的事件新增 MapsEventListener。傳回這個接聽程式的 ID,可用於 event.removeListener

PollingLocationProvider abstract class

google.maps.journeySharing.PollingLocationProvider abstract class

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

這個抽象類別會擴充 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
導致輪詢狀態變更的錯誤 (如果狀態變更是由錯誤所致)。如果狀態變更是因為正常作業所致,則為未定義。