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: 
  • 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 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: 
  • typestring String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus.
  • listenerEventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|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: 
  • animationEndEventEvent
Peristiwa ini dipicu saat animasi terbang berakhir. Peristiwa ini muncul melalui hierarki DOM.
gmp-centerchange
function(centerChangeEvent)
Argumen: 
  • centerChangeEventEvent
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: 
  • headingChangeEventEvent
Peristiwa ini dipicu saat properti heading Map3DElement berubah.
gmp-rangechange
function(rangeChangeEvent)
Argumen: 
  • rangeChangeEventEvent
Peristiwa ini dipicu 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

google.maps.maps3d.Map3DElementOptions interface

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

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

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
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
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
Lokasi ujung penanda. Ketinggian diabaikan dalam mode tertentu dan 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 lain.
Atribut HTML:
  • <gmp-marker-3d z-index="number"></gmp-marker-3d>
default
Setiap elemen kustom yang ditambahkan langsung ke Marker3DElement akan dimasukkan, tetapi hanya elemen jenis HTMLImageElement, SVGElement, dan PinElement yang akan digunakan untuk menggambar penanda, elemen lain akan diabaikan.
HTMLImageElement dan SVGElement harus di-wrap dalam elemen <template> sebelum ditetapkan ke slot default Marker3DElement.

Gambar dan SVG saat ini diraster sebelum dirender dalam adegan 3D, sehingga HTML kustom yang disematkan ke SVG atau class CSS yang ditambahkan ke gambar tidak akan diterapkan dan mungkin tidak tercermin 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 yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan 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 dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.

Marker3DElementOptions interface

google.maps.maps3d.Marker3DElementOptions interface

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

Kelas Marker3DInteractiveElement

Class google.maps.maps3d.Marker3DInteractiveElement

Menampilkan posisi di 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
Elemen kustom apa pun yang ditambahkan langsung ke Marker3DInteractiveElement akan dimasukkan, tetapi hanya elemen jenis PinElement yang akan digunakan untuk menggambar penanda, elemen lain 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 yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener
removeEventListener
removeEventListener(type, listener[, options])
Parameter: 
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener
gmp-click
function(clickEvent)
Argumen: 
Peristiwa ini diaktifkan saat elemen Marker3DInteractiveElement diklik.

Antarmuka Marker3DInteractiveElementOptions

google.maps.maps3d.Marker3DInteractiveElementOptions interface

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

Model3DElement class

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 diinterpretasikan.
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, kemiringan, lalu arah.
position
Menetapkan posisi Model3DElement. Ketinggian diabaikan dalam mode tertentu dan 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.

URL HTTP relatif akan diselesaikan 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. Hal ini memungkinkan aplikasi Anda mengakses file model dengan aman dari domain lain.
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 yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan 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 dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.

Model3DElementOptions interface

google.maps.maps3d.Model3DElementOptions interface

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

Polyline3DElement class

Class google.maps.maps3d.Polyline3DElement

Polyline 3D adalah overlay linear segmen garis 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 diinterpretasikan.
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 dan bersifat opsional.
drawsOccludedSegments
Jenis:  boolean optional
Default: false
Menentukan apakah bagian polyline yang mungkin tertutup digambar atau tidak. Polyline dapat tertutup oleh geometri peta (misalnya, bangunan).
Atribut HTML:
  • <gmp-polyline-3d draws-occluded-segments></gmp-polyline-3d>
extruded
Jenis:  boolean optional
Default: false
Menentukan apakah polyline akan dihubungkan ke tanah. Untuk mengekstrusi polyline, 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 ditafsirkan sebagai geodesi dan akan mengikuti kelengkungan Bumi. Saat false, tepi polyline dirender sebagai garis lurus dalam 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 luar antara 0.0 dan 1.0. Ini adalah persentase 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 yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan 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 dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.

Polyline3DElementOptions interface

google.maps.maps3d.Polyline3DElementOptions interface

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

Kelas Polygon3DElement

Class google.maps.maps3d.Polygon3DElement

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

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 diinterpretasikan.
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 mungkin tertutup digambar atau tidak. Poligon dapat tertutup oleh geometri peta (misalnya, bangunan).
Atribut HTML:
  • <gmp-polygon-3d draws-occluded-segments></gmp-polygon-3d>
extruded
Jenis:  boolean optional
Default: false
Menentukan apakah poligon akan dihubungkan ke tanah. Untuk mengekstrusi 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 ditafsirkan sebagai geodesi dan akan mengikuti kelengkungan Bumi. Jika false, tepi poligon dirender sebagai garis lurus dalam ruang layar.
Atribut HTML:
  • <gmp-polygon-3d geodesic></gmp-polygon-3d>
innerCoordinates
Urutan koordinat yang diurutkan yang menunjukkan 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 menunjukkan loop tertutup. Ketinggian diabaikan dalam mode tertentu dan 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 yang Ditampilkan:  void
Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan 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 dari pengendali peristiwa yang akan dihapus dari target peristiwa.
  • optionsboolean|EventListenerOptions optional Lihat opsi.
Nilai yang Ditampilkan:  void
Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.

Polygon3DElementOptions interface

google.maps.maps3d.Polygon3DElementOptions interface

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

google.maps.maps3d.AltitudeMode konstanta

Menentukan cara komponen ketinggian dalam koordinat diinterpretasikan.

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

ABSOLUTE Memungkinkan untuk menyatakan objek relatif terhadap permukaan laut rata-rata. Artinya juga, jika tingkat detail medan di bawah objek berubah, posisi absolutnya akan tetap sama.
CLAMP_TO_GROUND Memungkinkan untuk mengekspresikan objek yang ditempatkan di tanah. Objek akan tetap berada di permukaan tanah mengikuti medan, terlepas dari ketinggian yang diberikan. Jika objek diposisikan di atas perairan besar, 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 menyatakan 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).