WebGL

Class WebGLOverlayView

Class google.maps.WebGLOverlayView

Tampilan Overlay WebGL menyediakan akses langsung ke konteks untuk proses rendering WebGL yang sama dengan yang digunakan Google Maps Platform untuk merender peta dasar vektor. Penggunaan konteks rendering bersama ini memberikan manfaat seperti oklusi kedalaman dengan geometri bangunan 3D, dan kemampuan untuk menyinkronkan konten 2D/3D dengan rendering peta dasar.

Dengan Tampilan Overlay WebGL, Anda dapat menambahkan konten ke peta Anda secara langsung menggunakan WebGL, atau library Grafis populer seperti Three.js atau deck.gl. Untuk menggunakan overlay, Anda dapat memperluas google.maps.WebGLOverlayView dan menyediakan implementasi untuk setiap hook siklus proses berikut: WebGLOverlayView.onAdd, WebGLOverlayView.onContextRestored, WebGLOverlayView.onDraw, WebGLOverlayView.onContextLost, dan WebGLOverlayView.onRemove.

Anda harus memanggil WebGLOverlayView.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 setelah overlay harus ditampilkan kembali setelah dihapus. Metode onDraw() kemudian akan dipanggil setiap kali properti peta berubah yang dapat mengubah posisi elemen, seperti zoom, tengah, atau jenis peta. WebGLOverlayView hanya dapat ditambahkan ke peta vektor yang memiliki MapOptions.mapId.

Class ini memperluas MVCObject.

Saat menggunakan v=beta, dapat diakses dengan memanggil const {WebGLOverlayView} = await google.map.importLibrary("maps"). Lihat Library di Maps JavaScript API.
WebGLOverlayView
WebGLOverlayView()
Parameter: Tidak ada
Membuat WebGLOverlayView
getMap
getMap()
Parameter: Tidak ada
Nilai Hasil: Map|null|undefined
onAdd
onAdd()
Parameter: Tidak ada
Nilai Hasil: Tidak Ada
Terapkan metode ini untuk mengambil atau membuat struktur data perantara sebelum overlay digambar yang tidak memerlukan akses langsung ke konteks untuk proses rendering WebGL. Metode ini harus diimplementasikan untuk merender.
onContextLost
onContextLost()
Parameter: Tidak ada
Nilai Hasil: Tidak Ada
Metode ini dipanggil saat konteks rendering hilang karena alasan apa pun, dan di sinilah Anda harus membersihkan status GL yang sudah ada, karena tidak diperlukan lagi.
onContextRestored
onContextRestored(options)
Parameter:
Nilai Hasil: Tidak Ada
Metode ini dipanggil setelah konteks rendering tersedia. Gunakan alat ini untuk menginisialisasi atau mengikat status WebGL seperti shader atau objek buffering.
onDraw
onDraw(options)
Parameter:
  • options:  WebGLDrawOptions yang memungkinkan developer merender konten ke peta dasar Google terkait.
Nilai Hasil: Tidak Ada
Terapkan metode ini untuk menggambar konten WebGL langsung di peta. Perhatikan bahwa jika overlay memerlukan frame baru yang digambar, panggil WebGLOverlayView.requestRedraw.
onRemove
onRemove()
Parameter: Tidak ada
Nilai Hasil: Tidak Ada
Metode ini dipanggil saat overlay dihapus dari peta dengan WebGLOverlayView.setMap(null), dan merupakan tempat Anda harus menghapus semua objek perantara. Metode ini harus diimplementasikan untuk merender.
onStateUpdate
onStateUpdate(options)
Parameter:
Nilai Hasil: Tidak Ada
Terapkan metode ini untuk menangani pembaruan status GL di luar frame animasi render.
requestRedraw
requestRedraw()
Parameter: Tidak ada
Nilai Hasil: Tidak Ada
Memicu peta untuk menggambar ulang frame.
requestStateUpdate
requestStateUpdate()
Parameter: Tidak ada
Nilai Hasil: Tidak Ada
Memicu peta untuk memperbarui status GL.
setMap
setMap([map])
Parameter:
  • map:  Map optional Peta untuk mengakses status div, model, dan tampilan.
Nilai Hasil: Tidak Ada
Menambahkan overlay ke peta.
Diwariskan: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Antarmuka WebGLDrawOptions

Antarmuka google.maps.WebGLDrawOptions

Opsi gambar.
gl
WebGLRenderingContext yang digunakan untuk merender WebGLOverlayView ini.
transformer
Transformasi matriks dari ruang kamera ke koordinat lintang/bujur.

Antarmuka WebGLStateOptions

Antarmuka google.maps.WebGLStateOptions

Opsi status GL.
gl
WebGLRenderingContext yang digunakan untuk merender WebGLOverlayView ini.

Antarmuka CoordinateTransformer

Antarmuka google.maps.CoordinateTransformer

Antarmuka ini menyediakan metode praktis untuk menghasilkan matriks yang dapat digunakan untuk merender tampilan WebGL di atas peta dasar Google.

Catatan: Referensi ke objek ini tidak boleh disimpan di luar cakupan panggilan WebGLOverlayView.onDraw yang dienkapsulasi.
fromLatLngAltitude
fromLatLngAltitude(latLngAltitude[, rotations, scale])
Parameter:
  • latLngAltitude:  LatLngAltitude|LatLngAltitudeLiteral Lintang, bujur, dan ketinggian.
  • rotations: Float32Array optional Array yang berisi sudut rotasi Euler dalam derajat, dalam konvensi XYZ.
  • scale:  Array Float32Array optional yang berisi array skalar XYZ untuk diterapkan pada sumbu mata angin.
Nilai Hasil: Matriks MVP Float64Array untuk digunakan dengan WebGL.
getCameraParams
getCameraParams()
Parameter: Tidak ada
Nilai Hasil: Parameter kamera CameraParams

Antarmuka CameraParams

Antarmuka google.maps.CameraParams

Digunakan untuk mengambil parameter kamera, seperti kamera GL yang digunakan untuk WebGLOverlayView.

Antarmuka ini memperluas CameraOptions.

center
Jenis: LatLng
heading
Jenis: number
tilt
Jenis: number
zoom
Jenis: number