Map View

LocalContextMapView 類別

google.maps.localContext.LocalContextMapView 類別

已淘汰：本機內容已淘汰，不再建議用於新網站。這項功能仍會繼續運作，並在支援服務終止前 12 個月發出通知。如果您想自行建構類似情境的體驗，建議您查看快速建構工具中的「鄰近地區探索」解決方案，或使用 Maps JavaScript API Places Library。Places Library 的程式碼範例和程式碼研究室可協助您完成這個問題。

注意：僅適用於 v=beta 版本。

使用 Map 顯示本機情境體驗。

這個類別會實作 LocalContextMapViewOptions。

呼叫 const {LocalContextMapView} = await google.maps.importLibrary("localContext") 即可存取。請參閱 Maps JavaScript API 中的程式庫。

建構函式
LocalContextMapView	LocalContextMapView(options) 參數：  options：LocalContextMapViewOptions

屬性
directionsOptions	類型：  MapDirectionsOptions|MapDirectionsOptionsLiteral optional 查看《LocalContextMapViewOptions.directionsOptions》。
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	類型：  Array<PlaceTypePreference> 詳情請參閱《LocalContextMapViewOptions.placeTypePreferences》。在 LocalContextMapView 上變更此屬性可能會觸發新的搜尋。「Iterable<string|PlaceTypePreference>」也接受。
繼承： map、 pinOptionsSetup、 placeChooserViewSetup、 placeDetailsViewSetup

方法
addListener	addListener(eventName, handler) 參數：  eventName：string handler：Function 傳回值：  MapsEventListener 將指定的事件監聽器函式新增至指定的事件名稱。
hidePlaceDetailsView	hidePlaceDetailsView() 參數：無 傳回值：無 隱藏地點詳細資訊。
search	search() 參數：無 傳回值：無 根據目前的maxPlaceCount、placeTypePreferences、locationRestriction和locationBias，搜尋要向使用者顯示的地點。

事件
error	function(event) 引數：  event：ErrorEvent 如果執行搜尋時發生錯誤，此事件會觸發。
placedetailsviewhidestart	function() 引數：無 地點詳細資料開始動畫之前，會引發此事件。
placedetailsviewshowstart	function() 引數：無 地點詳細資料開始動畫之前，會引發此事件。

LocalContextMapViewOptions 介面

google.maps.localContext.LocalContextMapViewOptions 介面

注意：僅適用於 v=beta 版本。

建構 LocalContextMapView 或存取現有 LocalContextMapView 的選項。

屬性
maxPlaceCount	類型：  number 可顯示的地點數量上限。當這個參數為 0 時，本機內容資料庫不會載入地點。[0,24]。
placeTypePreferences	類型：  Array<PlaceTypePreference> 要搜尋的地點類型 (最多 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({   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

注意：僅適用於 v=beta 版本。

要搜尋的地點類型和要使用的重量。如果省略 weight，程式庫將判定預設權重，而這個結果可能會隨著時間改變及改善。

{
  type:string,
  weight:number optional
}

MapDirectionsOptions 類別

google.maps.localContext.MapDirectionsOptions 類別

注意：僅適用於 v=beta 版本。

使用 LocalContextMapView 提供路線設定。

這個類別會實作 MapDirectionsOptionsLiteral。

呼叫 const {MapDirectionsOptions} = await google.maps.importLibrary("localContext") 即可存取。請參閱 Maps JavaScript API 中的程式庫。

屬性
繼承： origin

方法
addListener	addListener(eventName, handler) 參數：  eventName：string handler：Function 傳回值：  MapsEventListener 將指定的事件監聽器函式新增至指定的事件名稱。

MapDirectionsOptionsLiteral 介面

google.maps.localContext.MapDirectionsOptionsLiteral 介面

注意：僅適用於 v=beta 版本。

為方便起見，我們允許多個物件使用物件常值來取代 MapDirectionsOptions 物件。當 Maps API 偵測到這些物件時，這些物件就會轉換為 MapDirectionsOptions 物件。

屬性
origin	類型：  LatLng|LatLngLiteral 路線和距離的起點。

PinOptions 介面

google.maps.localContext.PinOptions 介面

注意：僅適用於 v=beta 版本。

自訂圖釘標記的選項。

屬性
background optional	類型：  string optional 圖示形狀的顏色，可以是任何有效的 CSS 顏色。
glyphColor optional	類型：  string optional 圖示字符的顏色顏色，可以是任何有效的 CSS 顏色。
scale optional	類型：  number optional 圖示的縮放比例。這個值是絕對值，而不是每個狀態的預設大小。

PlaceChooserViewSetupOptions 介面

google.maps.localContext.PlaceChooserViewSetupOptions 介面

地點選擇器的設定選項。進一步瞭解如何設定版面配置和瀏覽權限。

屬性
layoutMode optional	類型：  PlaceChooserLayoutMode optional
position optional	類型：  PlaceChooserPosition optional 忽略時為 layoutMode:HIDDEN。如果未通過，系統會根據layoutMode自動決定位置。

PlaceChooserLayoutMode 常數

google.maps.localContext.PlaceChooserLayoutMode 常數

注意：僅適用於 v=beta 版本。

地點選擇器的版面配置模式。

呼叫 const {PlaceChooserLayoutMode} = await google.maps.importLibrary("localContext") 即可存取。請參閱 Maps JavaScript API 中的程式庫。

常數
HIDDEN	地點選擇器已隱藏。
SHEET	地點選擇工具會以工作表的形式顯示。

PlaceChooserPosition 常數

google.maps.localContext.PlaceChooserPosition 常數

注意：僅適用於 v=beta 版本。

顯示地點選擇器的位置。

呼叫 const {PlaceChooserPosition} = await google.maps.importLibrary("localContext") 即可存取。請參閱 Maps JavaScript API 中的程式庫。

常數
BLOCK_END	地圖選擇器會在地圖下方顯示延伸至容器末端的線條，
INLINE_END	地點選擇工具會顯示在線條最後的地圖中。(如果書寫方向是由左至右，代表地點選項位於地圖的右側)。
INLINE_START	地點選擇工具會在地圖的開頭以地圖的形式顯示地圖。(這表示書寫方向由左至右，表示地點選擇工具位於地圖的左側)。

PlaceDetailsViewSetupOptions

google.maps.localContext.PlaceDetailsViewSetupOptions 介面

地點詳細資料的設定選項。進一步瞭解如何設定版面配置和瀏覽權限。

屬性
hidesOnMapClick optional	類型：  boolean optional
layoutMode optional	類型：  PlaceDetailsLayoutMode optional
position optional	類型：  PlaceDetailsPosition optional 忽略時為 layoutMode:INFO_WINDOW。如果未通過，系統會根據layoutMode自動決定位置。

PlaceDetailsLayoutMode 常數

google.maps.localContext.PlaceDetailsLayoutMode 常數

注意：僅適用於 v=beta 版本。

地點詳細資料的版面配置模式。

呼叫 const {PlaceDetailsLayoutMode} = await google.maps.importLibrary("localContext") 即可存取。請參閱 Maps JavaScript API 中的程式庫。

常數
INFO_WINDOW	地點詳細資料會顯示在 InfoWindow 中。
SHEET	工作表詳細資料會顯示於工作表中。

PlaceDetailsPosition 常數

google.maps.localContext.PlaceDetailsPosition 常數

注意：僅適用於 v=beta 版本。

顯示地點詳細資料的位置。

呼叫 const {PlaceDetailsPosition} = await google.maps.importLibrary("localContext") 即可存取。請參閱 Maps JavaScript API 中的程式庫。

常數
INLINE_END	地點詳細資訊會顯示在線條最後的地圖中。(這表示書寫方向由左至右，表示地點詳細資訊位於地圖右側)。
INLINE_START	地點詳細資訊會在地圖的開頭以地圖的形式顯示。(這表示書寫方向由左至右，這表示地點詳細資訊位於地圖左側)。