3D Maps

Kelas Map3DElement

Class google.maps.maps3d.Map3DElement

Map3DElement adalah antarmuka HTML untuk tampilan Peta 3D.

Elemen kustom:
<gmp-map-3d center="lat,lng,altitude" default-labels-disabled default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" 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>
defaultLabelsDisabled
Jenis:  boolean optional
Default: false
Saat true, label peta default tidak dirender.
Atribut HTML:
  • <gmp-map-3d default-labels-disabled></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>
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 Map3DElementOptions

google.maps.maps3d.Map3DElementOptions interface

Objek Map3DElementOptions yang digunakan untuk menentukan properti yang dapat ditetapkan di Map3DElement.
bounds optional
Lihat Map3DElement.bounds.
center optional
Lihat Map3DElement.center.
defaultLabelsDisabled optional
Jenis:  boolean optional
Lihat Map3DElement.defaultLabelsDisabled.
defaultUIDisabled optional
Jenis:  boolean optional
Lihat Map3DElement.defaultUIDisabled.
heading optional
Jenis:  number optional
Lihat Map3DElement.heading.
maxAltitude optional
Jenis:  number optional
Lihat Map3DElement.maxAltitude.
maxHeading optional
Jenis:  number optional
Lihat Map3DElement.maxHeading.
maxTilt optional
Jenis:  number optional
Lihat Map3DElement.maxTilt.
minAltitude optional
Jenis:  number optional
Lihat Map3DElement.minAltitude.
minHeading optional
Jenis:  number optional
Lihat Map3DElement.minHeading.
minTilt optional
Jenis:  number optional
Lihat Map3DElement.minTilt.
range optional
Jenis:  number optional
Lihat Map3DElement.range.
roll optional
Jenis:  number optional
Lihat Map3DElement.roll.
tilt optional
Jenis:  number optional
Lihat Map3DElement.tilt.

FlyAroundAnimationOptions interface

google.maps.maps3d.FlyAroundAnimationOptions interface

Opsi penyesuaian untuk Animasi FlyCameraAround.
camera
Jenis:  CameraOptions
Titik pusat yang harus dilihat kamera selama animasi orbit. Perhatikan bahwa arah peta akan berubah saat kamera mengorbit di sekitar titik tengah ini.
durationMillis optional
Jenis:  number optional
Durasi animasi dalam milidetik. Ini adalah total durasi animasi, bukan durasi satu rotasi.
rounds optional
Jenis:  number optional
Jumlah putaran untuk berputar di sekitar pusat dalam durasi yang ditentukan. Setelan ini mengontrol kecepatan rotasi secara keseluruhan. Meneruskan angka negatif ke putaran akan menyebabkan kamera berputar berlawanan arah jarum jam, bukan searah jarum jam seperti default.

FlyToAnimationOptions interface

google.maps.maps3d.FlyToAnimationOptions interface

Opsi penyesuaian untuk Animasi FlyCameraTo.
endCamera
Jenis:  CameraOptions
Lokasi tempat kamera harus mengarah di akhir animasi.
durationMillis optional
Jenis:  number optional
Durasi animasi dalam milidetik. Durasi 0 akan memindahkan kamera langsung ke posisi akhir.

Antarmuka CameraOptions

google.maps.maps3d.CameraOptions interface

Objek CameraOptions yang digunakan untuk menentukan properti yang dapat ditetapkan pada objek kamera. Objek kamera dapat berupa apa pun yang memiliki posisi kamera, misalnya status peta saat ini, atau status animasi yang diminta di masa mendatang.
center optional
Lihat Map3DElement.center.
heading optional
Jenis:  number optional
Lihat Map3DElement.heading.
range optional
Jenis:  number optional
Lihat Map3DElement.range.
roll optional
Jenis:  number optional
Lihat Map3DElement.roll.
tilt optional
Jenis:  number optional
Lihat Map3DElement.tilt.

SteadyChangeEvent class

Class google.maps.maps3d.SteadyChangeEvent

Peristiwa ini dibuat dari pemantauan kondisi stabil Map3DElement. Peristiwa ini muncul melalui hierarki DOM.

Class ini memperluas Event.

Akses dengan memanggil const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d").
Lihat Library di Maps JavaScript API.
isSteady
Jenis:  boolean
Menunjukkan apakah Map3DElement stabil (yaitu semua rendering untuk adegan saat ini telah selesai) atau tidak.

LocationClickEvent class

Class google.maps.maps3d.LocationClickEvent

Acara ini dibuat dari mengklik Map3DElement.

Class ini memperluas Event.

Akses dengan memanggil const {LocationClickEvent} = await google.maps.importLibrary("maps3d").
Lihat Library di Maps JavaScript API.
position
Jenis:  LatLngAltitude optional
Lintang/bujur/ketinggian yang berada di bawah kursor saat peristiwa terjadi. Perhatikan bahwa pada tingkat yang lebih kasar, data yang kurang akurat akan ditampilkan. Selain itu, elevasi dasar laut dapat ditampilkan untuk nilai ketinggian saat mengklik permukaan air dari posisi kamera yang lebih tinggi. Peristiwa ini muncul melalui hierarki DOM.

Class PlaceClickEvent

Class google.maps.maps3d.PlaceClickEvent

Acara ini dibuat dari mengklik Map3DElement.

Class ini memperluas LocationClickEvent.

Akses dengan memanggil const {PlaceClickEvent} = await google.maps.importLibrary("maps3d").
Lihat Library di Maps JavaScript API.
placeId
Jenis:  string
ID tempat fitur peta.
Diwarisi: position
fetchPlace
fetchPlace()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Promise<Place>
Mengambil Place untuk ID tempat ini. Dalam objek Place yang dihasilkan, properti id akan diisi. Kolom tambahan dapat diminta selanjutnya melalui Place.fetchFields() dengan tunduk pada pengaktifan dan penagihan Places API normal. Promise ditolak jika terjadi error saat mengambil Place.

Kelas Marker3DElement

Class google.maps.maps3d.Marker3DElement

Menampilkan posisi di peta 3D. Perhatikan bahwa position harus ditetapkan agar Marker3DElement ditampilkan.

Elemen kustom:
<gmp-marker-3d altitude-mode="absolute" collision-behavior="required" draws-when-occluded extruded label="string" size-preserved z-index="number"></gmp-marker-3d>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan Marker3DElementOptions.

Akses dengan memanggil const {Marker3DElement} = await google.maps.importLibrary("maps3d").
Lihat Library di Maps JavaScript API.
Marker3DElement
Marker3DElement([options])
Parameter: 
Membuat Marker3DElement dengan opsi yang ditentukan.
altitudeMode
Jenis:  AltitudeMode optional
Default: AltitudeMode.CLAMP_TO_GROUND
Menentukan cara komponen ketinggian posisi diinterpretasikan.
Atribut HTML:
  • <gmp-marker-3d altitude-mode="absolute"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="clamp-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-ground"></gmp-marker-3d>
  • <gmp-marker-3d altitude-mode="relative-to-mesh"></gmp-marker-3d>
collisionBehavior
Jenis:  CollisionBehavior optional
Default: CollisionBehavior.REQUIRED
Enumerasi yang menentukan perilaku Marker3DElement saat bertabrakan dengan Marker3DElement lain atau dengan label peta dasar.
Atribut HTML:
  • <gmp-marker-3d collision-behavior="required"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="required-and-hides-optional"></gmp-marker-3d>
  • <gmp-marker-3d collision-behavior="optional-and-hides-lower-priority"></gmp-marker-3d>
drawsWhenOccluded
Jenis:  boolean optional
Default: false
Menentukan apakah penanda ini harus digambar atau tidak saat tertutup. Penanda dapat tertutup oleh geometri peta (misalnya, bangunan).
Atribut HTML:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
Jenis:  boolean optional
Default: false
Menentukan apakah penanda akan dihubungkan ke tanah. Untuk mengekstrusi penanda, altitudeMode harus berupa RELATIVE_TO_GROUND atau ABSOLUTE.
Atribut HTML:
  • <gmp-marker-3d extruded></gmp-marker-3d>
label
Jenis:  string optional
Teks yang akan ditampilkan oleh penanda ini.
Atribut HTML:
  • <gmp-marker-3d label="string"></gmp-marker-3d>
position
Jenis:  LatLngLiteral|