LocalContextMapView 類別
google.maps.localContext.LocalContextMapView
類別
使用 Map
顯示本機情境體驗。
這個類別會實作 LocalContextMapViewOptions
。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta
時,可透過呼叫 const {LocalContextMapView} = await google.map.importLibrary("localContext")
來存取請參閱 Maps JavaScript API 中的程式庫。
建構函式 | |
---|---|
LocalContextMapView |
LocalContextMapView(options) 參數:
|
屬性 | |
---|---|
directionsOptions |
類型:
MapDirectionsOptions|MapDirectionsOptionsLiteral optional |
element optional |
類型:
HTMLElement|SVGElement optional 這是唯讀欄位。支援檢視畫面的 DOM 元素。 |
isTransitioningMapBounds |
類型:
boolean 會在 LocalContextMapView 開始變更內部 Map 的邊界之前設為 true ,並在 LocalContextMapView 變更內部 Map 的邊界後設為 false 。(如果因為自動調整大小而有所改變,當版面配置模式發生變更時,系統不會設定這個格式)。 |
locationBias |
類型:
LocationBias optional 詳情請參閱《 LocalContextMapViewOptions.locationBias 》。在 LocalContextMapView 上變更此屬性可能會觸發新的搜尋。 |
locationRestriction |
類型:
LocationRestriction optional 詳情請參閱《 LocalContextMapViewOptions.locationRestriction 》。在 LocalContextMapView 上變更此屬性可能會觸發新的搜尋。 |
maxPlaceCount |
類型:
number 詳情請參閱《 LocalContextMapViewOptions.maxPlaceCount 》。在 LocalContextMapView 上變更此屬性可能會觸發新的搜尋。 |
placeTypePreferences |
詳情請參閱《 LocalContextMapViewOptions.placeTypePreferences 》。在 LocalContextMapView 上變更此屬性可能會觸發新的搜尋。「Iterable<string|PlaceTypePreference> 」也接受。 |
繼承:
map 、
pinOptionsSetup 、
placeChooserViewSetup 、
placeDetailsViewSetup
|
方法 | |
---|---|
addListener |
addListener(eventName, handler) 參數:
將指定的事件監聽器函式新增至指定的事件名稱。 |
hidePlaceDetailsView |
hidePlaceDetailsView() 參數:無
傳回值:無
隱藏地點詳細資訊。 |
search |
search() 參數:無
傳回值:無
根據目前的 maxPlaceCount 、placeTypePreferences 、locationRestriction 和locationBias ,搜尋要向使用者顯示的地點。 |
活動 | |
---|---|
error |
function(event) 引數:
如果執行搜尋時發生錯誤,此事件會觸發。 |
placedetailsviewhidestart |
function() 引數:無
地點詳細資料開始動畫之前,會引發此事件。 |
placedetailsviewshowstart |
function() 引數:無
地點詳細資料開始動畫之前,會引發此事件。 |
LocalContextMapViewOptions 介面
google.maps.localContext.LocalContextMapViewOptions
介面
建構 LocalContextMapView
或存取現有 LocalContextMapView
的選項。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
---|---|
maxPlaceCount |
類型:
number 可顯示的地點數量上限。當這個參數為 0 時,本機內容資料庫不會載入地點。[0,24]。 |
placeTypePreferences |
要搜尋的地點類型 (最多 10 個)。也接受 Iterable<string|PlaceTypePreference> 類型,但僅適用於原生支援 JavaScript 符號的瀏覽器。 |
directionsOptions optional |
類型:
MapDirectionsOptions|MapDirectionsOptionsLiteral optional 自訂路線的選項。如果未設定,則會停用路線和距離。 |
element optional |
類型:
HTMLElement|SVGElement optional 這是唯讀欄位。支援檢視畫面的 DOM 元素。 |
locationBias optional |
類型:
LocationBias optional 預設:
null 用來搜尋地點的軟界線或用字提示。 |
locationRestriction optional |
類型:
LocationRestriction optional 限制搜尋結果的邊界。如未指定,結果將限制在地圖可視區域之外。 |
map optional |
類型:
Map optional 已執行個體化的 Map 執行個體。如果傳入,地圖將移至 LocalContextMapView 的 DOM,且不會重新設定樣式。與地圖相關聯的元素也可能有 LocalContextMapView 套用至該樣式的樣式和類別。 |
pinOptionsSetup optional |
類型:
(function({ 根據圖示狀態設定地點標記圖示。每當回呼的輸入內容變更時,就會叫用。傳遞函式。當 LocalContextMapView 繪製地點標記時,會動態覆寫預設設定。錯誤和無效設定可透過非同步方式判斷,並予以忽略 (系統會採用預設值,將記錄至主控台)。 |
placeChooserViewSetup optional |
類型:
(function({ 覆寫地點選擇器檢視的設定。當 LocalContextMapView 因為調整大小而可能變更其版面配置時,傳遞函式以動態覆寫預設設定。錯誤和無效設定可透過非同步方式判斷,並予以忽略 (系統會採用預設值,並將錯誤記錄在控制台中)。建構時偵測到的錯誤會導致同步錯誤。 |
placeDetailsViewSetup optional |
類型:
(function({ 覆寫地點詳細資料檢視畫面的設定。當 LocalContextMapView 因為調整大小而可能變更其版面配置時,傳遞函式以動態覆寫預設設定。錯誤和無效設定可透過非同步方式判斷,並予以忽略 (系統會採用預設值,將記錄至主控台)。建構時偵測到的錯誤會導致同步錯誤。 |
PlaceTypePreference typedef
google.maps.localContext.PlaceTypePreference
typedef
要搜尋的地點類型和要使用的重量。如果省略 weight
,程式庫將判定預設權重,而這個結果可能會隨著時間改變及改善。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
{
type:string,
weight:number optional
}
MapDirectionsOptions 類別
google.maps.localContext.MapDirectionsOptions
類別
使用 LocalContextMapView
提供路線設定。
這個類別會實作 MapDirectionsOptionsLiteral
。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta
時,可透過呼叫 const {MapDirectionsOptions} = await google.map.importLibrary("localContext")
來存取請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
---|---|
繼承:
origin
|
方法 | |
---|---|
addListener |
addListener(eventName, handler) 參數:
將指定的事件監聽器函式新增至指定的事件名稱。 |
MapDirectionsOptionsLiteral 介面
google.maps.localContext.MapDirectionsOptionsLiteral
介面
為方便起見,我們允許多個物件使用物件常值來取代 MapDirectionsOptions
物件。當 Maps API 偵測到這些物件時,這些物件就會轉換為 MapDirectionsOptions
物件。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
---|---|
origin |
路線和距離的起點。 |
PinOptions 介面
google.maps.localContext.PinOptions
介面
自訂圖釘標記的選項。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
---|---|
background optional |
類型:
string optional 圖示形狀的顏色,可以是任何有效的 CSS 顏色。 |
glyphColor optional |
類型:
string optional 圖示字符的顏色顏色,可以是任何有效的 CSS 顏色。 |
scale optional |
類型:
number optional 圖示的縮放比例。這個值是絕對值,而不是每個狀態的預設大小。 |
PlaceChooserViewSetupOptions 介面
google.maps.localContext.PlaceChooserViewSetupOptions
介面
地點選擇器的設定選項。進一步瞭解如何設定版面配置和瀏覽權限。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
---|---|
layoutMode optional |
類型:
PlaceChooserLayoutMode optional |
position optional |
類型:
PlaceChooserPosition optional 忽略時為 layoutMode:HIDDEN 。如果未通過,系統會根據layoutMode 自動決定位置。 |
PlaceChooserLayoutMode 常數
google.maps.localContext.PlaceChooserLayoutMode
常數
地點選擇器的版面配置模式。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta
時,可透過呼叫 const {PlaceChooserLayoutMode} = await google.map.importLibrary("localContext")
來存取請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
HIDDEN |
地點選擇器已隱藏。 |
SHEET |
地點選擇工具會以工作表的形式顯示。 |
PlaceChooserPosition 常數
google.maps.localContext.PlaceChooserPosition
常數
顯示地點選擇器的位置。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta
時,可透過呼叫 const {PlaceChooserPosition} = await google.map.importLibrary("localContext")
來存取請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
BLOCK_END |
地圖選擇器會在地圖下方顯示延伸至容器末端的線條, |
INLINE_END |
地點選擇工具會顯示在線條最後的地圖中。(如果書寫方向是由左至右,代表地點選項位於地圖的右側)。 |
INLINE_START |
地點選擇工具會在地圖的開頭以地圖的形式顯示地圖。(這表示書寫方向由左至右,表示地點選擇工具位於地圖的左側)。 |
PlaceDetailsViewSetupOptions
google.maps.localContext.PlaceDetailsViewSetupOptions
介面
地點詳細資料的設定選項。進一步瞭解如何設定版面配置和瀏覽權限。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
屬性 | |
---|---|
hidesOnMapClick optional |
類型:
boolean optional |
layoutMode optional |
類型:
PlaceDetailsLayoutMode optional |
position optional |
類型:
PlaceDetailsPosition optional 忽略時為 layoutMode:INFO_WINDOW 。如果未通過,系統會根據layoutMode 自動決定位置。 |
PlaceDetailsLayoutMode 常數
google.maps.localContext.PlaceDetailsLayoutMode
常數
地點詳細資料的版面配置模式。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta
時,可透過呼叫 const {PlaceDetailsLayoutMode} = await google.map.importLibrary("localContext")
來存取請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
INFO_WINDOW |
地點詳細資料會顯示在 InfoWindow 中。 |
SHEET |
工作表詳細資料會顯示於工作表中。 |
PlaceDetailsPosition 常數
google.maps.localContext.PlaceDetailsPosition
常數
顯示地點詳細資料的位置。
使用 &libraries=localContext
網址參數載入。請參閱 Maps JavaScript API 中的程式庫。
使用 v=beta
時,可透過呼叫 const {PlaceDetailsPosition} = await google.map.importLibrary("localContext")
來存取請參閱 Maps JavaScript API 中的程式庫。
常數 | |
---|---|
INLINE_END |
地點詳細資訊會顯示在線條最後的地圖中。(這表示書寫方向由左至右,表示地點詳細資訊位於地圖右側)。 |
INLINE_START |
地點詳細資訊會在地圖的開頭以地圖的形式顯示。(這表示書寫方向由左至右,這表示地點詳細資訊位於地圖左側)。 |