3D Maps

Class 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 ditetapkan, akan membatasi posisi kamera dalam batas lintang/bujur yang ditentukan. Perhatikan bahwa objek di luar batas masih dirender. Batas dapat membatasi bujur dan lintang, atau dapat membatasi lintang atau bujur saja. Untuk batas khusus lintang, gunakan bujur barat dan timur -180 dan 180. Untuk batas bujur saja, gunakan lintang utara dan selatan 90 dan -90.
center
Pusat peta yang diberikan sebagai LatLngAltitude, dengan ketinggian dalam meter di atas permukaan tanah. Perhatikan bahwa ini tidak selalu merupakan lokasi kamera, karena kolom range memengaruhi jarak kamera dari pusat peta. Jika tidak ditetapkan, setelan defaultnya adalah {lat: 0, lng: 0, altitude: 63170000}. 63170000 meter adalah ketinggian maksimum yang diizinkan (radius Bumi dikalikan dengan 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>
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 sejati adalah nol. Jika tidak ada kemiringan, setiap kemiringan 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 (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 mewakili interval <= 360 derajat tempat gestur arah akan diizinkan. minHeading = 180 dan maxHeading = 90 akan mengizinkan judul di [0, 90] dan judul di [180, 360]. minHeading = 90 dan maxHeading = 180 akan mengizinkan judul di [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 (jari-jari Bumi dikalikan dengan 10).
Atribut HTML:
  • <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading
Jenis:  number optional
Sudut arah (rotasi) peta minimum. Nilai yang valid adalah antara 0 dan 360 derajat. minHeading dan maxHeading mewakili interval <= 360 derajat tempat gestur arah akan diizinkan. minHeading = 180 dan maxHeading = 90 akan mengizinkan judul di [0, 90] dan judul di [180, 360]. minHeading = 90 dan maxHeading = 180 akan mengizinkan judul di [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
Roll kamera di sekitar vektor tampilan dalam derajat. Untuk mengatasi ambiguitas, jika tidak ada kemiringan, setiap roll akan ditafsirkan sebagai heading.
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 ke bumi akan memiliki kemiringan nol derajat. Vektor tampilan yang mengarah 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 peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. 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
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 mengorbit ke arah berlawanan dengan arah jarum jam.

Metode ini bersifat asinkron karena animasi hanya dapat dimulai setelah peta memuat jumlah minimum. Metode ini ditampilkan setelah animasi dimulai.

Jika jumlah putaran nol, tidak akan ada putaran, dan animasi akan segera selesai setelah dimulai.
flyCameraTo
flyCameraTo(options)
Parameter: 
Nilai yang Ditampilkan:  Tidak ada
Metode ini memindahkan 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 memuat jumlah minimum. Metode ini ditampilkan setelah animasi dimulai.
BetaremoveEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang akan menghapus pemroses peristiwa.
  • 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
stopCameraAnimation
stopCameraAnimation()
Parameter:  Tidak ada
Nilai yang Ditampilkan:  Tidak ada
Metode ini menghentikan animasi fly yang mungkin sedang berjalan. Kamera tetap berada di mana pun saat animasi sedang berlangsung; kamera tidak akan teleport ke titik akhir.

Metode ini bersifat asinkron karena animasi hanya dapat dimulai atau dihentikan setelah peta memuat jumlah minimum. Metode ini ditampilkan setelah animasi berhenti.
gmp-animationend
function(animationEndEvent)
Argumen: 
  • animationEndEventEvent
Peristiwa ini dipicu saat animasi terbang berakhir. Peristiwa ini muncul melalui hierarki DOM.
gmp-centerchange
function(centerChangeEvent)
Argumen: 
  • centerChangeEventEvent
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: 
  • headingChangeEventEvent
Peristiwa ini diaktifkan saat properti heading Map3DElement berubah.
gmp-rangechange
function(rangeChangeEvent)
Argumen: 
  • rangeChangeEventEvent
Peristiwa ini diaktifkan saat properti rentang Map3DElement berubah.
gmp-rollchange
function(rollChangeEvent)
Argumen: 
  • rollChangeEventEvent
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: 
  • tiltChangeEventEvent
Peristiwa ini diaktifkan saat properti kemiringan Map3DElement berubah.

Antarmuka Map3DElementOptions

Antarmuka google.maps.maps3d.Map3DElementOptions

Objek Map3DElementOptions yang digunakan untuk menentukan properti yang dapat ditetapkan di Map3DElement.

bounds optional
center optional
defaultLabelsDisabled optional
Jenis:  boolean optional
defaultUIDisabled 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

Antarmuka FlyAroundAnimationOptions

Antarmuka google.maps.maps3d.FlyAroundAnimationOptions

Opsi penyesuaian untuk Animasi FlyCameraAround.

camera
Jenis:  CameraOptions
Titik tengah tempat kamera harus melihat 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. Tindakan ini mengontrol kecepatan rotasi secara keseluruhan. Meneruskan angka negatif ke putaran akan menyebabkan kamera berputar ke arah berlawanan dengan arah jarum jam, bukan arah searah jarum jam default.

Antarmuka FlyToAnimationOptions

Antarmuka google.maps.maps3d.FlyToAnimationOptions

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 menteleportasi kamera langsung ke posisi akhir.

Antarmuka CameraOptions

Antarmuka google.maps.maps3d.CameraOptions

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
heading optional
Jenis:  number optional
range optional
Jenis:  number optional
roll optional
Jenis:  number optional
tilt optional
Jenis:  number optional

Class SteadyChangeEvent

Class google.maps.maps3d.SteadyChangeEvent

Peristiwa ini dibuat dari pemantauan status 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 tampilan saat ini telah selesai) atau tidak.

Class LocationClickEvent

Class google.maps.maps3d.LocationClickEvent

Peristiwa 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

Peristiwa 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.
Diwariskan: position
fetchPlace
fetchPlace()
Parameter:  Tidak ada
Nilai Hasil:  Promise<Place>
Mengambil Place untuk ID tempat ini. Dalam objek Place yang dihasilkan, properti id akan diisi. Kolom tambahan kemudian dapat diminta melalui Place.fetchFields(), yang tunduk pada pengaktifan dan penagihan Places API normal. Promise ditolak jika terjadi error saat mengambil Place.

Class Marker3DElement

Class google.maps.maps3d.Marker3DElement

Menampilkan posisi pada 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
Menentukan cara komponen ketinggian posisi ditafsirkan.
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
Enumerasi yang menentukan perilaku Marker3DElement saat terjadi tumpang tindih 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 terhalang. Penanda dapat terhalang oleh geometri peta (misalnya, bangunan).
Atribut HTML:
  • <gmp-marker-3d draws-when-occluded></gmp-marker-3d>
extruded
Jenis:  boolean optional
Default: false
Menentukan apakah akan menghubungkan penanda ke tanah. Untuk mengekstrud 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
Lokasi ujung penanda. Ketinggian diabaikan dalam mode tertentu sehingga bersifat opsional.
sizePreserved
Jenis:  boolean optional
Default: false
Menentukan apakah penanda ini harus mempertahankan ukurannya atau tidak, terlepas dari jarak dari kamera. Secara default, penanda diskalakan berdasarkan jarak dari kamera/kemiringan.
Atribut HTML:
  • <gmp-marker-3d size-preserved></gmp-marker-3d>
zIndex
Jenis:  number optional
zIndex dibandingkan dengan penanda lainnya.
Atribut HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
Setiap elemen kustom yang langsung ditambahkan ke Marker3DElement akan diberi slot, tetapi hanya elemen jenis HTMLImageElement, SVGElement, dan PinElement yang akan digunakan untuk menggambar penanda, elemen lainnya akan diabaikan.
HTMLImageElement dan SVGElement harus digabungkan dalam elemen <template> sebelum ditetapkan ke slot default Marker3DElement.

Gambar dan SVG saat ini diraster sebelum dirender di tampilan 3D, sehingga HTML kustom yang disematkan ke class SVG atau CSS yang ditambahkan ke gambar tidak akan diterapkan dan mungkin tidak ditampilkan saat penanda ditampilkan di layar.
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. 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 akan menghapus pemroses peristiwa.
  • 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 Marker3DElementOptions

Antarmuka google.maps.maps3d.Marker3DElementOptions

Objek Marker3DElementOptions yang digunakan untuk menentukan properti yang dapat ditetapkan pada Marker3DElement.

altitudeMode optional
Jenis:  AltitudeMode optional
collisionBehavior optional
Jenis:  CollisionBehavior optional
drawsWhenOccluded optional
Jenis:  boolean optional
extruded optional
Jenis:  boolean optional
label optional
Jenis:  string optional
position optional
sizePreserved optional
Jenis:  boolean optional
zIndex optional
Jenis:  number optional

Class Marker3DInteractiveElement

Class google.maps.maps3d.Marker3DInteractiveElement

Menampilkan posisi pada peta 3D. Perhatikan bahwa position harus ditetapkan agar Marker3DInteractiveElement ditampilkan. Tidak seperti Marker3DElement, Marker3DInteractiveElement menerima peristiwa gmp-click.

Elemen kustom:
<gmp-marker-3d-interactive></gmp-marker-3d-interactive>

Class ini memperluas Marker3DElement.

Class ini mengimplementasikan Marker3DInteractiveElementOptions.

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

Marker3DInteractiveElement
Marker3DInteractiveElement([options])
Parameter: 
Membuat Marker3DInteractiveElement dengan opsi yang ditentukan.
Diwariskan: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex
default
Setiap elemen kustom yang langsung ditambahkan ke Marker3DInteractiveElement akan diberi slot, tetapi hanya elemen jenis PinElement yang akan digunakan untuk menggambar penanda, elemen lainnya akan diabaikan.
addEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. 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
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
  • typestring String yang menentukan jenis peristiwa yang akan menghapus pemroses peristiwa.
  • 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-click
function(clickEvent)
Argumen: 
Peristiwa ini diaktifkan saat elemen Marker3DInteractiveElement diklik.

Antarmuka Marker3DInteractiveElementOptions

Antarmuka google.maps.maps3d.Marker3DInteractiveElementOptions

Objek Marker3DInteractiveElementOptions yang digunakan untuk menentukan properti yang dapat ditetapkan pada Marker3DInteractiveElement.

Antarmuka ini memperluas Marker3DElementOptions.

Diwariskan: altitudeMode, collisionBehavior, drawsWhenOccluded, extruded, label, position, sizePreserved, zIndex

Class Model3DElement

Class google.maps.maps3d.Model3DElement

Model 3D yang memungkinkan rendering model gLTF. Perhatikan bahwa position dan src harus ditetapkan agar Model3DElement ditampilkan.

Properti inti gLTF PBR harus didukung. Saat ini tidak ada ekstensi atau properti ekstensi yang didukung.

Elemen kustom:
<gmp-model-3d altitude-mode="absolute" src="src"></gmp-model-3d>

Class ini memperluas HTMLElement.

Class ini mengimplementasikan Model3DElementOptions.

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

Model3DElement
Model3DElement([options])
Parameter: 
Membuat Model3DElement dengan opsi yang ditentukan.
altitudeMode
Jenis:  AltitudeMode optional
Menentukan cara ketinggian di posisi ditafsirkan.
Atribut HTML:
  • <gmp-model-3d altitude-mode="absolute"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="clamp-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-ground"></gmp-model-3d>
  • <gmp-model-3d altitude-mode="relative-to-mesh"></gmp-model-3d>
orientation
Menjelaskan rotasi sistem koordinat model 3D untuk memosisikan model di Peta 3D.

Rotasi diterapkan ke model dalam urutan berikut: roll, tilt, lalu heading.
position
Menetapkan posisi Model3DElement. Ketinggian diabaikan dalam mode tertentu sehingga bersifat opsional.
scale
Jenis:  number|Vector3D|Vector3DLiteral optional
Default: 1
Menskalakan model di sepanjang sumbu x, y, dan z dalam ruang koordinat model.
src
Jenis:  string|URL optional
Menentukan URL model 3D. Saat ini, hanya model dalam format .glb yang didukung.

Setiap URL HTTP relatif akan di-resolve ke URL absolut yang sesuai.

Perhatikan bahwa jika Anda menghosting file model .glb di situs atau server yang berbeda dengan aplikasi utama, pastikan untuk menyiapkan header HTTP CORS yang benar. Tindakan ini memungkinkan aplikasi Anda mengakses file model dari domain lain dengan aman.
Atribut HTML:
  • <gmp-model-3d src="src"></gmp-model-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. 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 akan menghapus pemroses peristiwa.
  • 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 Model3DElementOptions

Antarmuka google.maps.maps3d.Model3DElementOptions

Objek Model3DElementOptions yang digunakan untuk menentukan properti yang dapat ditetapkan pada Model3DElement.

altitudeMode optional
Jenis:  AltitudeMode optional
orientation optional
position optional
scale optional
Jenis:  number|Vector3D|Vector3DLiteral optional
src optional
Jenis:  string|URL optional

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-width="number" stroke-color="string" 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: 
Membuat Polyline3DElement dengan opsi yang ditentukan.
altitudeMode
Jenis:  AltitudeMode optional
Menentukan 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 koordinat Polyline yang diurutkan. Ketinggian diabaikan dalam mode tertentu sehingga bersifat opsional.
drawsOccludedSegments
Jenis:  boolean optional
Default: false
Menentukan apakah bagian polyline yang dapat dioklusi 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 mengekstrud polilini, altitudeMode harus berupa 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.
Atribut HTML:
  • <gmp-polyline-3d outer-color="string"></gmp-polyline-3d>
outerWidth
Jenis:  number optional
Lebar luarnya 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.
Atribut HTML:
  • <gmp-polyline-3d stroke-color="string"></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 poligon lainnya.
Atribut HTML:
  • <gmp-polyline-3d z-index="number"></gmp-polyline-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. 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 akan menghapus pemroses peristiwa.
  • 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 menentukan properti yang dapat ditetapkan pada Polyline3DElement.

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

Class Polygon3DElement

Class google.maps.maps3d.Polygon3DElement

Poligon 3D (seperti polyline 3D) menentukan serangkaian koordinat yang terhubung dalam urutan yang berurutan. Selain itu, poligon membentuk loop tertutup dan menentukan wilayah yang terisi.

Elemen kustom:
<gmp-polygon-3d altitude-mode="absolute" draws-occluded-segments extruded fill-color="string" geodesic stroke-color="string" 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: 
Membuat Polygon3DElement dengan opsi yang ditentukan.
altitudeMode
Jenis:  AltitudeMode optional
Menentukan 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 dioklusi 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 mengekstrud poligon, altitudeMode harus berupa RELATIVE_TO_GROUND atau ABSOLUTE.
Atribut HTML:
  • <gmp-polygon-3d extruded></gmp-polygon-3d>
fillColor
Jenis:  string optional
Warna pengisi. Semua warna CSS3 didukung.
Atribut HTML:
  • <gmp-polygon-3d fill-color="string"></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 koordinat yang diurutkan yang menunjuk loop tertutup. Tidak seperti polyline, poligon dapat terdiri dari satu atau beberapa jalur, yang membuat beberapa potongan di dalam poligon.
outerCoordinates
Urutan koordinat yang diurutkan yang menunjuk loop tertutup. Ketinggian diabaikan dalam mode tertentu sehingga bersifat opsional.
strokeColor
Jenis:  string optional
Warna garis luar. Semua warna CSS3 didukung.
Atribut HTML:
  • <gmp-polygon-3d stroke-color="string"></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 poligon lainnya.
Atribut HTML:
  • <gmp-polygon-3d z-index="number"></gmp-polygon-3d>
BetaaddEventListener
addEventListener(type, listener[, options])
Parameter: 
  • typestring String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses.
  • listenerEventListener|EventListenerObject Objek yang menerima notifikasi. 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 akan menghapus pemroses peristiwa.
  • 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 ditetapkan pada Polygon3DElement.

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

Konstanta AltitudeMode

Konstanta google.maps.maps3d.AltitudeMode

Menentukan 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 relatif terhadap permukaan laut rata-rata. Artinya, jika tingkat detail medan berubah di bawah objek, posisi absolutnya akan tetap sama.
CLAMP_TO_GROUND Memungkinkan untuk menampilkan objek yang ditempatkan di tanah. Objek akan tetap berada di permukaan tanah mengikuti medan, terlepas dari ketinggian yang diberikan. Jika diposisikan di atas badan air utama, objek akan ditempatkan di permukaan laut.
RELATIVE_TO_GROUND Memungkinkan untuk mengekspresikan objek relatif terhadap permukaan tanah. Jika tingkat detail medan berubah, posisi objek akan tetap konstan relatif terhadap tanah. Saat berada di atas air, ketinggian akan ditafsirkan sebagai nilai dalam meter di atas permukaan laut.
RELATIVE_TO_MESH Memungkinkan untuk mengekspresikan objek relatif terhadap permukaan tanah+bangunan+air tertinggi. Jika berada di atas air, ini akan menjadi permukaan air; jika berada di atas medan, ini akan menjadi permukaan bangunan (jika ada) atau permukaan tanah (jika tidak ada bangunan).