Map View

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

JourneysharingMapView 類別

google.maps.journeySharing.JourneySharingMapView 類別

地圖檢視。

使用 &libraries=journeySharing 網址參數載入。請參閱 Maps JavaScript API 中的程式庫

使用 v=beta 時,可透過呼叫 const {JourneySharingMapView} = await google.map.importLibrary("journeySharing") 來存取請參閱 Maps JavaScript API 中的程式庫

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

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

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

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中重複使用 PolylineOptions 鍵值的 google.maps.PolylineOptions 物件。如果 PolylineOptions 或可見,未設定或為空值,就會以預設值覆寫。系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的值。

automaticViewportMode
這是唯讀欄位。自動可視區域模式。
element
類型:Element
這是唯讀欄位。支援檢視畫面的 DOM 元素。
enableTraffic
類型:boolean
啟用或停用路況圖層。
locationProvider
這是唯讀欄位。要顯示在追蹤地圖檢視中的追蹤位置來源。
map
類型:Map
這是唯讀欄位。地圖檢視中包含的地圖物件。
mapOptions
類型:MapOptions
這是唯讀欄位。透過地圖檢視傳送到地圖的地圖選項。
takenRoutePolylines
類型:Array<Polyline>
傳回所擷取的路徑折線 (如果有的話)。
takenRoutePolylineSetup
類型:PolylineSetup
設定採用的路線折線折線選項。在每次轉譯新的新路徑折線時叫用。

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

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

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

系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的值。任何預設值或空值都會以預設值覆寫。

destinationMarkerSetup
類型:MarkerSetup
設定目的地位置標記的選項。每次顯示新的目的地標記時叫用。

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

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

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

originMarkerSetup
類型:MarkerSetup
為起點位置標記設定選項。每次顯示新的來源標記時叫用。

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

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

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

pingMarkerSetup
類型:MarkerSetup
設定連線偵測 (ping) 位置標記的選項。每次顯示新的 ping 標記時叫用。

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

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

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

successfulTaskMarkerSetup
類型:MarkerSetup
設定成功的工作位置標記選項。每次成功顯示新的工作標記時叫用。

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

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

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

taskOutcomeMarkerSetup
類型:MarkerSetup
設定工作結果位置標記的選項。每次顯示新的工作結果位置標記時叫用。

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

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

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

unsuccessfulTaskMarkerSetup
類型:MarkerSetup
為失敗的工作地點標記設定選項。每當顯示新的失敗工作標記時叫用。

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

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

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

vehicleMarkerSetup
類型:MarkerSetup
設定車輛位置標記的選項。每次顯示新車輛標記時叫用。

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

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

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

waypointMarkerSetup
類型:MarkerSetup
設定路線控點位置標記的選項。每次顯示新的路線控點標記時叫用。

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

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

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

地圖檢視的選項。

使用 &libraries=journeySharing 網址參數載入。請參閱 Maps JavaScript API 中的程式庫

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

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

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

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中重複使用 PolylineOptions 鍵值的 google.maps.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 物件中重複使用標記的 MarkerOptions 鍵相同的 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 物件中重複使用標記的 MarkerOptions 鍵相同的 google.maps.MarkerOptions 物件。如未設定標記或空值,系統會以預設值覆寫標記選項。系統會忽略任何針對 MarkOptions.map 或 tagOptions.position 設定的值。

pingMarkerSetup optional
類型:MarkerSetup optional
設定連線偵測 (ping) 位置標記的選項。每次顯示新的 ping 標記時叫用。

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

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

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

successfulTaskMarkerSetup optional
類型:MarkerSetup optional
設定成功的工作位置標記選項。每次成功顯示新的工作標記時叫用。

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

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

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

takenRoutePolylineSetup optional
類型:PolylineSetup optional
設定採用的路線折線折線選項。在每次轉譯新的新路徑折線時叫用。

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

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

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

系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的值。任何預設值或空值都會以預設值覆寫。

taskOutcomeMarkerSetup optional
類型:MarkerSetup optional
設定工作結果位置標記的選項。每次顯示新的工作結果位置標記時叫用。

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

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

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

unsuccessfulTaskMarkerSetup optional
類型:MarkerSetup optional
為失敗的工作地點標記設定選項。每當顯示新的失敗工作標記時叫用。

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

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

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

vehicleMarkerSetup optional
類型:MarkerSetup optional
設定車輛位置標記的選項。每次顯示新車輛標記時叫用。

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

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

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

waypointMarkerSetup optional
類型:MarkerSetup optional
設定路線控點位置標記的選項。每次顯示新的路線控點標記時叫用。

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

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

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

AutomaticViewportMode 常數

google.maps.journeySharing.AutomaticViewportMode 常數

自動可視區域模式。

使用 &libraries=journeySharing 網址參數載入。請參閱 Maps JavaScript API 中的程式庫

使用 v=beta 時,可透過呼叫 const {AutomaticViewportMode} = await google.map.importLibrary("journeySharing") 來存取請參閱 Maps JavaScript API 中的程式庫

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

LocationProvider 抽象類別

google.maps.journeySharing.LocationProvider 抽象類別

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

使用 &libraries=journeySharing 網址參數載入。請參閱 Maps JavaScript API 中的程式庫

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

PollingLocationProvider 抽象類別

google.maps.journeySharing.PollingLocationProvider 抽象類別

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

這個抽象類別可擴充了 LocationProvider

使用 &libraries=journeySharing 網址參數載入。請參閱 Maps JavaScript API 中的程式庫

isPolling
類型:boolean
如果這個位置提供者正在輪詢,則傳回 True。(唯讀)。
繼承: addListener
ispollingchange
function(event)
當位置提供者的輪詢狀態更新時觸發的事件。使用 PollingLocationProvider.isPolling 來判斷目前的輪詢狀態。

PollingLocationProviderIsPollingChangeEvent介面

google.maps.journeySharing.PollingLocationProviderIsPollingChangeEvent 介面

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

使用 &libraries=journeySharing 網址參數載入。請參閱 Maps JavaScript API 中的程式庫

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