Map View

LocalContextMapView 類別

google.maps.localContext.LocalContextMapView 類別

顯示包含 Map 的當地特色體驗。

這個類別會實作 LocalContextMapViewOptions。

呼叫 const {LocalContextMapView} = await google.maps.importLibrary("localContext") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
LocalContextMapView
LocalContextMapView(options)
參數： 
directionsOptions
查看《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
查看《LocalContextMapViewOptions.placeTypePreferences》。在 LocalContextMapView 上變更這個屬性可能會觸發新的搜尋。系統也接受 Iterable<string|PlaceTypePreference>。
沿用： map、pinOptionsSetup、placeChooserViewSetup、placeDetailsViewSetup
addListener
addListener(eventName, handler)
參數： 
傳回值：  MapsEventListener
將指定的事件監聽器函式新增至指定的事件名稱。
hidePlaceDetailsView
hidePlaceDetailsView()
參數：無
傳回值：無
隱藏地點詳細資料。
search
search()
參數：無
傳回值：無
根據目前的 maxPlaceCount、placeTypePreferences、locationRestriction 和 locationBias 搜尋要向使用者顯示的地點。
error
function(event)
引數： 
如果執行搜尋時發生錯誤，會觸發此事件。
placedetailsviewhidestart
function()
引數：無
地點詳細資料開始動畫前，會引發此事件。
placedetailsviewshowstart
function()
引數：無
在地點詳細資料開始動畫之前，會引發此事件。

LocalContextMapViewOptions 介面

google.maps.localContext.LocalContextMapViewOptions 介面

建構 LocalContextMapView 或存取現有 LocalContextMapView 的選項。
maxPlaceCount
類型：  number
可顯示的地點數量上限。當這個參數為 0 時，當地特色資料庫不會載入地點。[0、24]
placeTypePreferences
要搜尋的地點類型 (最多 10 個)。系統也接受 Iterable<string|PlaceTypePreference> 類型，但只適用於原生支援 JavaScript 符號的瀏覽器。
directionsOptions 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

要搜尋的地點類型，以及要使用的體重。如果省略 weight，程式庫將決定預設權重，而權重可能會隨著時間變更及改善。

{
  type:string,
  weight:number optional
}

MapDirectionsOptions 類別

google.maps.localContext.MapDirectionsOptions 類別

提供包含 LocalContextMapView 的路線設定。

這個類別會實作 MapDirectionsOptionsLiteral。

呼叫 const {MapDirectionsOptions} = await google.maps.importLibrary("localContext") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
沿用： origin
addListener
addListener(eventName, handler)
參數： 
傳回值：  MapsEventListener
將指定的事件監聽器函式新增至指定的事件名稱。

MapDirectionsOptionsLiteral 介面

google.maps.localContext.MapDirectionsOptionsLiteral 介面

為了方便起見，許多地方都會接受物件實字取代 MapDirectionsOptions 物件。當 Maps API 發現這些物件時，系統會將這些物件轉換為 MapDirectionsOptions 物件。
origin
類型：  LatLng|LatLngLiteral
路線和距離的起點。

PinOptions 介面

google.maps.localContext.PinOptions 介面

自訂圖釘標記的選項。
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 常數

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

呼叫 const {PlaceChooserLayoutMode} = await google.maps.importLibrary("localContext") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
HIDDEN 地點選擇器已隱藏。
SHEET 地點選擇器顯示為工作表。

PlaceChooserPosition 常數

google.maps.localContext.PlaceChooserPosition 常數

顯示地點選擇器的位置。

呼叫 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 常數

Place Details 的版面配置模式。

呼叫 const {PlaceDetailsLayoutMode} = await google.maps.importLibrary("localContext") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
INFO_WINDOW 地點詳細資料會顯示在 InfoWindow 中。
SHEET 地點詳細資料會顯示在工作表中。

PlaceDetailsPosition 常數

google.maps.localContext.PlaceDetailsPosition 常數

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

呼叫 const {PlaceDetailsPosition} = await google.maps.importLibrary("localContext") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
INLINE_END 地點詳細資料會內嵌於地圖的結尾處。(如果使用由左至右的語言，代表地點詳細資料位於地圖的右側)。
INLINE_START 地點詳細資料會隨著地圖線條開頭顯示。(如果是由左至右的語言，代表地點詳細資料位於地圖左側)。