Info Window

InfoWindow 類別

google.maps.InfoWindow 類別

一種疊加層，看起來像泡泡，而且通常連接至標記。

這個類別會擴充 MVCObject。

呼叫 const {InfoWindow} = await google.maps.importLibrary("maps") 或 const {InfoWindow} = await google.maps.importLibrary("streetView") 即可存取。請參閱 Maps JavaScript API 中的程式庫。
InfoWindow
InfoWindow([opts])
參數： 
使用指定選項建立資訊視窗。視選項中指定的內容而定，資訊視窗可用於放置在特定位置或標記上方。除非停用自動平移功能，否則資訊視窗會平移地圖來顯示它，建構 InfoWindow 之後，您必須呼叫 Open，才能在地圖上顯示資訊視窗。使用者可以按一下資訊視窗上的關閉按鈕，就可以將它從地圖上移除，或者開發人員可以呼叫 close()，達到一樣的效果。
close
close()
參數：無
傳回值：無
從 DOM 結構移除這個資訊視窗，就能關閉這個資訊視窗。
focus
focus()
參數：無
傳回值：無
將焦點放在這個 InfoWindow。建議您搭配 visible 事件使用這個方法，確保先設定 InfoWindow 再顯示焦點。無法觀測的 InfoWindow 無法聚焦。
getContent
getContent()
參數：無
傳回值：  string|Element|null|Text|undefined這個資訊視窗的內容。與先前的內容相同。
getPosition
getPosition()
參數：無
傳回值：  LatLng|null|undefined這個資訊視窗的經緯度位置。
getZIndex
getZIndex()
參數：無
傳回值：  number這個資訊視窗的 zIndex。
open
open([options, anchor])
參數： 
  • options：InfoWindowOpenOptions|Map|StreetViewPanorama optional無論是 InfoWindowOpenOptions 物件 (建議做法) 或是要顯示這個資訊視窗的地圖|全景。
  • anchor：MVCObject|AdvancedMarkerElement optional將這個資訊視窗放置的錨點。如果錨點為非空值，InfoWindow 會位於錨點的正中央。InfoWindow 會和錨定標記 (如有提供) 在同一個地圖上或全景上顯示。
傳回值：無
在指定的地圖上開啟這個資訊視窗。您也可以將 InfoWindow 與錨點建立關聯。在核心 API 中，唯一的錨點是 Marker 類別。不過，錨點可以是任何公開 LatLng position 屬性的 MVCObject，以及計算 pixelOffset 的定位點 anchorPoint 屬性 (請參閱 InfoWindowOptions)。anchorPoint 是從錨點到 InfoWindow 尖端的偏移值。建議您使用 InfoWindowOpenOptions 介面做為這個方法的單一引數。如要防止變更瀏覽器開啟的焦點，請將 InfoWindowOpenOptions.shouldFocus 設為 false。
setContent
setContent([content])
參數： 
  • content：string|Element|Text optional 這個資訊視窗顯示的內容。
傳回值：無
setOptions
setOptions([options])
參數： 
傳回值：無
setPosition
setPosition([position])
參數： 
傳回值：無
setZIndex
setZIndex(zIndex)
參數： 
  • zIndex：number InfoWindow 的 Z-index。系統會將 Z-index 值較大的資訊視窗顯示在 Z-index 值較低的所有其他資訊視窗前。
傳回值：無
沿用於： addListener、bindTo、get、notify、set、setValues、unbind、unbindAll
closeclick
function()
引數：無
按一下關閉按鈕時，會引發此事件。
content_changed
function()
引數：無
按一下 content 屬性時，會引發此事件。
domready
function()
引數：無
包含 InfoWindow 內容的 <div> 附加至 DOM 時，會觸發此事件。如果您是以動態方式建構資訊視窗內容，您可能希望能監控這個事件。
position_changed
function()
引數：無
當 position 屬性變更後，會引發此事件。
visible
function()
引數：無
InfoWindow 完全顯示時，會觸發這個事件。InfoWindow 平移並放回螢幕上時，不會觸發這個事件。
zindex_changed
function()
引數：無
當 InfoWindow 的 zIndex 變更時，會觸發這個事件。

InfoWindowOptions 介面

google.maps.InfoWindowOptions 介面

InfoWindowOptions 物件，用來定義可在 InfoWindow 中設定的屬性。
ariaLabel optional
類型：  string optional
指派給 InfoWindow 的 AriaLabel。
content optional
類型：  string|Element|Text optional
要在 InfoWindow 中顯示的內容。這可以是 HTML 元素、純文字字串，或包含 HTML 的字串。資訊視窗將隨著內容調整大小。如果要另外設定內容的大小，可以將內容設定成該大小的 HTML 元素。
disableAutoPan optional
類型：  boolean optional
預設值： false
停用平移地圖，完全開啟資訊視窗。
maxWidth optional
類型：  number optional
InfoWindow 的寬度上限，無論內容寬度為何。只有在呼叫 open() 之前設定這個值時，系統才會將其視為這個值。如要在變更內容時變更寬度上限，請呼叫 close()、setOptions()，然後呼叫 open()。
minWidth optional
類型：  number optional
InfoWindow 的最小寬度，無論內容寬度為何。使用這個屬性時，強烈建議您將 minWidth 設為小於地圖寬度的寬度 (以像素為單位)。只有在呼叫 open() 之前設定這個值時，系統才會將其視為這個值。如要在變更內容時變更最小寬度，請呼叫 close()、setOptions() 和 open()。
pixelOffset optional
類型：  Size optional
資訊視窗尖端從資訊視窗的點到錨定位置的座標 (以像素為單位)。如果使用錨點開啟資訊視窗，pixelOffset 會從錨點的 anchorPoint 屬性計算。
position optional
類型：  LatLng|LatLngLiteral optional
顯示這個資訊視窗的經緯度。如果使用錨點開啟資訊視窗，會改為使用錨點的位置。
zIndex optional
類型：  number optional
所有 InfoWindows 都會依照 zIndex 順序顯示在地圖上，值較高的資訊視窗會顯示在值較小的資訊視窗前。預設設定資訊視窗會顯示在標記的前面。

InfoWindowOpenOptions 介面

google.maps.InfoWindowOpenOptions 介面

開啟 InfoWindow 的選項
anchor optional
類型：  MVCObject|AdvancedMarkerElement optional
這個 InfoWindow 的錨定位置。如果錨點為非空值，InfoWindow 會位於錨點的正中央。InfoWindow 會和錨定標記 (如有提供) 在同一個地圖上或全景上顯示。
map optional
類型：  Map|StreetViewPanorama optional
要呈現這個資訊視窗的地圖或全景。
shouldFocus optional
類型：  boolean optional
是否要在資訊視窗開啟資訊視窗時移動焦點。如未設定這個屬性，或設為 null 或 undefined，系統就會使用經驗法則判斷是否要移動焦點。建議您根據自身需求明確設定這個屬性，因為經驗法可能會隨時變更，而且可能不適用於所有用途。