JourneySharingMapView class
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 設定目的地位置標記的選項。每當系統算繪新的目的地標記時,就會叫用這個函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定起點標記的選項。每當系統算繪新的原點標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定工作結果位置標記的選項。每當系統算繪新的工作結果位置標記時,就會叫用這個函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定任務失敗位置標記的選項。每當系統算繪新的失敗工作標記時,就會叫用此函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定車輛位置標記的選項。每當系統算繪新的車輛標記時,就會叫用這個函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定中途點位置標記的選項。每當系統算繪新的航點標記時,就會叫用這個函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
PolylineSetup 設定預期路線折線的選項。每當系統繪製新的預期路線折線時,就會呼叫這個方法。 如果指定函式,函式可以且應該修改輸入內容的 defaultPolylineOptions 欄位 (內含 google.maps.PolylineOptions 物件),並在輸出內容的 PolylineSetupOptions 物件中將其傳回為 polylineOptions。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中,重複使用 polylineOptions 鍵的相同 google.maps.PolylineOptions 物件。如果 polylineOptions 或 visible 未設定或為空值,系統會以預設值覆寫。系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。 |
|
類型:
PolylineSetup 設定所選路線的折線選項。每當系統算繪新的已行駛路線折線時,就會呼叫這個函式。 如果指定函式,函式可以且應該修改輸入內容的 defaultPolylineOptions 欄位 (內含 google.maps.PolylineOptions 物件),並在輸出內容的 PolylineSetupOptions 物件中將其傳回為 polylineOptions。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中,重複使用 polylineOptions 鍵的相同 google.maps.PolylineOptions 物件。 系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。任何未設定或空值都會以預設值覆寫。 |
|
類型:
MarkerSetup 設定 Ping 位置標記的選項。每當系統算繪新的 Ping 標記時,就會呼叫這個函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup 設定成功工作位置標記的選項。每當系統算繪新的成功工作標記時,就會叫用此函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
傳回目的地標記 (如有)。 |
|
傳回來源標記 (如有)。 |
|
傳回成功的任務標記 (如有)。 |
|
傳回工作結果標記 (如有)。 |
|
傳回失敗的工作標記 (如有)。 |
|
傳回車輛標記 (如有)。 |
|
傳回航點標記 (如有)。 |
|
傳回預期路線的折線 (如有)。 |
|
傳回所選路線的折線 (如有)。 |
方法 | |
---|---|
addLocationProvider |
addLocationProvider(locationProvider) 參數:
傳回值:無
將位置資訊供應器新增至地圖檢視畫面。如果已新增位置資訊供應器,系統不會執行任何動作。 |
removeLocationProvider |
removeLocationProvider(locationProvider) 參數:
傳回值:無
從地圖檢視畫面中移除位置資訊提供者。如果地圖檢視畫面中尚未新增位置資訊提供者,系統不會執行任何動作。 |
JourneySharingMapViewOptions interface
google.maps.journeySharing.JourneySharingMapViewOptions
介面
地圖檢視選項。
屬性 | |
---|---|
element |
類型:
Element 支援檢視區塊的 DOM 元素。必填。 |
|
類型:
PolylineSetup optional 設定預期路線折線的選項。每當系統繪製新的預期路線折線時,就會呼叫這個方法。 如果指定函式,函式可以且應該修改輸入內容的 defaultPolylineOptions 欄位 (內含 google.maps.PolylineOptions 物件),並在輸出內容的 PolylineSetupOptions 物件中將其傳回為 polylineOptions。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中,重複使用 polylineOptions 鍵的相同 google.maps.PolylineOptions 物件。如果 polylineOptions 或 visible 未設定或為空值,系統會以預設值覆寫。系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。 |
automaticViewportMode optional |
類型:
AutomaticViewportMode optional 自動可視區域模式。預設值為 FIT_ANTICIPATED_ROUTE,可讓地圖檢視畫面自動調整可視區域,以配合車輛標記、位置標記和任何可見的預期路線折線。將此屬性設為 NONE,即可關閉自動調整功能。 |
|
類型:
MarkerSetup optional 設定目的地位置標記的選項。每當系統算繪新的目的地標記時,就會叫用這個函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
LocationProvider optional 追蹤地圖檢視畫面中顯示的追蹤位置來源。選填。 |
locationProviders optional |
類型:
Array<LocationProvider> optional 追蹤地圖檢視畫面中顯示的追蹤位置來源。選填。 |
mapOptions optional |
類型:
MapOptions optional 傳遞至 google.maps.Map 建構函式的地圖選項。 |
|
類型:
MarkerSetup optional 設定起點標記的選項。每當系統算繪新的原點標記時,就會叫用這個方法。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup optional 設定 Ping 位置標記的選項。每當系統算繪新的 Ping 標記時,就會呼叫這個函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup optional 設定成功工作位置標記的選項。每當系統算繪新的成功工作標記時,就會叫用此函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
PolylineSetup optional 設定所選路線的折線選項。每當系統算繪新的已行駛路線折線時,就會呼叫這個函式。 如果指定函式,函式可以且應該修改輸入內容的 defaultPolylineOptions 欄位 (內含 google.maps.PolylineOptions 物件),並在輸出內容的 PolylineSetupOptions 物件中將其傳回為 polylineOptions。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中,重複使用 polylineOptions 鍵的相同 google.maps.PolylineOptions 物件。 系統會忽略為 polylineOptions.map 或 polylineOptions.path 設定的任何值。任何未設定或空值都會以預設值覆寫。 |
|
類型:
MarkerSetup optional 設定工作結果位置標記的選項。每當系統算繪新的工作結果位置標記時,就會叫用這個函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup optional 設定任務失敗位置標記的選項。每當系統算繪新的失敗工作標記時,就會叫用此函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
MarkerSetup optional 設定車輛位置標記的選項。每當系統算繪新的車輛標記時,就會叫用這個函式。 如果指定函式,該函式可以且應該修改輸入內容的 defaultMarkerOptions 欄位 (內含 google.maps.MarkerOptions 物件),並在輸出 MarkerSetupOptions 物件中以 markerOptions 形式傳回。 指定 MarkerSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中,重複使用 markerOptions 鍵的相同 google.maps.MarkerOptions 物件。如果 markerOptions 未設定或為空值,系統會覆寫為預設值。系統會忽略為 markerOptions.map 或 markerOptions.position 設定的任何值。 |
|
類型:
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
常數
自動可視區域模式。
撥打 const {AutomaticViewportMode} = await google.maps.importLibrary("journeySharing")
即可存取。
請參閱「Maps JavaScript API 中的程式庫」。
常數 | |
---|---|
FIT_ANTICIPATED_ROUTE |
自動調整可視區域,以配合標記和任何可見的預期路線折線。此為預設值。 |
NONE |
不要自動調整可視區域。 |
LocationProvider abstract class
google.maps.journeySharing.LocationProvider
abstract class
所有位置資訊供應商的父項類別。
方法 | |
---|---|
addListener |
addListener(eventName, handler) 參數:
傳回值:
MapsEventListener 為這個位置資訊提供者觸發的事件新增 MapsEventListener 。傳回這個接聽程式的 ID,可用於 event.removeListener 。 |
PollingLocationProvider abstract class
google.maps.journeySharing.PollingLocationProvider
abstract class
輪詢位置資訊提供者的父項類別。
這個抽象類別會擴充 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 導致輪詢狀態變更的錯誤 (如果狀態變更是由錯誤所致)。如果狀態變更是因為正常作業所致,則為未定義。 |