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 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, posisi kamera akan dibatasi dalam batas lat/lng yang ditentukan. Perhatikan bahwa objek yang berada di luar batas tetap dirender. Batas dapat membatasi bujur dan lintang, atau dapat membatasi hanya lintang atau bujur. Untuk batas hanya lintang, masing-masing menggunakan bujur barat dan timur -180 dan 180. Untuk batas hanya bujur, masing-masing menggunakan lintang utara dan selatan 90 dan -90.
center
Bagian tengah peta yang diberikan sebagai LatLngAltitude, dengan ketinggian dalam meter di atas permukaan tanah. Perhatikan bahwa lokasi ini belum tentu 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
Jika true, label peta default tidak dirender.
Atribut HTML:
  • <gmp-map-3d default-labels-disabled></gmp-map-3d>
heading
Jenis:  number optional
Judul kompas pada peta, dalam derajat, dengan arah utara adalah nol. Jika tidak ada kemiringan, setiap lemparan akan ditafsirkan sebagai arah.
Atribut HTML:
  • <gmp-map-3d heading="number"></gmp-map-3d>
maxAltitude
Jenis:  number optional
Ketinggian maksimum di atas tanah yang akan ditampilkan di peta. Nilai yang valid adalah antara 0 dan 63170000 meter (radius Bumi dikalikan dengan 10).
Atribut HTML:
  • <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading
Jenis:  number optional
Sudut arah maksimum (rotasi) peta. Nilai yang valid adalah antara 0 dan 360 derajat. minHeading dan maxHeading mewakili interval <= 360 derajat yang mengizinkan gestur arah. minHeading = 180 dan maxHeading = 90 akan mengizinkan judul dalam [0, 90] dan heading dalam [180, 360]. minHeading = 90 dan maxHeading = 180 akan mengizinkan judul dalam [90, 180].
Atribut HTML:
  • <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt
Jenis:  number optional
Sudut insiden 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 tanah yang akan ditampilkan di peta. Nilai yang valid adalah antara 0 dan 63170000 meter (radius Bumi dikalikan dengan 10).
Atribut HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
Jenis:  number optional
Sudut arah minimum (rotasi) peta. Nilai yang valid adalah antara 0 dan 360 derajat. minHeading dan maxHeading mewakili interval <= 360 derajat yang mengizinkan gestur arah. minHeading = 180 dan maxHeading = 90 akan mengizinkan judul dalam [0, 90] dan heading dalam [180, 360]. minHeading = 90 dan maxHeading = 180 akan mengizinkan judul dalam [90, 180].
Atribut HTML:
  • <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt
Jenis:  number optional
Sudut insiden 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
Gulungan kamera di sekeliling vektor tampilan dalam derajat. Untuk mengatasi ambiguitas, jika tidak ada kemiringan, setiap lemparan 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 menghadap langsung ke bawah bumi akan memiliki kemiringan nol derajat. Vektor tampilan yang menunjuk menjauh dari bumi akan memiliki kemiringan 180 derajat.
Atribut HTML:
  • <gmp-map-3d tilt="number"></gmp-map-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String yang peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Objek ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai Hasil:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi
Nilai Hasil:  void
Menghapus pemroses peristiwa yang sebelumnya terdaftar dengan addEventListener dari target. Lihat removeEventListener
gmp-centerchange
function(centerChangeEvent)
Argumen: 
Peristiwa ini diaktifkan saat properti pusat Map3DElement berubah.
gmp-click
function(clickEvent)
Argumen: 
Peristiwa ini diaktifkan saat elemen Map3DElement diklik.
gmp-headingchange
function(headingChangeEvent)
Argumen: 
Peristiwa ini diaktifkan saat properti judul Map3DElement berubah.
gmp-rangechange
function(rangeChangeEvent)
Argumen: 
Peristiwa ini diaktifkan saat properti rentang Map3DElement berubah.
gmp-rollchange
function(rollChangeEvent)
Argumen: 
Peristiwa ini diaktifkan saat properti roll Map3DElement berubah.
gmp-steadychange
function(steadyChangeEvent)
Argumen: 
Peristiwa ini diaktifkan saat status stabil Map3DElement berubah.
gmp-tiltchange
function(tiltChangeEvent)
Argumen: 
Peristiwa ini diaktifkan saat properti kemiringan Map3DElement berubah.

Antarmuka Map3DElementOptions

Antarmuka google.maps.maps3d.Map3DElementOptions

Objek Map3DElementOptions yang digunakan untuk menentukan properti yang dapat diatur pada Map3DElement.

bounds optional
center optional
defaultLabelsDisabled optional
Jenis:  boolean optional
heading optional
Jenis:  number optional
maxAltitude optional
Jenis:  number optional
maxHeading optional
Jenis:  number optional
maxTilt optional
Jenis:  number optional
minAltitude optional
Jenis:  number optional
minHeading optional
Jenis:  number optional
minTilt optional
Jenis:  number optional
range optional
Jenis:  number optional
roll optional
Jenis:  number optional
tilt optional
Jenis:  number optional

SteadyChangeEvent

Class google.maps.maps3d.SteadyChangeEvent

Peristiwa ini dibuat dari pemantauan status stabil Map3DElement.

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 suasana saat ini telah selesai) atau tidak.

ClickEvent

Class google.maps.maps3d.ClickEvent

Peristiwa ini dibuat dengan mengklik Map3DElement.

Class ini memperluas Event.

Akses dengan memanggil const {ClickEvent} = 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. Harap dicatat, bahwa pada tingkat yang umum, data yang kurang akurat akan ditampilkan. Selain itu, ketinggian dasar laut dapat ditampilkan untuk nilai ketinggian saat mengklik permukaan air dari posisi kamera yang lebih tinggi.

CenterChangeEvent

Class google.maps.maps3d.CenterChangeEvent

Peristiwa ini dibuat dari perubahan pusat pemantauan pada Map3DElement.

Class ini memperluas Event.

Akses dengan memanggil const {CenterChangeEvent} = await google.maps.importLibrary("maps3d"). Lihat Library di Maps JavaScript API.

HeadingChangeEvent

Class google.maps.maps3d.HeadingChangeEvent

Peristiwa ini dibuat dari pemantauan perubahan judul pada Map3DElement.

Class ini memperluas Event.

Akses dengan memanggil const {HeadingChangeEvent} = await google.maps.importLibrary("maps3d"). Lihat Library di Maps JavaScript API.

Class RangeChangeEvent

Class google.maps.maps3d.RangeChangeEvent

Peristiwa ini dibuat dari pemantauan perubahan rentang pada Map3DElement.

Class ini memperluas Event.

Akses dengan memanggil const {RangeChangeEvent} = await google.maps.importLibrary("maps3d"). Lihat Library di Maps JavaScript API.

RollChangeEvent

Class google.maps.maps3d.RollChangeEvent

Peristiwa ini dibuat dari pemantauan perubahan lemparan di Map3DElement.

Class ini memperluas Event.

Akses dengan memanggil const {RollChangeEvent} = await google.maps.importLibrary("maps3d"). Lihat Library di Maps JavaScript API.

Class TiltChangeEvent

Class google.maps.maps3d.TiltChangeEvent

Peristiwa ini dibuat dari pemantauan perubahan kemiringan di Map3DElement.

Class ini memperluas Event.

Akses dengan memanggil const {TiltChangeEvent} = await google.maps.importLibrary("maps3d"). Lihat Library di Maps JavaScript API.

Class Polyline3DElement

Class google.maps.maps3d.Polyline3DElement

Polyline 3D adalah overlay linear segmen garis yang terhubung pada peta 3D.

Elemen kustom:
<gmp-polyline-3d altitude-mode="absolute" draws-occluded-segments extruded geodesic outer-color="string" outer-opacity="number" outer-width="number" stroke-color="string" stroke-opacity="number" stroke-width="number" z-index="number"></gmp-polyline-3d>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan Polyline3DElementOptions.

Akses dengan memanggil const {Polyline3DElement} = await google.maps.importLibrary("maps3d"). Lihat Library di Maps JavaScript API.

Polyline3DElement
Polyline3DElement([options])
Parameter: 
altitudeMode
Jenis:  AltitudeMode optional
Menetapkan cara komponen ketinggian dalam koordinat ditafsirkan.
Atribut HTML:
  • <gmp-polyline-3d altitude-mode="absolute"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="clamp-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-ground"></gmp-polyline-3d>
  • <gmp-polyline-3d altitude-mode="relative-to-mesh"></gmp-polyline-3d>
coordinates
Urutan urutan koordinat Polyline. Ketinggian diabaikan dalam mode tertentu sehingga bersifat opsional.
drawsOccludedSegments
Jenis:  boolean optional
Default: false
Menentukan apakah bagian polyline yang dapat terhalang telah digambar atau tidak. Polyline dapat terhalang oleh geometri peta (misalnya, bangunan).
Atribut HTML:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
Jenis:  boolean optional
Default: false
Menentukan apakah akan menghubungkan polyline ke tanah. Untuk memunculkan polyline, altitudeMode harus RELATIVE_TO_GROUND atau ABSOLUTE.
Atribut HTML:
  • <gmp-polyline-3d extruded></gmp-polyline-3d>
geodesic
Jenis:  boolean optional
Default: false
Jika true, tepi polyline akan ditafsirkan sebagai geodesi dan akan mengikuti kelengkungan Bumi. Jika false, tepi polyline dirender sebagai garis lurus di ruang layar.
Atribut HTML:
  • <gmp-polyline-3d geodesic></gmp-polyline-3d>
outerColor
Jenis:  string optional
Warna luar. Semua warna CSS3 didukung, kecuali tambahan warna yang dinamai.
Atribut HTML:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerOpacity
Jenis:  number optional
Opasitas luar antara 0.0 dan 1.0.
Atribut HTML:
  • <gmp-polyline-3d outer-opacity="number"></gmp-polyline-3d>
outerWidth
Jenis:  number optional
Lebar luar adalah antara 0.0 dan 1.0. Ini adalah persentase dari strokeWidth.
Atribut HTML:
  • <gmp-polyline-3d outer-width="number"></gmp-polyline-3d>
strokeColor
Jenis:  string optional
Warna garis luar. Semua warna CSS3 didukung, kecuali tambahan warna yang dinamai.
Atribut HTML:
  • <gmp-polyline-3d stroke-color="string"></gmp-polyline-3d>
strokeOpacity
Jenis:  number optional
Opasitas goresan antara 0.0 dan 1.0.
Atribut HTML:
  • <gmp-polyline-3d stroke-opacity="number"></gmp-polyline-3d>
strokeWidth
Jenis:  number optional
Lebar garis luar dalam piksel.
Atribut HTML:
  • <gmp-polyline-3d stroke-width="number"></gmp-polyline-3d>
zIndex
Jenis:  number optional
zIndex dibandingkan dengan poli lainnya.
Atribut HTML:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String yang peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Objek ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai Hasil:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi
Nilai Hasil:  void
Menghapus pemroses peristiwa yang sebelumnya terdaftar dengan addEventListener dari target. Lihat removeEventListener

Antarmuka Polyline3DElementOptions

Antarmuka google.maps.maps3d.Polyline3DElementOptions

Objek Polyline3DElementOptions yang digunakan untuk menetapkan properti yang dapat ditetapkan pada Polyline3DElement.

altitudeMode optional
Jenis:  AltitudeMode optional
coordinates optional
drawsOccludedSegments optional
Jenis:  boolean optional
Default: false
extruded optional
Jenis:  boolean optional
Default: false
geodesic optional
Jenis:  boolean optional
Default: false
outerColor optional
Jenis:  string optional
outerOpacity optional
Jenis:  number optional
outerWidth optional
Jenis:  number optional
strokeColor optional
Jenis:  string optional
strokeOpacity optional
Jenis:  number optional
strokeWidth optional
Jenis:  number optional
zIndex optional
Jenis:  number optional

Class Polygon3DElement

Class google.maps.maps3d.Polygon3DElement

Poligon 3D (seperti polyline 3D) mendefinisikan serangkaian koordinat yang terhubung secara berurutan. Selain itu, poligon membentuk loop tertutup dan menentukan area bidang.

Elemen kustom:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" fill-opacity="number" geodesic stroke-color="string" stroke-opacity="number" stroke-width="number" z-index="number"></gmp-polygon-3d>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan Polygon3DElementOptions.

Akses dengan memanggil const {Polygon3DElement} = await google.maps.importLibrary("maps3d"). Lihat Library di Maps JavaScript API.

Polygon3DElement
Polygon3DElement([options])
Parameter: 
altitudeMode
Jenis:  AltitudeMode optional
Menetapkan cara komponen ketinggian dalam koordinat ditafsirkan.
Atribut HTML:
  • <gmp-polygon-3d altitude-mode="absolute"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="clamp-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-ground"></gmp-polygon-3d>
  • <gmp-polygon-3d altitude-mode="relative-to-mesh"></gmp-polygon-3d>
drawsOccludedSegments
Jenis:  boolean optional
Default: false
Menentukan apakah bagian poligon yang dapat terhalang telah digambar atau tidak. Poligon dapat terhalang oleh geometri peta (misalnya, bangunan).
Atribut HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
Jenis:  boolean optional
Default: false
Menentukan apakah akan menghubungkan poligon ke tanah. Untuk memunculkan poligon, altitudeMode harus RELATIVE_TO_GROUND atau ABSOLUTE.
Atribut HTML:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
Jenis:  string optional
Warna pengisi. Semua warna CSS3 didukung, kecuali tambahan warna yang dinamai.
Atribut HTML:
  • <gmp-polygon-3d fill-color="string"></gmp-polygon-3d>
fillOpacity
Jenis:  number optional
Opasitas isian antara 0,0 dan 1,0.
Atribut HTML:
  • <gmp-polygon-3d fill-opacity="number"></gmp-polygon-3d>
geodesic
Jenis:  boolean optional
Default: false
Jika true, tepi poligon akan ditafsirkan sebagai geodesi dan akan mengikuti kelengkungan Bumi. Jika false, tepi poligon dirender sebagai garis lurus di ruang layar.
Atribut HTML:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerCoordinates
Urutan urutan koordinat yang menunjukkan sebuah loop tertutup. Tidak seperti polyline, poligon dapat terdiri dari satu atau beberapa jalur, yang membuat beberapa potongan di dalam poligon.
outerCoordinates
Urutan urutan koordinat yang menunjukkan sebuah loop tertutup. Ketinggian diabaikan dalam mode tertentu sehingga bersifat opsional.
strokeColor
Jenis:  string optional
Warna garis luar. Semua warna CSS3 didukung, kecuali tambahan warna yang dinamai.
Atribut HTML:
  • <gmp-polygon-3d stroke-color="string"></gmp-polygon-3d>
strokeOpacity
Jenis:  number optional
Opasitas goresan antara 0.0 dan 1.0.
Atribut HTML:
  • <gmp-polygon-3d stroke-opacity="number"></gmp-polygon-3d>
strokeWidth
Jenis:  number optional
Lebar garis luar dalam piksel.
Atribut HTML:
  • <gmp-polygon-3d stroke-width="number"></gmp-polygon-3d>
zIndex
Jenis:  number optional
zIndex dibandingkan dengan poli lainnya.
Atribut HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String yang peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. Objek ini harus berupa fungsi atau objek dengan metode handleEvent
  • optionsboolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive.
Nilai Hasil:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi
Nilai Hasil:  void
Menghapus pemroses peristiwa yang sebelumnya terdaftar dengan addEventListener dari target. Lihat removeEventListener

Antarmuka Polygon3DElementOptions

Antarmuka google.maps.maps3d.Polygon3DElementOptions

Objek Polygon3DElementOptions yang digunakan untuk menentukan properti yang dapat disetel pada Polygon3DElement.

altitudeMode optional
Jenis:  AltitudeMode optional
drawsOccludedSegments optional
Jenis:  boolean optional
Default: false
extruded optional
Jenis:  boolean optional
Default: false
fillColor optional
Jenis:  string optional
fillOpacity optional
Jenis:  number optional
geodesic optional
Jenis:  boolean optional
Default: false
innerCoordinates optional
outerCoordinates optional
strokeColor optional
Jenis:  string optional
strokeOpacity optional
Jenis:  number optional
strokeWidth optional
Jenis:  number optional
zIndex optional
Jenis:  number optional

Konstanta AltitudeMode

google.maps.maps3d.AltitudeMode konstanta

Menetapkan cara komponen ketinggian dalam koordinat ditafsirkan.

Akses dengan memanggil const {AltitudeMode} = await google.maps.importLibrary("maps3d"). Lihat Library di Maps JavaScript API.

ABSOLUTE Memungkinkan untuk mengekspresikan objek yang relatif terhadap rata-rata permukaan laut. Itu juga berarti bahwa jika detail tingkat medan berubah di bawah objek, posisi absolutnya akan tetap sama.
CLAMP_TO_GROUND Mengizinkan untuk mengekspresikan objek yang diletakkan di permukaan tanah. Keduanya akan tetap berada di permukaan tanah mengikuti medan terlepas dari ketinggian yang diberikan. Jika objek diposisikan di atas perairan utama, objek akan ditempatkan di permukaan laut.
RELATIVE_TO_GROUND Memungkinkan untuk mengekspresikan objek yang relatif terhadap permukaan tanah. Jika detail tingkat medan berubah, posisi objek akan tetap konstan terhadap tanah. Jika di atas air, ketinggian akan ditafsirkan sebagai nilai dalam meter di atas permukaan laut.
RELATIVE_TO_MESH Memungkinkan untuk mengekspresikan objek yang relatif terhadap permukaan tanah+bangunan+air tertinggi. Jika di atas air, permukaannya adalah permukaan air; jika di atas medan, permukaannya adalah permukaan bangunan (jika ada) atau permukaan tanah (jika tidak ada bangunan).