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.addLocationProvider 和 JourneySharingMapView.removeLocationProvider 方法。 |
map |
類型:
Map 這個欄位為唯讀。地圖檢視畫面中包含的地圖物件。 |
mapOptions |
類型:
MapOptions 這個欄位為唯讀。透過地圖檢視傳遞至地圖的選項。 |
|
類型:
LocationProvider optional 這個欄位為唯讀。追蹤地點的來源,會顯示在追蹤地圖檢視畫面中。 |
|
類型:
MarkerSetup 設定目的地位置標記的選項。每當新的目的地標記算繪時,就會叫用此方法。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定原點標記的選項。每當新的原點標記算繪時,就會叫用。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定工作結果位置標記的選項。每次顯示新的工作結果位置標記時,就會叫用此事件。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定失敗任務位置標記的選項。每當系統算繪新的失敗任務標記時,就會叫用此事件。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定車輛位置標記的選項。每當新的車輛標記算繪時,就會叫用此方法。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定路標位置標記的選項。每當新的路標標記算繪時,就會叫用此事件。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
PolylineSetup 設定預期路線多邊形的選項。每當新的預期路線多邊形繪製時,就會叫用此方法。 如果指定函式,則該函式可以且應修改包含 google.maps.PolylineOptions 物件的輸入內容 defaultPolylineOptions 欄位,並在輸出 PolylineSetupOptions 物件中以 polylineOptions 的形式傳回。 指定 PolylineSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也請勿在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件 (針對 polylineOptions 鍵)。如果未設定 polylineOptions 或 visible,或為空值,系統會將其覆寫為預設值。系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的所有值。 |
|
類型:
PolylineSetup 設定已採用路線的折線選項。每當新的已行經路線多邊形繪製時,就會叫用。 如果指定函式,則該函式可以且應修改包含 google.maps.PolylineOptions 物件的輸入內容 defaultPolylineOptions 欄位,並在輸出 PolylineSetupOptions 物件中以 polylineOptions 的形式傳回。 指定 PolylineSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也請勿在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件 (針對 polylineOptions 鍵)。 系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。任何未設定或空值都會以預設值覆寫。 |
|
類型:
MarkerSetup 設定 ping 位置標記的選項。每當新的 ping 標記算繪時,就會叫用此方法。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定成功的任務位置標記選項。每次顯示新成功任務標記時會叫用。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
傳回目的地標記 (如果有)。 |
|
傳回原點標記 (如有)。 |
|
傳回成功的工作標記 (如有)。 |
|
傳回工作結果標記 (如果有的話)。 |
|
傳回失敗的工作標記 (如有)。 |
|
傳回車輛標記 (如有)。 |
|
傳回路標標記 (如有)。 |
|
傳回預期路線多邊形 (如有)。 |
|
傳回已採取的路線多邊形 (如果有的話)。 |
方法 | |
---|---|
addLocationProvider |
addLocationProvider(locationProvider) 參數:
傳回值:無
將位置供應器新增至地圖檢視畫面。如果已新增位置供應器,系統不會執行任何動作。 |
removeLocationProvider |
removeLocationProvider(locationProvider) 參數:
傳回值:無
從地圖檢視畫面中移除位置供應器。如果地點供應器尚未新增至地圖檢視畫面,系統就不會執行任何動作。 |
JourneySharingMapViewOptions 介面
google.maps.journeySharing.JourneySharingMapViewOptions
介面
地圖檢視畫面的選項。
屬性 | |
---|---|
element |
類型:
Element 支援檢視畫面的 DOM 元素。必填。 |
|
類型:
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,即可關閉自動調整功能。 |
|
類型:
MarkerSetup optional 設定目的地位置標記的選項。每當新的目的地標記算繪時,就會叫用此方法。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
LocationProvider optional 追蹤地點的來源,會顯示在追蹤地圖檢視畫面中。選填。 |
locationProviders optional |
類型:
Array<LocationProvider> optional 追蹤地點的來源,會顯示在追蹤地圖檢視畫面中。選填。 |
mapOptions optional |
類型:
MapOptions optional 傳遞至 google.maps.Map 建構函式的地圖選項。 |
|
類型:
MarkerSetup optional 設定原點標記的選項。每當新的原點標記算繪時,就會叫用。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup optional 設定 ping 位置標記的選項。每當新的 ping 標記算繪時,就會叫用此方法。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup optional 設定成功的任務位置標記選項。每次顯示新成功任務標記時會叫用。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
PolylineSetup optional 設定已採用路線的折線選項。每當新的已行經路線多邊形繪製時,就會叫用。 如果指定函式,則該函式可以且應修改包含 google.maps.PolylineOptions 物件的輸入內容 defaultPolylineOptions 欄位,並在輸出 PolylineSetupOptions 物件中以 polylineOptions 的形式傳回。 指定 PolylineSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也請勿在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件 (針對 polylineOptions 鍵)。 系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。任何未設定或空值都會以預設值覆寫。 |
|
類型:
MarkerSetup optional 設定工作結果位置標記的選項。每次顯示新的工作結果位置標記時,就會叫用此事件。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup optional 設定失敗任務位置標記的選項。每當系統算繪新的失敗任務標記時,就會叫用此事件。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup optional 設定車輛位置標記的選項。每當新的車輛標記算繪時,就會叫用此方法。 如果指定函式,則該函式可以且應修改包含 google.maps.MarkerOptions 物件的輸入內容 defaultMarkerOptions 欄位,並在輸出內容 MarkerSetupOptions 物件中傳回該欄位做為 markerOptions。 指定 MarkerSetupOptions 物件,與指定傳回該靜態物件的函式有相同的效果。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用相同的 google.maps.MarkerOptions 物件 (用於 markerOptions 鍵)。如果未設定 markerOptions 或為空值,系統會以預設值覆寫該值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
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) 參數:
傳回值:
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 如果狀態變更是因錯誤造成,則是導致輪詢狀態變更的錯誤。未定義狀態變更是否是由於正常作業所致。 |