Info Window

InfoWindow sınıfı

google.maps.InfoWindow sınıf

Balona benzeyen ve genellikle bir işaretçiye bağlı olan yer paylaşımı.

Bu sınıfın süresi MVCObject tarihinde sona eriyor.

const {InfoWindow} = await google.maps.importLibrary("maps") veya const {InfoWindow} = await google.maps.importLibrary("streetView") numaralarını arayarak erişebilirsiniz.
Maps JavaScript API'deki kitaplıklar başlıklı makaleyi inceleyin.

InfoWindow
InfoWindow([opts])
Parametreler: 
Belirtilen seçeneklerle bir bilgi penceresi oluşturur. InfoWindow, seçeneklerde belirtilenlere bağlı olarak haritada belirli bir konuma veya bir işaretçinin üzerine yerleştirilebilir. Otomatik kaydırma devre dışı bırakılmadığı sürece, bir bilgi penceresi açıldığında haritayı kaydırarak kendisini görünür hale getirir. Bir InfoWindow oluşturduktan sonra, haritada göstermek için open işlevini çağırmanız gerekir. Kullanıcı, bilgi penceresini haritadan kaldırmak için bilgi penceresindeki kapat düğmesini tıklayabilir veya geliştirici, aynı etki için close() işlevini çağırabilir.
isOpen
Tür:  boolean
InfoWindow'un açık olup olmadığını kontrol eder.
close
close()
Parametreler: Yok
Döndürülen Değer: Yok
DOM yapısından kaldırarak bu bilgi penceresini kapatır.
focus
focus()
Parametreler: Yok
Döndürülen Değer: Yok
Bu InfoWindow öğesine odaklanır. Odak ayarlanmadan önce InfoWindow öğesinin görünür olduğundan emin olmak için bu yöntemi bir visible etkinliğiyle birlikte kullanmayı düşünebilirsiniz. Görünür olmayan bir InfoWindow odaklanılamaz.
getContent
getContent()
Parametreler: Yok
Döndürülen Değer:  string|Element|Text|null|undefined Bu bilgi penceresinin içeriği. Daha önce içerik olarak ayarlananla aynı.
getHeaderContent
getHeaderContent()
Parametreler: Yok
Dönüş Değeri:  string|Element|Text|null|undefined Bu bilgi penceresinin başlık içeriği. InfoWindowOptions.headerContent sayfasına göz atın.
getHeaderDisabled
getHeaderDisabled()
Parametreler: Yok
Dönüş Değeri:  boolean|undefined Başlık satırının tamamının devre dışı olup olmadığı. InfoWindowOptions.headerDisabled sayfasına göz atın.
getPosition
getPosition()
Parametreler: Yok
Döndürülen Değer:  LatLng|null|undefined Bu bilgi penceresinin LatLng konumu.
getZIndex
getZIndex()
Parametreler: Yok
Döndürülen Değer:  number Bu InfoWindow'un zIndex'i.
open
open([options, anchor])
Parametreler: 
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional Bir InfoWindowOpenOptions nesnesi (önerilir) veya bu InfoWindow'un oluşturulacağı harita/panorama.
  • anchorMVCObject|AdvancedMarkerElement optional Bu InfoWindow'un konumlandırılacağı bağlantı. Sabitleme öğesi boş değilse bilgi penceresi, sabitleme öğesinin üst orta kısmına yerleştirilir. Bilgi penceresi, bağlantı ile aynı harita veya panoramada oluşturulur (kullanılabilir olduğunda).
Döndürülen Değer: Yok
Belirtilen haritada bu bilgi penceresini açar. İsteğe bağlı olarak, bir bilgi penceresi bir bağlantıyla ilişkilendirilebilir. Temel API'de tek bağlantı noktası Marker sınıfıdır. Ancak bir sabitleme noktası, LatLng position özelliğini ve isteğe bağlı olarak pixelOffset değerini hesaplamak için bir Point anchorPoint özelliğini kullanıma sunan herhangi bir MVCObject olabilir (bkz. InfoWindowOptions). anchorPoint, sabitleme noktasının konumundan bilgi penceresinin ucuna kadar olan uzaklıktır. Bu yöntem için tek bağımsız değişken olarak InfoWindowOpenOptions arayüzünün kullanılması önerilir. Açıldığında tarayıcı odağının değişmesini önlemek için InfoWindowOpenOptions.shouldFocus değerini false olarak ayarlayın.
setContent
setContent([content])
Parametreler: 
  • contentstring|Element|Text optional Bu bilgi penceresinde gösterilecek içerik.
Döndürülen Değer: Yok
setHeaderContent
setHeaderContent([headerContent])
Parametreler: 
Döndürülen Değer: Yok
setHeaderDisabled
setHeaderDisabled([headerDisabled])
Parametreler: 
  • headerDisabledboolean optional Başlık satırının tamamının devre dışı bırakılıp bırakılmayacağını belirtir. InfoWindowOptions.headerDisabled sayfasına göz atın.
Döndürülen Değer: Yok
setOptions
setOptions([options])
Parametreler: 
Döndürülen Değer: Yok
setPosition
setPosition([position])
Parametreler: 
  • positionLatLng|LatLngLiteral optional Bu bilgi penceresinin görüntüleneceği LatLng konumu.
Döndürülen Değer: Yok
setZIndex
setZIndex(zIndex)
Parametreler: 
  • zIndexnumber Bu bilgi penceresinin z-indeksi. Z-endeksi daha yüksek olan bir bilgi penceresi, z-endeksi daha düşük olan tüm diğer bilgi pencerelerinin önünde gösterilir.
Döndürülen Değer: Yok
Devralındı: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Bağımsız değişkenler: Yok
Bu etkinlik, InfoWindow her kapatıldığında tetiklenir. Örneğin, bu durum InfoWindow.close yöntemini çağırmak, bilgi penceresini kapatmak için Escape tuşuna basmak, kapatma düğmesini tıklamak veya bilgi penceresini başka bir haritaya taşımak gibi işlemlerden kaynaklanabilir.
closeclick
function()
Bağımsız değişkenler: Yok
Bu etkinlik, kapat düğmesi tıklandığında tetiklenir.
content_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, içerik özelliği değiştiğinde tetiklenir.
domready
function()
Bağımsız değişkenler: Yok
Bu etkinlik, InfoWindow içeriğini içeren <div>, DOM'a eklendiğinde tetiklenir. Bilgi penceresi içeriğinizi dinamik olarak oluşturuyorsanız bu etkinliği izlemek isteyebilirsiniz.
headercontent_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, headerContent özelliği değiştiğinde tetiklenir.
headerdisabled_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, headerDisabled özelliği değiştiğinde tetiklenir.
position_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, konum özelliği değiştiğinde tetiklenir.
visible
function()
Bağımsız değişkenler: Yok
Bu etkinlik, InfoWindow tam olarak görünür olduğunda tetiklenir. InfoWindow kaydırılıp ekranın dışına çıkarıldıktan sonra tekrar ekrana getirildiğinde bu etkinlik tetiklenmez.
zindex_changed
function()
Bağımsız değişkenler: Yok
Bu etkinlik, InfoWindow öğesinin zIndex'i değiştiğinde tetiklenir.

InfoWindowOptions arayüzü

google.maps.InfoWindowOptions arayüz

InfoWindow'da ayarlanabilecek özellikleri tanımlamak için kullanılan InfoWindowOptions nesnesi.

ariaLabel optional
Tür:  string optional
InfoWindow'a atanacak AriaLabel.
content optional
Tür:  string|Element|Text optional
InfoWindow'da gösterilecek içerik. Bu, bir HTML öğesi, düz metin dizesi veya HTML içeren bir dize olabilir. Bilgi penceresi, içeriğe göre boyutlandırılır. İçerik için açık bir boyut ayarlamak istiyorsanız içeriği bu boyutta bir HTML öğesi olarak ayarlayın.
disableAutoPan optional
Tür:  boolean optional
Varsayılan: false
Bilgi penceresi açıldığında tamamen görünür olması için harita kaydırmayı devre dışı bırakın.
headerContent optional
Tür:  string|Element|Text optional
InfoWindow başlık satırında gösterilecek içerik. Bu, bir HTML öğesi veya düz metin dizesi olabilir. Bilgi penceresi, içeriğe göre boyutlandırılır. Başlık içeriği için açık bir boyut ayarlamak üzere headerContent'i bu boyuta sahip bir HTML öğesi olarak ayarlayın.
headerDisabled optional
Tür:  boolean optional
Bilgi penceresindeki başlık satırının tamamını devre dışı bırakır. Doğru olarak ayarlandığında, üstbilgi içeriği ve kapatma düğmesi gizlenecek şekilde üstbilgi kaldırılır.
maxWidth optional
Tür:  number optional
İçeriğin genişliğinden bağımsız olarak bilgi penceresinin maksimum genişliği. Bu değer yalnızca open() işlevine yapılan çağrıdan önce ayarlanmışsa dikkate alınır. İçerik değiştirilirken maksimum genişliği değiştirmek için close(), setOptions() ve ardından open() işlevini çağırın.
minWidth optional
Tür:  number optional
İçeriğin genişliğinden bağımsız olarak InfoWindow'un minimum genişliği. Bu özelliği kullanırken minWidth değerini haritanın genişliğinden (piksel cinsinden) daha küçük bir değere ayarlamanız önemle tavsiye edilir. Bu değer yalnızca open() işlevine yapılan çağrıdan önce ayarlanmışsa dikkate alınır. İçerik değiştirirken minimum genişliği değiştirmek için close(), setOptions() ve ardından open() işlevini çağırın.
pixelOffset optional
Tür:  Size optional
Bilgi penceresinin ucunun, bilgi penceresinin coğrafi koordinatlarına sabitlendiği haritadaki noktadan olan piksel cinsinden ofseti. Bir bilgi penceresi bağlantıyla açılırsa pixelOffset, bağlantının anchorPoint özelliğinden hesaplanır.
position optional
Tür:  LatLng|LatLngLiteral optional
Bu InfoWindow'un görüntüleneceği LatLng. InfoWindow bir bağlantı ile açılırsa bunun yerine bağlantının konumu kullanılır.
zIndex optional
Tür:  number optional
Tüm bilgi pencereleri, zIndex değerlerine göre haritada gösterilir. Daha yüksek değerler, daha düşük değerlere sahip bilgi pencerelerinin önünde gösterilir. Varsayılan olarak bilgi pencereleri enlemlerine göre görüntülenir. Daha düşük enlemlerdeki bilgi pencereleri, daha yüksek enlemlerdeki bilgi pencerelerinin önünde görünür. Bilgi pencereleri her zaman işaretçilerin önünde gösterilir.

InfoWindowOpenOptions arayüzü

google.maps.InfoWindowOpenOptions arayüz

InfoWindow açma seçenekleri

anchor optional
Bu bilgi penceresinin konumlandırılacağı bağlantı. Sabitleme öğesi boş değilse bilgi penceresi, sabitleme öğesinin üst orta kısmına yerleştirilir. Bilgi penceresi, bağlantı ile aynı harita veya panoramada oluşturulur (kullanılabilir olduğunda).
map optional
Tür:  Map|StreetViewPanorama optional
Bu bilgi penceresinin oluşturulacağı harita veya panorama.
shouldFocus optional
Tür:  boolean optional
InfoWindow açıldığında odağın InfoWindow'un içine taşınıp taşınmayacağı. Bu özellik ayarlanmadığında veya null ya da undefined olarak ayarlandığında odağın taşınıp taşınmaması gerektiğine karar vermek için bir sezgisel yöntem kullanılır. Sezgisel yöntem değişime tabidir ve tüm kullanım alanlarında iyi çalışmayabilir. Bu nedenle, bu özelliği ihtiyaçlarınıza uyacak şekilde açıkça ayarlamanız önerilir.