Map View

JourneySharingMapView 類別

google.maps.journeySharing.JourneySharingMapView class
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
類型: 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
設定偵測位置標記的選項。每當系統算繪新的偵測標記時,就會叫用這個方法。

如果指定函式,該函式可以且應該修改輸入內容的 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 介面

google.maps.journeySharing.JourneySharingMapViewOptions 介面

地圖檢視畫面的選項。

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

如果指定函式,該函式可以且應該修改輸入的 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,即可關閉自動調整功能。
destinationMarkerSetup
選填
類型: MarkerSetup optional
設定目的地位置標記的選項。每當系統算繪新的目的地標記時,就會叫用這個方法。

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。
locationProvider
選填
類型: LocationProvider optional
追蹤位置的來源,會顯示在追蹤地圖檢視畫面中。選用項目。
locationProviders
選填
類型: Array<LocationProvider> optional
追蹤位置的來源,會顯示在追蹤地圖檢視畫面中。選用項目。
mapOptions
選填
類型: MapOptions optional
傳入 google.maps.Map 建構函式的地圖選項。
originMarkerSetup
選填
類型: MarkerSetup optional
設定起點標記的選項。每當系統算繪新的起點標記時,就會叫用這個方法。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用同一個 MarkerSetupOptions 物件,也不要在不同 MarkerSetupOptions 物件中,為 markerOptions 鍵重複使用同一個 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會以預設值覆寫。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。
waypointMarkerSetup
選填
類型: 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 constants
程式庫"journeySharing"

自動可視區域模式。

這些常數也可以做為字串使用。在 TypeScript 中,字串常值是由 AutomaticViewportModeString 類型定義。

const {AutomaticViewportMode} = await google.maps.importLibrary("journeySharing");
FIT_ANTICIPATED_ROUTE 自動調整可視區域,以容納標記和任何可見的預期路線折線。此為預設值。
NONE 不要自動調整可視區域。

LocationProvider 抽象類別

google.maps.journeySharing.LocationProvider 抽象類別

所有位置供應器的父項類別。

addListener
addListener(eventName, handler)
參數:
  • eventName:string要監聽的事件名稱。
  • handler:Function事件處理常式。
傳回值: MapsEventListener
為這個位置供應器觸發的事件新增 MapsEventListener。傳回這個事件監聽器的 ID,可與 event.removeListener 搭配使用。

PollingLocationProvider 抽象類別

google.maps.journeySharing.PollingLocationProvider abstract class
extends LocationProvider

投票地點提供者的父項類別。

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