Info Window

InfoWindow 類別

google.maps.InfoWindow 類別

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

此類別會擴充 MVCObject。

建構函式
InfoWindow	InfoWindow([opts]) 參數： opts：InfoWindowOptions optional 使用指定選項建立資訊視窗。根據選項中指定的項目，資訊視窗可放在特定位置或標記的地圖上。除非停用自動平移功能，否則資訊視窗會平移地圖，以便在開啟時自行顯示。建立資訊視窗後，必須呼叫「開啟」才能在地圖上顯示該資訊視窗。使用者可以按一下資訊視窗上的關閉按鈕，就可以將它從地圖上移除，或者開發人員可以呼叫 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|AdvancedMarkerView optional 這個資訊視窗的定位點。如果錨點不是空值，則資訊視窗將放置在錨點的正中央。資訊視窗會在與錨點相同的地圖或全景上顯示 (如果有的話)。 傳回值：無 在指定地圖上開啟這個資訊視窗。您可以選擇將資訊視窗與錨點建立關聯。在核心 API 中，唯一的錨點是 Marker 類別。不過，錨點可以是公開 LatLng position 屬性和選用 anchorPoint 屬性 (用於計算 pixelOffset) 的任何 MVCObject (請參閱 InfoWindowOptions)。anchorPoint 是從錨點的位置到 InfoWindow 提示的偏移量。建議您使用 InfoWindowOpenOptions 介面做為這個方法的單一引數。如要避免瀏覽器開啟時開啟焦點，請將 InfoWindowOpenOptions.shouldFocus 設為 false。
setContent	setContent([content]) 參數： content：string|Element|Text optional 這個資訊視窗顯示的內容。 傳回值：無
setOptions	setOptions([options]) 參數： options：InfoWindowOptions optional 傳回值：無
setPosition	setPosition([position]) 參數： position：LatLng|LatLngLiteral optional 這個資訊視窗的經緯度位置。 傳回值：無
setZIndex	setZIndex(zIndex) 參數： zIndex：number 這個資訊視窗的 Z-index。Z-index 值較高的 InfoWindow 會顯示在 Z-index 值較低的所有其他 InfoWindows 前面。 傳回值：無
繼承： 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 物件。

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

InfoWindowOpenOptions 介面

google.maps.InfoWindowOpenOptions 介面

開啟資訊視窗的選項

屬性
anchor optional	類型：MVCObject|AdvancedMarkerView optional 這個資訊視窗的放置位置。如果錨點不是空值，則資訊視窗將放置在錨點的正中央。資訊視窗會在與錨點相同的地圖或全景上顯示 (如果有的話)。
map optional	類型：Map|StreetViewPanorama optional 顯示這個資訊視窗的地圖或全景。
shouldFocus optional	類型：boolean optional 是否要在開啟時將焦點移至資訊視窗。如未設定此屬性或設為 null 或 undefined 時，系統會使用經驗法則判斷是否要移動焦點。建議您根據自身需求明確設定這個屬性，因為經驗法則可能有所變動，且不一定適用於所有用途。