Info Window

Class InfoWindow

google.maps.InfoWindow class
extends MVCObject
library "maps", "streetView"

Overlay yang terlihat seperti balon dan sering kali terhubung ke penanda.

const {InfoWindow} = await google.maps.importLibrary("maps");
atau
const {InfoWindow} = await google.maps.importLibrary("streetView");
InfoWindow
InfoWindow([opts])
Parameter:
Membuat jendela info dengan opsi yang diberikan. InfoWindow dapat ditempatkan di peta pada posisi tertentu atau di atas penanda, bergantung pada apa yang ditentukan dalam opsi. Kecuali jika geser otomatis dinonaktifkan, InfoWindow akan menggeser peta agar terlihat saat dibuka. Setelah membuat InfoWindow, Anda harus memanggil open untuk menampilkannya di peta. Pengguna dapat mengklik tombol tutup pada InfoWindow untuk menghapusnya dari peta, atau developer dapat memanggil close() untuk efek yang sama.
isOpen
readonly
Jenis: boolean
Memeriksa apakah InfoWindow terbuka.
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|Text|null|undefined Konten InfoWindow ini. Sama dengan yang sebelumnya ditetapkan sebagai konten.
getHeaderContent
getHeaderContent()
Parameter: Tidak ada
Nilai Hasil: string|Element|Text|null|undefined Konten header InfoWindow ini. Lihat InfoWindowOptions.headerContent.
getHeaderDisabled
getHeaderDisabled()
Parameter: Tidak ada
Nilai Hasil: boolean|undefined Apakah seluruh baris header dinonaktifkan atau tidak. Lihat InfoWindowOptions.headerDisabled.
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:
  • options: InfoWindowOpenOptions|Map|StreetViewPanorama optional Objek InfoWindowOpenOptions (direkomendasikan) atau peta|panorama tempat InfoWindow ini akan dirender.
  • anchor: MVCObject|AdvancedMarkerElement optional Anchor tempat InfoWindow ini akan diposisikan. Jika anchor bukan null, InfoWindow akan diposisikan di tengah atas anchor. InfoWindow akan dirender di peta atau panorama yang sama dengan anchor (jika tersedia).
Nilai Hasil: Tidak ada
Membuka InfoWindow ini di peta yang ditentukan. Secara opsional, InfoWindow dapat dikaitkan dengan anchor. Di API inti, satu-satunya anchor adalah class Marker. Namun, anchor dapat berupa MVCObject apa pun yang mengekspos properti position LatLng dan secara opsional properti anchorPoint Point 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 dibuka, 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
setHeaderContent
setHeaderContent([headerContent])
Parameter:
Nilai Hasil: Tidak ada
setHeaderDisabled
setHeaderDisabled([headerDisabled])
Parameter:
Nilai Hasil: Tidak ada
setOptions
setOptions([options])
Parameter:
Nilai Hasil: Tidak ada
setPosition
setPosition([position])
Parameter:
  • position: LatLng|LatLngLiteral optional Posisi LatLng tempat InfoWindow ini akan ditampilkan.
Nilai Hasil: Tidak ada
setZIndex
setZIndex(zIndex)
Parameter:
  • zIndex: number Indeks-z untuk InfoWindow ini. InfoWindow dengan indeks z yang lebih besar akan ditampilkan di depan semua InfoWindow lain dengan indeks z yang lebih rendah.
Nilai Hasil: Tidak ada
Diwarisi: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
close
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan setiap kali InfoWindow ditutup. Misalnya, hal ini dapat terjadi karena memanggil metode InfoWindow.close, menekan tombol escape untuk menutup InfoWindow, atau mengklik tombol tutup atau memindahkan InfoWindow ke peta lain.
closeclick
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat tombol tutup diklik.
content_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti konten berubah.
domready
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat <div> yang berisi konten InfoWindow dilampirkan ke DOM. Anda mungkin ingin memantau peristiwa ini jika Anda membuat konten jendela info secara dinamis.
headercontent_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti headerContent berubah.
headerdisabled_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti headerDisabled berubah.
position_changed
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat properti posisi berubah.
visible
function()
Argumen: Tidak ada
Peristiwa ini diaktifkan saat InfoWindow terlihat sepenuhnya. Peristiwa ini tidak diaktifkan saat InfoWindow digeser keluar, 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 yang digunakan untuk menentukan properti yang dapat ditetapkan di InfoWindow.

ariaLabel
opsional
Jenis: string optional
AriaLabel yang akan ditetapkan ke InfoWindow.
content
opsional
Jenis: string|Element|Text optional
Konten yang akan ditampilkan di InfoWindow. Konten ini dapat berupa elemen HTML, string teks biasa, atau string yang berisi HTML. Ukuran InfoWindow akan disesuaikan dengan konten. Untuk menetapkan ukuran eksplisit bagi konten, tetapkan konten sebagai elemen HTML dengan ukuran tersebut.
disableAutoPan
opsional
Jenis: boolean optional
Default: false
Nonaktifkan penggeseran peta agar InfoWindow terlihat sepenuhnya saat dibuka.
headerContent
opsional
Jenis: string|Element|Text optional
Konten yang akan ditampilkan di baris header InfoWindow. Ini dapat berupa elemen HTML, atau string teks biasa. Ukuran InfoWindow akan disesuaikan dengan konten. Untuk menetapkan ukuran eksplisit untuk konten header, tetapkan headerContent menjadi elemen HTML dengan ukuran tersebut.
headerDisabled
opsional
Jenis: boolean optional
Menonaktifkan seluruh baris header di InfoWindow. Jika ditetapkan ke true, header akan dihapus sehingga konten header dan tombol tutup akan disembunyikan.
maxWidth
opsional
Jenis: number optional
Lebar maksimum InfoWindow, terlepas dari 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
opsional
Jenis: number optional
Lebar minimum InfoWindow, terlepas dari lebar konten. Saat menggunakan properti ini, sebaiknya tetapkan minWidth ke nilai yang lebih kecil 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
opsional
Jenis: Size optional
Offset, dalam piksel, dari ujung jendela info dari titik di peta yang koordinat geografisnya menjadi tempat penambatan jendela info. Jika InfoWindow dibuka dengan anchor, pixelOffset akan dihitung dari properti anchorPoint anchor.
position
opsional
Jenis: LatLng|LatLngLiteral optional
LatLng tempat InfoWindow ini akan ditampilkan. Jika InfoWindow dibuka dengan anchor, posisi anchor akan digunakan.
zIndex
opsional
Jenis: number optional
Semua InfoWindow ditampilkan di peta menurut urutan zIndex, dengan nilai yang lebih tinggi akan ditampilkan di depan InfoWindow yang nilainya lebih rendah. Secara default, InfoWindow ditampilkan sesuai dengan garis lintangnya, dengan InfoWindow di garis lintang yang lebih rendah muncul di depan InfoWindow di garis lintang yang lebih tinggi. InfoWindow selalu ditampilkan di depan penanda.

Antarmuka InfoWindowOpenOptions

Antarmuka google.maps.InfoWindowOpenOptions

Opsi untuk membuka InfoWindow

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