3D Maps

Kelas Map3DElement

Class google.maps.maps3d.Map3DElement

Map3DElement adalah antarmuka HTML untuk tampilan Peta 3D. Perhatikan bahwa mode harus ditetapkan agar Peta 3D mulai dirender.

Elemen kustom:
<gmp-map-3d center="lat,lng,altitude" default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number"></gmp-map-3d>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan Map3DElementOptions.

Akses dengan memanggil const {Map3DElement} = await google.maps.importLibrary("maps3d").
Lihat Library di Maps JavaScript API.
Map3DElement
Map3DElement([options])
Parameter: 
bounds
Jika disetel, membatasi posisi kamera dalam batas lat/lng yang ditentukan. Perhatikan bahwa objek di luar batas masih dirender. Batas dapat membatasi bujur dan lintang, atau hanya dapat membatasi lintang atau bujur. Untuk batas hanya latitude, gunakan bujur barat dan timur -180 dan 180. Untuk batas hanya longitude, gunakan latitude utara dan selatan 90 dan -90.
center
Pusat peta diberikan sebagai LatLngAltitude, dengan ketinggian dalam meter di atas permukaan tanah. Perhatikan bahwa lokasi ini tidak selalu merupakan lokasi kamera, karena kolom range memengaruhi jarak kamera dari pusat peta. Jika tidak disetel, setelan defaultnya adalah {lat: 0, lng: 0, altitude: 63170000}. 63170000 meter adalah ketinggian maksimum yang diizinkan (radius Bumi dikalikan 10).
Atribut HTML:
  • <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultUIDisabled
Jenis:  boolean optional
Default: false
Jika true, semua tombol UI default akan dinonaktifkan. Tidak menonaktifkan kontrol keyboard dan gestur.
Atribut HTML:
  • <gmp-map-3d default-ui-disabled></gmp-map-3d>
heading
Jenis:  number optional
Arah kompas peta, dalam derajat, dengan utara adalah nol. Jika tidak ada kemiringan, setiap putaran akan ditafsirkan sebagai arah.
Atribut HTML:
  • <gmp-map-3d heading="number"></gmp-map-3d>
maxAltitude
Jenis:  number optional
Ketinggian maksimum di atas permukaan tanah yang akan ditampilkan di peta. Nilai yang valid adalah antara 0 dan 63170000 meter (jari-jari Bumi dikalikan dengan 10).
Atribut HTML:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
Jenis:  number optional
Sudut arah (rotasi) maksimum peta. Nilai yang valid adalah antara 0 dan 360 derajat. minHeading dan maxHeading menunjukkan interval <= 360 derajat yang memungkinkan gestur arah. minHeading = 180 dan maxHeading = 90 akan memungkinkan penentuan arah di [0, 90] dan penentuan arah di [180, 360]. minHeading = 90 dan maxHeading = 180 akan mengizinkan heading di [90, 180].
Atribut HTML:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
Jenis:  number optional
Sudut datang maksimum peta. Nilai yang valid adalah antara 0 dan 90 derajat.
Atribut HTML:
  • <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude
Jenis:  number optional
Ketinggian minimum di atas permukaan tanah yang akan ditampilkan di peta. Nilai yang valid adalah antara 0 dan 63170000 meter (jari-jari Bumi dikalikan dengan 10).
Atribut HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
Jenis:  number optional
Sudut arah (rotasi) minimum peta. Nilai yang valid adalah antara 0 dan 360 derajat. minHeading dan maxHeading menunjukkan interval <= 360 derajat yang memungkinkan gestur arah. minHeading = 180 dan maxHeading = 90 akan memungkinkan penentuan arah di [0, 90] dan penentuan arah di [180, 360]. minHeading = 90 dan maxHeading = 180 akan mengizinkan heading di [90, 180].
Atribut HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
Jenis:  number optional
Sudut datang minimum peta. Nilai yang valid adalah antara 0 dan 90 derajat.
Atribut HTML:
  • <gmp-map-3d min-tilt="number"></gmp-map-3d>
mode
Jenis:  MapMode optional
Menentukan mode peta harus dirender. Jika tidak disetel, peta tidak akan dirender.
Atribut HTML:
  • <gmp-map-3d mode="hybrid"></gmp-map-3d>
  • <gmp-map-3d mode="satellite"></gmp-map-3d>
range
Jenis:  number optional
Jarak dari kamera ke pusat peta, dalam meter.
Atribut HTML:
  • <gmp-map-3d range="number"></gmp-map-3d>
roll
Jenis:  number optional
Putaran kamera di sekitar vektor tampilan dalam derajat. Untuk mengatasi ambiguitas, jika tidak ada kemiringan, setiap putaran akan ditafsirkan sebagai arah.
Atribut HTML:
  • <gmp-map-3d roll="number"></gmp-map-3d>
tilt
Jenis:  number optional
Kemiringan vektor tampilan kamera dalam derajat. Vektor tampilan yang melihat langsung ke bawah bumi akan memiliki kemiringan nol derajat. Vektor tampilan yang mengarah menjauhi bumi akan memiliki kemiringan 180 derajat.
Atribut HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • type:  string String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listener:  EventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent
  • options:  boolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener.
flyCameraAround
flyCameraAround(options)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Metode ini mengorbitkan kamera di sekitar lokasi tertentu selama durasi tertentu, sehingga membuat jumlah putaran tertentu dalam waktu tersebut.

Secara default, kamera berputar searah jarum jam. Jika diberi angka negatif untuk putaran, kamera akan berputar berlawanan arah jarum jam.

Metode ini bersifat asinkron karena animasi hanya dapat dimulai setelah peta dimuat dalam jumlah minimum. Metode ini akan ditampilkan setelah animasi dimulai.

Jika jumlah putaran adalah nol, tidak ada putaran yang akan terjadi, dan animasi akan selesai segera setelah dimulai.
flyCameraTo
flyCameraTo(options)
Parameter: 
Nilai yang Ditampilkan:  Tidak Ada
Metode ini menggerakkan kamera secara parabola dari lokasi saat ini ke lokasi akhir tertentu selama durasi tertentu.

Metode ini bersifat asinkron karena animasi hanya dapat dimulai setelah peta dimuat dalam jumlah minimum. Metode ini akan ditampilkan setelah animasi dimulai.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • type:  string String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listener:  EventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • options:  boolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.
stopCameraAnimation
stopCameraAnimation()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Tidak Ada
Metode ini menghentikan animasi terbang yang mungkin sedang berjalan. Kamera tetap berada di tengah animasi; kamera tidak berpindah ke titik akhir.

Metode ini bersifat asinkron karena animasi hanya dapat dimulai atau dihentikan setelah peta dimuat dalam jumlah minimum. Metode ini akan ditampilkan setelah animasi berhenti.
gmp-animationend
function(animationEndEvent)
Argumen: 
  • animationEndEvent:  Event
Peristiwa ini dipicu saat animasi terbang berakhir. Peristiwa ini muncul melalui hierarki DOM.
gmp-centerchange
function(centerChangeEvent)
Argumen: 
  • centerChangeEvent:  Event
Peristiwa ini dipicu saat properti tengah Map3DElement berubah.
gmp-click
function(clickEvent)
Argumen: 
Peristiwa ini diaktifkan saat elemen Map3DElement diklik.
gmp-headingchange
function(headingChangeEvent)
Argumen: 
  • headingChangeEvent:  Event
Peristiwa ini dipicu saat properti heading Map3DElement berubah.
gmp-rangechange
function(rangeChangeEvent)
Argumen: 
  • rangeChangeEvent:  Event
Peristiwa ini dipicu saat properti rentang Map3DElement berubah.
gmp-rollchange
function(rollChangeEvent)
Argumen: 
  • rollChangeEvent:  Event
Peristiwa ini diaktifkan saat properti roll Map3DElement berubah.
gmp-steadychange
function(steadyChangeEvent)
Argumen: 
Peristiwa ini dipicu saat status stabil Map3DElement berubah.
gmp-tiltchange
function(tiltChangeEvent)
Argumen: 
  • tiltChangeEvent:  Event
Peristiwa ini diaktifkan saat properti kemiringan Map3DElement berubah.

Antarmuka