JourneySharingMapView類別
google.maps.journeySharing.JourneySharingMapView
類別
地圖檢視。
呼叫 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 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
MarkerSetup 設定起點位置標記的選項。算繪新的起點標記時叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
MarkerSetup 設定工作結果位置標記的選項。完成新的工作結果位置標記時叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
MarkerSetup 為失敗的工作位置標記設定選項。完成新的失敗工作標記時叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
MarkerSetup 設定車輛位置標記的選項。每次轉譯新車輛標記時都會叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
MarkerSetup 設定路線控點位置標記的選項。完成新的路線控點標記時叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
PolylineSetup 設定預期路線折線的選項。每次算繪新的預期路線折線時都會叫用。 如果指定函式,該函式必須且應該修改包含 google.maps.PolylineOptions 物件的 input 和 defaultPolylineOptions 欄位,並在輸出的 PolylineSetupOptions 物件中將其以 polylineOptions 的形式傳回。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件。如果 polylineOptions 或不設定或 null,則會以預設值覆寫。系統會忽略針對 polylineOptions.map 或 polylineOptions.path 設定的任何值。 |
|
類型:
PolylineSetup 設定所拍攝路線折線的選項。算繪新的路線折線時叫用。 如果指定函式,該函式必須且應該修改包含 google.maps.PolylineOptions 物件的 input 和 defaultPolylineOptions 欄位,並在輸出的 PolylineSetupOptions 物件中將其以 polylineOptions 的形式傳回。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件。 系統會忽略針對 polylineOptions.map 或 polylineOptions.path 設定的任何值。系統會以預設值覆寫任何未設定或空值。 |
|
類型:
MarkerSetup 設定連線偵測 (ping) 位置標記的選項。每次轉譯新的連線偵測標記時都會叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
MarkerSetup 為成功的工作位置標記設定選項。完成新的成功工作標記時叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
傳回目的地標記 (如果有的話)。 |
|
傳回原始標記 (如果有的話)。 |
|
傳回成功的工作標記 (如果有的話)。 |
|
傳回工作結果標記 (如果有的話)。 |
|
傳回失敗的工作標記 (如果有的話)。 |
|
傳回車輛標記 (如果有的話)。 |
|
傳迴路線控點標記 (如果有的話)。 |
|
傳回預期的路線折線 (如果有的話)。 |
|
傳回取得的路線折線 (如果有的話)。 |
方法 | |
---|---|
addLocationProvider |
addLocationProvider(locationProvider) 參數:
傳回值:無
在地圖檢視中加入位置提供者。如果已經新增位置提供者,則不會執行任何動作。 |
removeLocationProvider |
removeLocationProvider(locationProvider) 參數:
傳回值:無
從地圖檢視中移除位置提供者。如果位置提供者尚未新增至地圖檢視,系統就不會執行任何動作。 |
JourneySharingMapViewOptions介面
google.maps.journeySharing.JourneySharingMapViewOptions
介面
地圖檢視選項。
屬性 | |
---|---|
element |
類型:
Element 支援檢視畫面的 DOM 元素。這是必填欄位。 |
|
類型:
PolylineSetup optional 設定預期路線折線的選項。每次算繪新的預期路線折線時都會叫用。 如果指定函式,該函式必須且應該修改包含 google.maps.PolylineOptions 物件的 input 和 defaultPolylineOptions 欄位,並在輸出的 PolylineSetupOptions 物件中將其以 polylineOptions 的形式傳回。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件。如果 polylineOptions 或不設定或 null,則會以預設值覆寫。系統會忽略針對 polylineOptions.map 或 polylineOptions.path 設定的任何值。 |
automaticViewportMode optional |
類型:
AutomaticViewportMode optional 自動檢視可視區域模式。預設值為 FIT_ANTICIPATED_ROUTE,可讓地圖檢視自動調整可視區域,以符合車輛標記、位置標記和任何可見的預期路線折線。將此值設為「NONE」,即可關閉自動合框功能。 |
|
類型:
MarkerSetup optional 設定目的地位置標記的選項。完成新的目的地標記時叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
LocationProvider optional 追蹤地圖檢視中顯示的已追蹤地點。選用。 |
locationProviders optional |
類型:
Array<LocationProvider> optional 要在追蹤地圖檢視中顯示的已追蹤地點來源。選用。 |
mapOptions optional |
類型:
MapOptions optional 地圖選項傳遞至 google.maps.Map 建構函式。 |
|
類型:
MarkerSetup optional 設定起點位置標記的選項。算繪新的起點標記時叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
MarkerSetup optional 設定連線偵測 (ping) 位置標記的選項。每次轉譯新的連線偵測標記時都會叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
MarkerSetup optional 為成功的工作位置標記設定選項。完成新的成功工作標記時叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
PolylineSetup optional 設定所拍攝路線折線的選項。算繪新的路線折線時叫用。 如果指定函式,該函式必須且應該修改包含 google.maps.PolylineOptions 物件的 input 和 defaultPolylineOptions 欄位,並在輸出的 PolylineSetupOptions 物件中將其以 polylineOptions 的形式傳回。 指定 PolylineSetupOptions 物件的效果,與指定傳回該靜態物件的函式相同。 請勿在不同的 PolylineSetup 函式或靜態值中重複使用相同的 PolylineSetupOptions 物件,也不要在不同的 PolylineSetupOptions 物件中重複使用相同的 google.maps.PolylineOptions 物件。 系統會忽略針對 polylineOptions.map 或 polylineOptions.path 設定的任何值。系統會以預設值覆寫任何未設定或空值。 |
|
類型:
MarkerSetup optional 設定工作結果位置標記的選項。完成新的工作結果位置標記時叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
MarkerSetup optional 為失敗的工作位置標記設定選項。完成新的失敗工作標記時叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
MarkerSetup optional 設定車輛位置標記的選項。每次轉譯新車輛標記時都會叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.position 的設定值。 |
|
類型:
MarkerSetup optional 設定路線控點位置標記的選項。完成新的路線控點標記時叫用。 如果指定函式,該函式必須且應修改包含 google.maps.MarkerOptions 物件的輸入內容的 defaultMarkerOptions 欄位,並在輸出 MarkerSetupOptions 物件中以 tagOptions 的形式傳回。 指定 MarkerSetupOptions 物件,效果與指定傳回該靜態物件的函式相同。 請勿在不同的 MarkerSetup 函式或靜態值中重複使用相同的 MarkerSetupOptions 物件,也不要在不同的 MarkerSetupOptions 物件中重複使用同一個 google.maps.MarkerOptions 物件。若未設定標記或為 null,系統會以預設值覆寫其標記。系統會忽略 tagOptions.map 或 tagOptions.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 。傳回此事件監聽器的 ID,可搭配 event.removeListener 使用。 |
PollingLocationProvider 抽象類別
google.maps.journeySharing.PollingLocationProvider
抽象類別
投票地點提供者的上層類別。
這個抽象類別會擴充 LocationProvider
。
屬性 | |
---|---|
isPolling |
類型:
boolean 如果這個位置提供者正在進行輪詢,則為「是」。唯讀。 |
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 導致輪詢狀態變更的錯誤 (這是因錯誤所致)。狀態因作業正常而變更時未定義。 |