Info Window

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

InfoWindow 類別

google.maps.InfoWindow 類別

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

這個類別會擴充 MVCObject

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])
參數:
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional InfoWindowOpenOptions 物件 (建議) 或要在此資訊視窗中顯示的對應|全景圖片。
  • anchorMVCObject optional 這個 InfoWindow 所在的錨點。如果錨點不是空值,則資訊視窗將位於錨點的正中央。資訊視窗會在與錨點相同的地圖或全景上轉譯 (如適用)
傳回值:
在指定的地圖上開啟這個資訊視窗。您可以選擇將資訊視窗與錨點建立關聯。在核心 API 中,唯一的錨點是 Marker 類別。不過,錨點可以是公開 LatLng position 屬性和選用 anchorPoint 屬性 (用於計算 pixelOffset) 的任何 MVCObject (請參閱 InfoWindowOptions)。anchorPoint 是從錨點位置到資訊視窗提示的偏移量。建議您使用 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's zIndex 變更時,會觸發此事件。

InfoWindowOptions 介面

google.maps.InfoWindowOptions 介面介面

用於定義可在 InfoWindow 上設定的屬性的 InfoWindowOptions 物件。

ariaLabel optional
類型:string optional
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
顯示此資訊視窗的經緯度。如果是以錨點開啟資訊視窗,系統會改用錨點的位置。
zIndex optional
類型:number optional
所有 InfoWindows 都會以 zIndex 的順序顯示在地圖上,值較高的值會顯示在 InfoWindow 前面。根據預設,InfoWindow 會根據緯度顯示資訊,而 InfoWindow 的較低緯度將出現在 InfoWindow 前面。資訊視窗會顯示在標記的前面。

InfoWindowOpenOptions 介面

google.maps.InfoWindowOpenOptions 介面介面

開啟資訊視窗的做法

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