Map View

JourneySharingMapView 類別

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 或可見為 null,則系統會以預設值覆寫。系統會忽略針對 polylineOptions.map 或 polylineOptions.path 設定的值。
automaticViewportMode
這是唯讀欄位。自動可視區域模式。
element
類型:  Element
這是唯讀欄位。支援檢視畫面的 DOM 元素。
enableTraffic
類型:  boolean
啟用或停用車流量圖層。
locationProvider
類型:  LocationProvider
這是唯讀欄位。要顯示在追蹤地圖檢視中的追蹤位置來源。
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 設定的值。任何未設定或空值都會以預設值覆寫。
destinationMarkerSetup
類型:  MarkerSetup
設定目的地位置標記的選項。每次算繪新的目的地標記時都會叫用。

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

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

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

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用相同的 google.maps.MarkerOptions 物件給 markerOptions 鍵。如果標記選項未經設定或為 null,將以預設值覆寫。系統會忽略標記 Options.map 或 markerOptions.position 的任何值。
successfulTaskMarkerSetup
類型:  MarkerSetup
設定工作地點標記成功的選項。每次轉譯新的成功工作標記時都會叫用。

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用相同的 google.maps.MarkerOptions 物件給 markerOptions 鍵。如果標記選項未經設定或為 null,將以預設值覆寫。系統會忽略標記 Options.map 或 markerOptions.position 的任何值。
taskOutcomeMarkerSetup
類型:  MarkerSetup
設定工作結果位置標記的選項。每次轉譯新的工作結果位置標記時都會叫用。

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

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

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

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用相同的 google.maps.MarkerOptions 物件給 markerOptions 鍵。如果標記選項未經設定或為 null,將以預設值覆寫。系統會忽略標記 Options.map 或 markerOptions.position 的任何值。
waypointMarkerSetup
類型:  MarkerSetup
設定路線控點位置標記的選項。每次算繪新的路線控點標記時都會叫用。

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用相同的 google.maps.MarkerOptions 物件給 markerOptions 鍵。如果標記選項未經設定或為 null,將以預設值覆寫。系統會忽略標記 Options.map 或 markerOptions.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 介面

地圖檢視的選項。

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

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用相同的 google.maps.MarkerOptions 物件給 markerOptions 鍵。如果標記選項未經設定或為 null,將以預設值覆寫。系統會忽略標記 Options.map 或 markerOptions.position 的任何值。
mapOptions optional
類型:  MapOptions optional
傳送至 google.maps.Map 建構函式的地圖選項。
originMarkerSetup optional
類型:  MarkerSetup optional
設定起點位置標記的選項。算繪新的起點標記時叫用。

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用相同的 google.maps.MarkerOptions 物件給 markerOptions 鍵。如果標記選項未經設定或為 null,將以預設值覆寫。系統會忽略標記 Options.map 或 markerOptions.position 的任何值。
successfulTaskMarkerSetup optional
類型:  MarkerSetup optional
設定工作地點標記成功的選項。每次轉譯新的成功工作標記時都會叫用。

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用相同的 google.maps.MarkerOptions 物件給 markerOptions 鍵。如果標記選項未經設定或為 null,將以預設值覆寫。系統會忽略標記 Options.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 物件中以 markerOptions 物件傳回。

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

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

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用相同的 google.maps.MarkerOptions 物件給 markerOptions 鍵。如果標記選項未經設定或為 null,將以預設值覆寫。系統會忽略標記 Options.map 或 markerOptions.position 的任何值。
waypointMarkerSetup optional
類型:  MarkerSetup optional
設定路線控點位置標記的選項。每次算繪新的路線控點標記時都會叫用。

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用相同的 google.maps.MarkerOptions 物件給 markerOptions 鍵。如果標記選項未經設定或為 null,將以預設值覆寫。系統會忽略標記 Options.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
如果這個位置供應商正在輪詢,則為「是」。唯讀。
pollingIntervalMillis
類型:  number
擷取位置更新作業之間的最短時間 (以毫秒為單位)。如果擷取位置資訊更新的時間超過 pollingIntervalMillis,則系統必須等到目前的位置更新作業完成後,才會啟動下一次位置更新作業。

如果將這個值設為 0、Infinity 或負值,就會停用位置自動更新功能。如果追蹤 ID 參數 (例如運送地點供應商的運送追蹤 ID) 或篩選選項 (例如機群位置供應商的可視區域邊界或屬性篩選器) 有所變更,系統就會擷取一次新的位置更新通知。

預設的輪詢時間間隔為 5000 毫秒。如果將輪詢時間間隔設為較低的正值,系統就會儲存並使用 5, 000。
沿用: addListener
ispollingchange
function(event)
位置提供者更新輪詢狀態時觸發的事件。使用 PollingLocationProvider.isPolling 來判斷目前的輪詢狀態。

PollingLocationProviderIsPollingChangeEvent 介面

google.maps.journeySharing.PollingLocationProviderIsPollingChangeEvent 介面

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

error optional
類型:  Error optional
造成輪詢狀態變更的錯誤 (如果狀態變更是因錯誤所致)。狀態變更是否為正常作業而發生未定義。