Class OverlayView
Class
google.maps.OverlayView
Anda dapat mengimplementasikan class ini jika ingin menampilkan jenis objek overlay kustom di peta.
Warisan dari class ini dengan menetapkan prototipe overlay: MyOverlay.prototype = new google.maps.OverlayView();
. Konstruktor OverlayView
dijamin merupakan fungsi kosong.
Anda harus menerapkan tiga metode: onAdd()
, draw()
, dan onRemove()
.
- Dalam metode
onAdd()
, Anda harus membuat objek DOM dan menambahkannya sebagai turunan panel. - Dalam metode
draw()
, Anda harus memosisikan elemen ini. - Dalam metode
onRemove()
, Anda harus menghapus objek dari DOM.
setMap()
dengan objek Map
yang valid untuk memicu panggilan ke metode onAdd()
dan setMap(null)
guna memicu metode onRemove()
. Metode setMap()
dapat dipanggil pada saat pembuatan atau kapan saja setelahnya saat overlay harus ditampilkan kembali setelah dihapus. Metode draw()
kemudian akan dipanggil setiap kali properti peta berubah yang dapat mengubah posisi elemen, seperti zoom, pusat, atau jenis peta.
Class ini memperluas
MVCObject
.
Akses dengan memanggil const {OverlayView} = await google.maps.importLibrary("maps")
atau const {OverlayView} = await google.maps.importLibrary("streetView")
. Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
OverlayView |
OverlayView() Parameter: Tidak ada
Membuat OverlayView . |
Metode Statis | |
---|---|
preventMapHitsAndGesturesFrom |
preventMapHitsAndGesturesFrom(element) Parameter:
Nilai yang Ditampilkan: Tidak ada
Menghentikan peristiwa klik, ketuk, tarik, dan roda pada elemen agar tidak muncul ke peta. Gunakan ini untuk mencegah penarikan dan zoom peta, serta peristiwa "klik" peta. |
preventMapHitsFrom |
preventMapHitsFrom(element) Parameter:
Nilai yang Ditampilkan: Tidak ada
Menghentikan klik atau ketukan pada elemen agar tidak muncul ke peta. Gunakan ini untuk mencegah peta memicu peristiwa "klik". |
Metode | |
---|---|
draw |
draw() Parameter: Tidak ada
Nilai yang Ditampilkan: Tidak ada
Terapkan metode ini untuk menggambar atau memperbarui overlay. Gunakan posisi dari projection.fromLatLngToDivPixel() untuk memosisikan overlay dengan benar relatif terhadap MapPanes. Metode ini dipanggil setelah onAdd(), dan dipanggil saat perubahan zoom atau pusat. Sebaiknya jangan lakukan pekerjaan yang membutuhkan komputasi yang mahal dalam metode ini. |
getMap |
getMap() Parameter: Tidak ada
Nilai Hasil:
Map|StreetViewPanorama |
getPanes |
getPanes() Parameter: Tidak ada
Nilai Hasil:
MapPanes|null Menampilkan panel tempat OverlayView ini dapat dirender. Panel tidak diinisialisasi hingga onAdd dipanggil oleh API. |
getProjection |
getProjection() Parameter: Tidak ada
Nilai Hasil:
MapCanvasProjection Menampilkan objek MapCanvasProjection yang terkait dengan OverlayView ini. Proyeksi tidak diinisialisasi hingga onAdd dipanggil oleh API. |
onAdd |
onAdd() Parameter: Tidak ada
Nilai yang Ditampilkan: Tidak ada
Terapkan metode ini untuk melakukan inisialisasi elemen DOM overlay. Metode ini dipanggil satu kali setelah setMap() dipanggil dengan peta yang valid. Pada tahap ini, panel dan proyeksi akan diinisialisasi. |
onRemove |
onRemove() Parameter: Tidak ada
Nilai yang Ditampilkan: Tidak ada
Terapkan metode ini untuk menghapus elemen dari DOM. Metode ini dipanggil sekali setelah panggilan ke setMap(null). |
setMap |
setMap(map) Parameter:
Nilai yang Ditampilkan: Tidak ada
Menambahkan overlay ke peta atau panorama. |
Diwariskan:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Antarmuka MapPanes
Antarmuka
google.maps.MapPanes
Properti | |
---|---|
floatPane |
Jenis:
Element Panel ini berisi jendela info. Panel ini berada di atas semua overlay peta. (Panel 4). |
mapPane |
Jenis:
Element Panel ini adalah panel terendah dan berada di atas ubin. Panel ini tidak menerima peristiwa DOM. (Panel 0). |
markerLayer |
Jenis:
Element Panel ini berisi penanda. Panel ini tidak menerima peristiwa DOM. (Panel 2). |
overlayLayer |
Jenis:
Element Panel ini berisi polyline, poligon, overlay bumi, dan overlay lapisan ubin. Panel ini tidak menerima peristiwa DOM. (Panel 1). |
overlayMouseTarget |
Jenis:
Element Panel ini berisi elemen yang menerima peristiwa DOM. (Panel 3). |
Antarmuka MapCanvasProjection
Antarmuka
google.maps.MapCanvasProjection
Objek ini tersedia untuk OverlayView
dari dalam metode gambar. Ini tidak dijamin akan diinisialisasi hingga draw dipanggil.
Metode | |
---|---|
fromContainerPixelToLatLng |
fromContainerPixelToLatLng(pixel[, noClampNoWrap]) Parameter:
Nilai Hasil:
LatLng|null Menghitung koordinat geografis dari koordinat piksel dalam penampung peta. |
fromDivPixelToLatLng |
fromDivPixelToLatLng(pixel[, noClampNoWrap]) Parameter:
Nilai Hasil:
LatLng|null Menghitung koordinat geografis dari koordinat piksel di div yang menyimpan peta yang dapat ditarik. |
fromLatLngToContainerPixel |
fromLatLngToContainerPixel(latLng) Parameter:
Nilai Hasil:
Point|null Menghitung koordinat piksel lokasi geografis tertentu di elemen penampung peta. |
fromLatLngToDivPixel |
fromLatLngToDivPixel(latLng) Parameter:
Nilai Hasil:
Point|null Menghitung koordinat piksel lokasi geografis tertentu di elemen DOM yang menyimpan peta yang dapat ditarik. |
getVisibleRegion |
getVisibleRegion() Parameter: Tidak ada
Nilai Hasil:
VisibleRegion|null Wilayah peta yang terlihat. Menampilkan null jika peta tidak memiliki ukuran. Menampilkan null jika OverlayView berada di StreetViewPanorama. |
getWorldWidth |
getWorldWidth() Parameter: Tidak ada
Nilai Hasil:
number Lebar dunia dalam piksel pada tingkat zoom saat ini. Untuk proyeksi dengan sudut arah 90 atau 270 derajat, ini sesuai dengan rentang piksel di sumbu Y. |