Map View

LocalContextMapView 類別

google.maps.localContext.LocalContextMapView class

已淘汰：當地特色已淘汰，不再建議用於新網站。相關功能會繼續運作；如要停止支援，我們會在 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 class

注意：僅適用於 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	地點詳細資料會在路線開頭與地圖內文中顯示。(如果是從左至右書寫的語言，則表示地點詳細資料位於地圖左側)。