Map View

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

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
element optional
類型:Element 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>」也接受。
繼承: mappinOptionsSetupplaceChooserViewSetupplaceDetailsViewSetup
addListener
addListener(eventName, handler)
參數:
傳回值:MapsEventListener
將指定的事件監聽器函式新增至指定的事件名稱。
hidePlaceDetailsView
hidePlaceDetailsView()
參數:
傳回值:
隱藏地點詳細資訊。
search
search()
參數:
傳回值:
根據目前的maxPlaceCountplaceTypePreferenceslocationRestrictionlocationBias,搜尋要向使用者顯示的地點。
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
自訂路線的選項。如果未設定,則會停用路線和距離。
element optional
類型:Element optional
這是唯讀欄位。支援檢視畫面的 DOM 元素。
locationBias optional
類型:LocationBias optional
預設:null
用來搜尋地點的軟界線或用字提示。
locationRestriction optional
類型:LocationRestriction optional
限制搜尋結果的邊界。如未指定,結果將限制在地圖可視區域之外。
map optional
類型:Map optional
已執行個體化的 Map 執行個體。如果傳入,地圖將移至 LocalContextMapView 的 DOM,且不會重新設定樣式。與地圖相關聯的元素也可能有 LocalContextMapView 套用至該樣式的樣式和類別。
pinOptionsSetup optional
類型:(function({
  isSelected:boolean,
  isHighlighted:boolean
}): (PinOptions optional))|PinOptions optional
根據圖示狀態設定地點標記圖示。每當回呼的輸入內容變更時,就會叫用。傳遞函式。當 LocalContextMapView 繪製地點標記時,會動態覆寫預設設定。錯誤和無效設定可透過非同步方式判斷,並予以忽略 (系統會採用預設值,將記錄至主控台)。
placeChooserViewSetup optional
類型:(function({
  defaultLayoutMode:PlaceChooserLayoutMode,
  defaultPosition:PlaceChooserPosition optional
}): (PlaceChooserViewSetupOptions optional))|PlaceChooserViewSetupOptions optional
覆寫地點選擇器檢視的設定。當 LocalContextMapView 因為調整大小而可能變更其版面配置時,傳遞函式以動態覆寫預設設定。錯誤和無效設定可透過非同步方式判斷,並予以忽略 (系統會採用預設值,並將錯誤記錄在控制台中)。建構時偵測到的錯誤會導致同步錯誤。
placeDetailsViewSetup optional
類型:(function({
  defaultLayoutMode:PlaceDetailsLayoutMode,
  defaultPosition:PlaceDetailsPosition optional
}): (PlaceDetailsViewSetupOptions optional))|PlaceDetailsViewSetupOptions optional
覆寫地點詳細資料檢視畫面的設定。當 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)
參數:
傳回值:MapsEventListener
將指定的事件監聽器函式新增至指定的事件名稱。

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 地點詳細資訊會在地圖的開頭以地圖的形式顯示。(這表示書寫方向由左至右,這表示地點詳細資訊位於地圖左側)。