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 版。

Place Details 的版面配置模式。

呼叫 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	地點詳細資料會隨著地圖線條開頭顯示。(如果是由左至右的語言，代表地點詳細資料位於地圖左側)。