Info Window

Class InfoWindow

Class google.maps.InfoWindow

Overlay yang terlihat seperti balon dan sering terhubung ke penanda.

Class ini memperluas MVCObject.

Saat menggunakan v=beta, dapat diakses dengan memanggil const {InfoWindow} = await google.map.importLibrary("maps") atau const {InfoWindow} = await google.map.importLibrary("streetView"). Lihat Library di Maps JavaScript API.

InfoWindow
InfoWindow([opts])
Parameter:
Membuat jendela info dengan opsi yang diberikan. InfoWindow dapat ditempatkan pada peta pada posisi tertentu atau di atas penanda, tergantung pada apa yang ditentukan dalam opsi. Kecuali pergeseran otomatis dinonaktifkan, InfoWindow akan menggeser peta agar terlihat saat dibuka. Setelah membuat InfoWindow, Anda harus memanggil open untuk menampilkannya di peta. Pengguna bisa mengklik tombol tutup pada InfoWindow untuk menghapusnya dari peta, atau developer bisa memanggil close() untuk mendapatkan efek yang sama.
close
close()
Parameter: Tidak ada
Nilai Hasil: Tidak Ada
Menutup InfoWindow ini dengan menghapusnya dari struktur DOM.
focus
focus()
Parameter: Tidak ada
Nilai Hasil: Tidak Ada
Menetapkan fokus pada InfoWindow ini. Sebaiknya pertimbangkan untuk menggunakan metode ini bersama dengan peristiwa visible untuk memastikan bahwa InfoWindow terlihat sebelum menetapkan fokus padanya. InfoWindow yang tidak terlihat tidak dapat difokuskan.
getContent
getContent()
Parameter: Tidak ada
Nilai Hasil: string|Element|null|Text|undefined Konten InfoWindow ini. Sama dengan yang sebelumnya ditetapkan sebagai konten.
getPosition
getPosition()
Parameter: Tidak ada
Nilai Hasil: LatLng|null|undefined Posisi LatLng InfoWindow ini.
getZIndex
getZIndex()
Parameter: Tidak ada
Nilai Hasil: number zIndex InfoWindow ini.
open
open([options, anchor])
Parameter:
  • optionsInfoWindowOpenOptions|Map|StreetViewPanorama optional Objek InfoWindowOpenOptions (direkomendasikan) atau peta|panorama yang akan merender InfoWindow ini.
  • anchor: MVCObject|AdvancedMarkerView optional Anchor tempat infoWindow ini akan diposisikan. Jika anchor tidak null, InfoWindow akan diposisikan di tengah atas anchor. InfoWindow akan dirender pada peta atau panorama yang sama dengan anchor (jika tersedia).
Nilai Hasil: Tidak Ada
Membuka InfoWindow ini pada peta yang ditentukan. Secara opsional, InfoWindow dapat dikaitkan dengan anchor. Di API inti, satu-satunya anchor adalah class Penanda. Namun, anchor dapat berupa MVCObject apa pun yang mengekspos properti LatLng position dan secara opsional properti anchorPoint properti untuk menghitung pixelOffset (lihat InfoWindowOptions). anchorPoint adalah offset dari posisi anchor ke ujung InfoWindow. Sebaiknya gunakan antarmuka InfoWindowOpenOptions sebagai argumen tunggal untuk metode ini. Untuk mencegah perubahan fokus browser saat terbuka, tetapkan InfoWindowOpenOptions.shouldFocus ke false.
setContent
setContent([content])
Parameter:
  • content: string|Element|Text optional Konten yang akan ditampilkan oleh InfoWindow ini.
Nilai Hasil: Tidak Ada
setOptions
setOptions([options])
Parameter:
Nilai Hasil: Tidak Ada
setPosition
setPosition([position])
Parameter:
  • position: LatLng|LatLngLiteral optional Posisi LatLng yang akan digunakan untuk menampilkan InfoWindow ini.
Nilai Hasil: Tidak Ada
setZIndex
setZIndex(zIndex)
Parameter:
  • zIndexnumber Indeks z untuk InfoWindow ini. InfoWindow dengan indeks z yang lebih besar akan ditampilkan di depan semua InfoWindows lainnya dengan indeks z yang lebih rendah.
Nilai Hasil: Tidak Ada
Diwariskan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function()
Argumen: Tidak ada
Peristiwa ini dipicu saat tombol tutup diklik.
content_changed
function()
Argumen: Tidak ada
Peristiwa ini dipicu saat properti konten berubah.
domready
function()
Argumen: Tidak ada
Peristiwa ini dipicu saat <div> yang berisi konten InfoWindow dikaitkan ke DOM. Anda mungkin ingin memantau peristiwa ini jika membuat konten jendela info secara dinamis.
position_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti posisi berubah.
visible
function()
Argumen: Tidak ada
Peristiwa ini dipicu saat InfoWindow terlihat sepenuhnya. Peristiwa ini tidak diaktifkan saat InfoWindow digeser, lalu kembali ke layar.
zindex_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat zIndex InfoWindow berubah.

Antarmuka InfoWindowOptions

Antarmuka google.maps.InfoWindowOptions

Objek InfoWindowOptions digunakan untuk menentukan properti yang dapat ditetapkan pada InfoWindow.

ariaLabel optional
Jenis: string optional
AriaLabel yang akan ditetapkan ke InfoWindow.
content optional
Jenis: string|Element|Text optional
Konten yang akan ditampilkan di InfoWindow. Ini dapat berupa elemen HTML, string teks biasa, atau string yang berisi HTML. InfoWindow akan diukur ukurannya sesuai dengan konten. Untuk menetapkan ukuran eksplisit bagi konten, setel konten menjadi elemen HTML dengan ukuran tersebut.
disableAutoPan optional
Jenis: boolean optional
Default: false
Nonaktifkan menggeser peta agar InfoWindow sepenuhnya terlihat saat dibuka.
maxWidth optional
Jenis: number optional
Lebar maksimum InfoWindow, berapa pun lebar konten. Nilai ini hanya dipertimbangkan jika ditetapkan sebelum panggilan ke open(). Untuk mengubah lebar maksimum saat mengubah konten, panggil close(), setOptions(), lalu open().
minWidth optional
Jenis: number optional
Lebar minimum InfoWindow, berapa pun lebar konten. Saat menggunakan properti ini, sebaiknya tetapkan minWidth ke nilai yang kurang dari lebar peta (dalam piksel). Nilai ini hanya dipertimbangkan jika ditetapkan sebelum panggilan ke open(). Untuk mengubah lebar minimum saat mengubah konten, panggil close(), setOptions(), lalu open().
pixelOffset optional
Jenis: Size optional
Offset, dalam piksel, dari ujung jendela info dari titik pada peta yang koordinat geografisnya ditambatkan oleh jendela info. Jika InfoWindow dibuka dengan anchor, pixelOffset akan dihitung dari properti anchorPoint anchor.
position optional
Jenis: LatLng|LatLngLiteral optional
LatLng yang akan digunakan untuk menampilkan InfoWindow ini. Jika InfoWindow dibuka dengan anchor, posisi anchor akan digunakan.
zIndex optional
Jenis: number optional
Semua InfoWindows ditampilkan pada peta menurut urutan zIndex, dengan nilai yang lebih tinggi akan ditampilkan di depan InfoWindows dengan nilai yang lebih rendah. Secara default, InfoWindows ditampilkan sesuai dengan lintangnya, dengan InfoWindows dari lintang bawah muncul di depan InfoWindows pada lintang yang lebih tinggi. InfoWindows selalu ditampilkan di depan penanda.

Antarmuka InfoWindowOpenOptions

Antarmuka google.maps.InfoWindowOpenOptions

Opsi untuk membuka InfoWindow

anchor optional
Anchor tempat InfoWindow ini akan diposisikan. Jika anchor tidak null, InfoWindow akan diposisikan di tengah atas anchor. InfoWindow akan dirender pada peta atau panorama yang sama dengan anchor (jika tersedia).
map optional
Jenis: Map|StreetViewPanorama optional
Peta atau panorama untuk merender InfoWindow ini.
shouldFocus optional
Jenis: boolean optional
Apakah fokus harus dipindahkan di dalam InfoWindow atau tidak saat dibuka. Jika properti ini tidak ditetapkan atau disetel ke null atau undefined, heuristik akan digunakan untuk menentukan apakah fokus harus dipindahkan atau tidak. Sebaiknya tetapkan properti ini secara eksplisit agar sesuai dengan kebutuhan Anda karena heuristiknya dapat berubah dan mungkin tidak berfungsi dengan baik untuk semua kasus penggunaan.