Info Window

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

InfoWindow 類別

google.maps.InfoWindow 類別

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

此類別會擴充 MVCObject

InfoWindow
InfoWindow([opts])
參數:
使用指定選項建立資訊視窗。根據選項中指定的項目,資訊視窗可放在特定位置或標記的地圖上。除非停用自動平移功能,否則資訊視窗會平移地圖,以便在開啟時自行顯示。建立資訊視窗後,必須呼叫「開啟」才能在地圖上顯示該資訊視窗。使用者可以按一下資訊視窗上的關閉按鈕,就可以將它從地圖上移除,或者開發人員可以呼叫 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])
參數:
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional 提供 InfoWindowOpenOptions 物件 (建議) 或用來顯示此資訊視窗的對應|全景圖片。
  • anchorMVCObject optional 這個資訊視窗的定位點。如果錨點不是空值,則資訊視窗將放置在錨點的正中央。資訊視窗會在與錨點相同的地圖或全景上顯示 (如果有的話)
傳回值:
在指定地圖上開啟這個資訊視窗。您可以選擇將資訊視窗與錨點建立關聯。在核心 API 中,唯一的錨點是 Marker 類別。不過,錨點可以是公開 LatLng position 屬性和選用 anchorPoint 屬性 (用於計算 pixelOffset) 的任何 MVCObject (請參閱 InfoWindowOptions)。anchorPoint 是從錨點的位置到 InfoWindow 提示的偏移量。建議您使用 InfoWindowOpenOptions 介面做為這個方法的單一引數。如要避免瀏覽器開啟時開啟焦點,請將 InfoWindowOpenOptions.shouldFocus 設為 false
setContent
setContent([content])
參數:
  • contentstring|Element|Text optional 這個資訊視窗顯示的內容。
傳回值:
setOptions
setOptions([options])
參數:
傳回值:
setPosition
setPosition([position])
參數:
傳回值:
setZIndex
setZIndex(zIndex)
參數:
  • zIndexnumber 這個資訊視窗的 Z-index。Z-index 值較高的 InfoWindow 會顯示在 Z-index 值較低的所有其他 InfoWindows 前面。
傳回值:
繼承: addListenerbindTogetnotifysetsetValuesunbindunbindAll
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 optional
這個資訊視窗的放置位置。如果錨點不是空值,則資訊視窗將放置在錨點的正中央。資訊視窗會在與錨點相同的地圖或全景上顯示 (如果有的話)
map optional
類型:Map|StreetViewPanorama optional
顯示這個資訊視窗的地圖或全景。
shouldFocus optional
類型:boolean optional
是否要在開啟時將焦點移至資訊視窗。如未設定此屬性或設為 nullundefined 時,系統會使用經驗法則判斷是否要移動焦點。建議您根據自身需求明確設定這個屬性,因為經驗法則可能有所變動,且不一定適用於所有用途。