Map View

JourneySharingMapView 類別

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
設定目的地位置標記的選項。每當新的目的地標記算繪時,就會叫用此方法。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也請勿在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件 (針對 polylineOptions 鍵)。如果未設定 polylineOptions 或 visible,或為空值,系統會將其覆寫為預設值。系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的所有值。
takenRoutePolylineSetup
類型:  PolylineSetup
設定已採用路線的折線選項。每當新的已行經路線多邊形繪製時,就會叫用。

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

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

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

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

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 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 optional
類型:  PolylineSetup optional
設定預期路線多邊形的選項。每當新的預期路線多邊形繪製時,就會叫用此方法。

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

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

請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也請勿在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件 (針對 polylineOptions 鍵)。如果未設定 polylineOptions 或 visible,或為空值,系統會將其覆寫為預設值。系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的所有值。
automaticViewportMode optional
類型:  AutomaticViewportMode optional
自動視區模式。預設值為 FIT_ANTICIPATED_ROUTE,可讓地圖檢視畫面自動調整可視區域,以便顯示車輛標記、位置標記和任何可見的預測路線多邊形。將這項屬性設為 NONE,即可關閉自動調整功能。
destinationMarkerSetup optional
類型:  MarkerSetup optional
設定目的地位置標記的選項。每當新的目的地標記算繪時,就會叫用此方法。

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 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 物件中傳回該欄位做為 markerOptions。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 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
如果狀態變更是因錯誤造成,則是導致輪詢狀態變更的錯誤。未定義狀態變更是否是由於正常作業所致。