DOM elements

OverlayView

Class google.maps.OverlayView

Anda dapat mengimplementasikan class ini jika ingin menampilkan jenis kustom objek overlay pada peta.

Warisi dari class ini dengan menyetel prototipe overlay Anda: MyOverlay.prototype = new google.maps.OverlayView();. Konstruktor OverlayView dijamin akan berupa fungsi kosong.

Anda harus mengimplementasikan 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-elemen ini.
  • Dalam metode onRemove(), Anda harus menghapus objek dari DOM.
Anda harus memanggil setMap() dengan objek Map yang valid untuk memicu panggilan ke metode onAdd() dan setMap(null) agar dapat 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.
OverlayView
OverlayView()
Parameter: Tidak ada
Membuat OverlayView
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
Parameter: 
Nilai Hasil: Tidak ada
Menghentikan peristiwa klik, ketuk, tarik, dan putar pada elemen agar tidak menggelembung ke peta. Gunakan metode ini untuk mencegah penarikan dan zoom peta, serta peristiwa "klik" peta.
preventMapHitsFrom
preventMapHitsFrom(element)
Parameter: 
Nilai Hasil: Tidak ada
Menghentikan klik atau ketuk pada elemen agar tidak menggelembung ke peta. Gunakan opsi ini agar peta tidak memicu peristiwa "klik".
draw
draw()
Parameter: Tidak ada
Nilai Hasil: Tidak ada
Implementasikan metode ini untuk menggambar atau memperbarui overlay. Gunakan posisi dari projection.fromLatLngToDivPixel() untuk memosisikan overlay dengan benar relatif terhadap MapPane. Metode ini dipanggil setelah onAdd(), dan dipanggil pada perubahan zoom atau pusat. Tidak disarankan untuk melakukan pekerjaan yang secara komputasi 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 Hasil: Tidak ada
Implementasikan metode ini untuk melakukan inisialisasi elemen DOM overlay. Metode ini dipanggil sekali setelah setMap() dipanggil dengan peta yang valid. Pada tahap ini, panel dan proyeksi akan diinisialisasi.
onRemove
onRemove()
Parameter: Tidak ada
Nilai Hasil: Tidak ada
Implementasikan metode ini untuk menghapus elemen Anda dari DOM. Metode ini dipanggil setelah panggilan ke setMap(null).
setMap
setMap(map)
Parameter: 
Nilai Hasil: Tidak ada
Menambahkan overlay ke peta atau panorama.
Diwariskan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Antarmuka MapPanes

Antarmuka google.maps.MapPanes

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 disediakan untuk OverlayView dari dalam metode gambar. Kode ini tidak dijamin akan diinisialisasi hingga gambar dipanggil.
fromContainerPixelToLatLng
fromContainerPixelToLatLng(pixel[, noClampNoWrap])
Parameter: 
  • pixel:  Point optional
  • noClampNoWrap:  boolean optional
Nilai Hasil:  LatLng|null
Menghitung koordinat geografis dari koordinat piksel dalam penampung peta.
fromDivPixelToLatLng
fromDivPixelToLatLng(pixel[, noClampNoWrap])
Parameter: 
  • pixel:  Point optional
  • noClampNoWrap:  boolean optional
Nilai Hasil:  LatLng|null
Menghitung koordinat geografis dari koordinat piksel dalam div yang menyimpan peta yang dapat ditarik.
fromLatLngToContainerPixel
fromLatLngToContainerPixel(latLng)
Parameter: 
Nilai Hasil:  Point|null
Menghitung koordinat piksel lokasi geografis yang diberikan dalam elemen penampung peta.
fromLatLngToDivPixel
fromLatLngToDivPixel(latLng)
Parameter: 
Nilai Hasil:  Point|null
Menghitung koordinat piksel dari lokasi geografis yang diberikan dalam 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 pada sumbu Y.