Kelas Map3DElement
Class
google.maps.maps3d.Map3DElement
Map3DElement adalah antarmuka HTML untuk tampilan Peta 3D. Perhatikan bahwa mode
harus ditetapkan agar Peta 3D mulai dirender.
Elemen kustom:
<gmp-map-3d center="lat,lng,altitude" default-ui-disabled heading="number" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number"></gmp-map-3d>
Class ini memperluas
HTMLElement
.
Class ini mengimplementasikan
Map3DElementOptions
.
Akses dengan memanggil const {Map3DElement} = await google.maps.importLibrary("maps3d")
.
Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
Map3DElement |
Map3DElement([options]) Parameter:
|
Properti | |
---|---|
bounds |
Jenis:
LatLngBounds|LatLngBoundsLiteral optional 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 |
Jenis:
LatLngAltitude|LatLngAltitudeLiteral optional 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:
|
defaultUIDisabled |
Jenis:
boolean optional Default:
false Jika
true , semua tombol UI default akan dinonaktifkan. Tidak menonaktifkan kontrol keyboard dan gestur.Atribut HTML:
|
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:
|
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:
|
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:
|
maxTilt |
Jenis:
number optional Sudut datang maksimum peta. Nilai yang valid adalah antara
0 dan 90 derajat.Atribut HTML:
|
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:
|
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:
|
minTilt |
Jenis:
number optional Sudut datang minimum peta. Nilai yang valid adalah antara
0 dan 90 derajat.Atribut HTML:
|
mode |
Jenis:
MapMode optional Menentukan mode peta harus dirender. Jika tidak disetel, peta tidak akan dirender.
Atribut HTML:
|
range |
Jenis:
number optional Jarak dari kamera ke pusat peta, dalam meter.
Atribut HTML:
|
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:
|
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:
|
Metode | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
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. |
|
removeEventListener(type, listener[, options]) Parameter:
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. |
Acara | |
---|---|
gmp-animationend |
function(animationEndEvent) Argumen:
Peristiwa ini dipicu saat animasi terbang berakhir. Peristiwa ini muncul melalui hierarki DOM. |
gmp-centerchange |
function(centerChangeEvent) Argumen:
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:
Peristiwa ini dipicu saat properti heading Map3DElement berubah. |
gmp-rangechange |
function(rangeChangeEvent) Argumen:
Peristiwa ini dipicu 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 dipicu saat status stabil Map3DElement berubah. |
gmp-tiltchange |
function(tiltChangeEvent) Argumen:
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.
Properti | |
---|---|
bounds optional |
Jenis:
LatLngBounds|LatLngBoundsLiteral optional Lihat Map3DElement.bounds . |
center optional |
Jenis:
LatLngAltitude|LatLngAltitudeLiteral optional Lihat Map3DElement.center . |
defaultUIDisabled optional |
Jenis:
boolean optional |
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 . |
mode optional |
Jenis:
MapMode optional Lihat Map3DElement.mode . |
range optional |
Jenis:
number optional Lihat Map3DElement.range . |
roll optional |
Jenis:
number optional Lihat Map3DElement.roll . |
tilt optional |
Jenis:
number optional Lihat Map3DElement.tilt . |
Konstanta MapMode
google.maps.maps3d.MapMode
konstanta
Menentukan mode peta harus dirender.
Akses dengan memanggil const {MapMode} = await google.maps.importLibrary("maps3d")
.
Lihat Library di Maps JavaScript API.
Konstanta | |
---|---|
HYBRID |
Mode peta ini menampilkan lapisan transparan jalan utama di satelit, atau gambar fotorealistik. |
SATELLITE |
Mode peta ini menampilkan citra satelit atau fotorealistik jika tersedia. |
FlyAroundAnimationOptions interface
google.maps.maps3d.FlyAroundAnimationOptions
interface
Opsi penyesuaian untuk Animasi FlyCameraAround.
Properti | |
---|---|
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.
Properti | |
---|---|
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.
Properti | |
---|---|
center optional |
Jenis:
LatLngAltitude|LatLngAltitudeLiteral 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.
Properti | |
---|---|
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.
Properti | |
---|---|
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 ikon tempat di Map3DElement
. Untuk mencegah popover default muncul, panggil metode preventDefault()
pada peristiwa ini untuk mencegahnya ditangani oleh Map3DElement
.
Class ini memperluas
LocationClickEvent
.
Akses dengan memanggil const {PlaceClickEvent} = await google.maps.importLibrary("maps3d")
.
Lihat Library di Maps JavaScript API.
Properti | |
---|---|
placeId |
Jenis:
string ID tempat fitur peta. |
Diwarisi:
position
|
Metode | |
---|---|
fetchPlace |
fetchPlace() Parameter: Tidak ada
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" position="lat,lng" 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.
Konstruktor | |
---|---|
Marker3DElement |
Marker3DElement([options]) Parameter:
Membuat Marker3DElement dengan opsi yang ditentukan. |
Properti | |
---|---|
altitudeMode |
Jenis:
AltitudeMode optional Default:
AltitudeMode.CLAMP_TO_GROUND Menentukan cara komponen ketinggian posisi diinterpretasikan.
Atribut HTML:
|
collisionBehavior |
Jenis:
CollisionBehavior optional Default:
CollisionBehavior.REQUIRED Enumerasi yang menentukan perilaku Marker3DElement saat bertabrakan dengan Marker3DElement lain atau dengan label peta dasar.
Atribut HTML:
|
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:
|
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:
|
label |
Jenis:
string optional Teks yang akan ditampilkan oleh penanda ini.
Atribut HTML:
|
position |
Jenis:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Lokasi ujung penanda. Ketinggian diabaikan dalam mode tertentu dan bersifat opsional.
Atribut HTML:
|
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:
|
zIndex |
Jenis:
number optional zIndex dibandingkan dengan penanda lain.
Atribut HTML:
|
Slot | |
---|---|
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. |
Metode | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Nilai yang Ditampilkan:
void Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
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.
Properti | |
---|---|
altitudeMode optional |
Jenis:
AltitudeMode optional Lihat Marker3DElement.altitudeMode . |
collisionBehavior optional |
Jenis:
CollisionBehavior optional |
drawsWhenOccluded optional |
Jenis:
boolean optional |
extruded optional |
Jenis:
boolean optional Lihat Marker3DElement.extruded . |
label optional |
Jenis:
string optional Lihat Marker3DElement.label . |
position optional |
Jenis:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Lihat Marker3DElement.position . |
sizePreserved optional |
Jenis:
boolean optional |
zIndex optional |
Jenis:
number optional Lihat Marker3DElement.zIndex . |
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-popover-target="popover-id" title="string"></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.
Konstruktor | |
---|---|
Marker3DInteractiveElement |
Marker3DInteractiveElement([options]) Parameter:
Membuat Marker3DInteractiveElement dengan opsi yang ditentukan. |
Properti | |
---|---|
gmpPopoverTargetElement |
Jenis:
PopoverElement optional Jika ditetapkan, elemen popover akan terbuka saat penanda ini diklik.
Atribut HTML:
|
title |
Jenis:
string Teks rollover. Jika disediakan, teks aksesibilitas (misalnya, untuk digunakan dengan pembaca layar) akan ditambahkan ke
Marker3DInteractiveElement dengan nilai yang diberikan.Atribut HTML:
|
Diwariskan:
altitudeMode ,
collisionBehavior ,
drawsWhenOccluded ,
extruded ,
label ,
position ,
sizePreserved ,
zIndex
|
Slot | |
---|---|
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. |
Metode | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parameter:
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 |
Acara | |
---|---|
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
.
Properti | |
---|---|
gmpPopoverTargetElement optional |
Jenis:
PopoverElement optional |
title optional |
Jenis:
string optional |
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" orientation="heading,tilt,roll" position="lat,lng" scale="number" src="url"></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.
Konstruktor | |
---|---|
Model3DElement |
Model3DElement([options]) Parameter:
Membuat Model3DElement dengan opsi yang ditentukan. |
Properti | |
---|---|
altitudeMode |
Jenis:
AltitudeMode optional Default:
AltitudeMode.CLAMP_TO_GROUND Menentukan cara ketinggian di posisi diinterpretasikan.
Atribut HTML:
|
orientation |
Jenis:
Orientation3D|Orientation3DLiteral optional Menjelaskan rotasi sistem koordinat model 3D untuk memosisikan model di Peta 3D. Rotasi
diterapkan ke model dalam urutan berikut: roll, kemiringan, lalu arah. Atribut HTML:
|
position |
Jenis:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Menetapkan posisi
Model3DElement . Ketinggian diabaikan dalam mode tertentu dan bersifat opsional.Atribut HTML:
|
scale |
Jenis:
number|Vector3D|Vector3DLiteral optional Default:
1 Menskalakan model di sepanjang sumbu x, y, dan z dalam ruang koordinat model.
Atribut HTML:
|
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:
|
Metode | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Nilai yang Ditampilkan:
void Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
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.
Properti | |
---|---|
altitudeMode optional |
Jenis:
AltitudeMode optional Lihat Model3DElement.altitudeMode . |
orientation optional |
Jenis:
Orientation3D|Orientation3DLiteral optional Lihat Model3DElement.orientation . |
position optional |
Jenis:
LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral optional Lihat Model3DElement.position . |
scale optional |
Jenis:
number|Vector3D|Vector3DLiteral optional Lihat Model3DElement.scale . |
src optional |
Jenis:
string|URL optional Lihat Model3DElement.src . |
Model3DInteractiveElement class
Class
google.maps.maps3d.Model3DInteractiveElement
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.
Tidak seperti Model3DElement
, Model3DInteractiveElement
menerima peristiwa gmp-click
.
Elemen kustom:
<gmp-model-3d-interactive></gmp-model-3d-interactive>
Class ini memperluas
Model3DElement
.
Class ini mengimplementasikan
Model3DInteractiveElementOptions
.
Akses dengan memanggil const {Model3DInteractiveElement} = await google.maps.importLibrary("maps3d")
.
Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
Model3DInteractiveElement |
Model3DInteractiveElement([options]) Parameter:
Membuat Model3DInteractiveElement dengan opsi yang ditentukan. |
Properti | |
---|---|
Diwariskan:
altitudeMode ,
orientation ,
position ,
scale ,
src
|
Metode | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parameter:
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 |
Acara | |
---|---|
gmp-click |
function(clickEvent) Argumen:
Peristiwa ini diaktifkan saat elemen Model3DInteractiveElement diklik. |
Model3DInteractiveElementOptions interface
google.maps.maps3d.Model3DInteractiveElementOptions
interface
Objek Model3DInteractiveElementOptions yang digunakan untuk menentukan properti yang dapat ditetapkan pada Model3DInteractiveElement.
Antarmuka ini memperluas
Model3DElementOptions
.
Properti | |
---|---|
Diwariskan:
altitudeMode ,
orientation ,
position ,
scale ,
src
|
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.
Konstruktor | |
---|---|
Polyline3DElement |
Polyline3DElement([options]) Parameter:
Membuat Polyline3DElement dengan opsi yang ditentukan. |
Properti | |
---|---|
altitudeMode |
Jenis:
AltitudeMode optional Default:
AltitudeMode.CLAMP_TO_GROUND Menentukan cara komponen ketinggian dalam koordinat diinterpretasikan.
Atribut HTML:
|
coordinates |
Jenis:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional 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:
|
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:
|
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:
|
outerColor |
Jenis:
string optional Warna luar. Semua warna CSS3 didukung.
Atribut HTML:
|
outerWidth |
Jenis:
number optional Lebar luar antara
0.0 dan 1.0 . Ini adalah persentase strokeWidth .Atribut HTML:
|
strokeColor |
Jenis:
string optional Warna garis luar. Semua warna CSS3 didukung.
Atribut HTML:
|
strokeWidth |
Jenis:
number optional Lebar garis luar dalam piksel.
Atribut HTML:
|
zIndex |
Jenis:
number optional zIndex dibandingkan dengan poligon lainnya.
Atribut HTML:
|
Metode | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Nilai yang Ditampilkan:
void Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
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.
Properti | |
---|---|
altitudeMode optional |
Jenis:
AltitudeMode optional |
coordinates optional |
Jenis:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional |
drawsOccludedSegments optional |
Jenis:
boolean optional |
extruded optional |
Jenis:
boolean optional Lihat Polyline3DElement.extruded . |
geodesic optional |
Jenis:
boolean optional Lihat Polyline3DElement.geodesic . |
outerColor optional |
Jenis:
string optional Lihat Polyline3DElement.outerColor . |
outerWidth optional |
Jenis:
number optional Lihat Polyline3DElement.outerWidth . |
strokeColor optional |
Jenis:
string optional |
strokeWidth optional |
Jenis:
number optional |
zIndex optional |
Jenis:
number optional Lihat Polyline3DElement.zIndex . |
Polyline3DInteractiveElement class
Class
google.maps.maps3d.Polyline3DInteractiveElement
Polyline 3D adalah overlay linear segmen garis terhubung pada peta 3D. Tidak seperti Polyline3DElement
, Polyline3DInteractiveElement
menerima peristiwa gmp-click
.
Elemen kustom:
<gmp-polyline-3d-interactive></gmp-polyline-3d-interactive>
Class ini memperluas
Polyline3DElement
.
Class ini mengimplementasikan
Polyline3DInteractiveElementOptions
.
Akses dengan memanggil const {Polyline3DInteractiveElement} = await google.maps.importLibrary("maps3d")
.
Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
Polyline3DInteractiveElement |
Polyline3DInteractiveElement([options]) Parameter:
Membuat Polyline3DInteractiveElement dengan opsi yang ditentukan. |
Properti | |
---|---|
Diwariskan:
altitudeMode ,
coordinates ,
drawsOccludedSegments ,
extruded ,
geodesic ,
outerColor ,
outerWidth ,
strokeColor ,
strokeWidth ,
zIndex
|
Metode | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parameter:
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 |
Acara | |
---|---|
gmp-click |
function(clickEvent) Argumen:
Peristiwa ini diaktifkan saat elemen Polyline3DInteractiveElement diklik. |
Antarmuka Polyline3DInteractiveElementOptions
google.maps.maps3d.Polyline3DInteractiveElementOptions
interface
Objek Polyline3DInteractiveElementOptions yang digunakan untuk menentukan properti yang dapat ditetapkan pada Polyline3DInteractiveElement.
Antarmuka ini memperluas
Polyline3DElementOptions
.
Properti | |
---|---|
Diwariskan:
altitudeMode ,
coordinates ,
drawsOccludedSegments ,
extruded ,
geodesic ,
outerColor ,
outerWidth ,
strokeColor ,
strokeWidth ,
zIndex
|
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.
Konstruktor | |
---|---|
Polygon3DElement |
Polygon3DElement([options]) Parameter:
Membuat Polygon3DElement dengan opsi yang ditentukan. |
Properti | |
---|---|
altitudeMode |
Jenis:
AltitudeMode optional Default:
AltitudeMode.CLAMP_TO_GROUND Menentukan cara komponen ketinggian dalam koordinat diinterpretasikan.
Atribut HTML:
|
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:
|
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:
|
fillColor |
Jenis:
string optional Warna pengisi. Semua warna CSS3 didukung.
Atribut HTML:
|
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:
|
innerCoordinates |
Jenis:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral>> optional 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 |
Jenis:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional 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:
|
strokeWidth |
Jenis:
number optional Lebar garis luar dalam piksel.
Atribut HTML:
|
zIndex |
Jenis:
number optional zIndex dibandingkan dengan poligon lainnya.
Atribut HTML:
|
Metode | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Nilai yang Ditampilkan:
void Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
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.
Properti | |
---|---|
altitudeMode optional |
Jenis:
AltitudeMode optional |
drawsOccludedSegments optional |
Jenis:
boolean optional |
extruded optional |
Jenis:
boolean optional Lihat Polygon3DElement.extruded . |
fillColor optional |
Jenis:
string optional Lihat Polygon3DElement.fillColor . |
geodesic optional |
Jenis:
boolean optional Lihat Polygon3DElement.geodesic . |
innerCoordinates optional |
Jenis:
Iterable<Iterable<LatLngAltitude|LatLngAltitudeLiteral>|Iterable<LatLngLiteral>> optional |
outerCoordinates optional |
Jenis:
Iterable<LatLngAltitude|LatLngAltitudeLiteral|LatLngLiteral> optional |
strokeColor optional |
Jenis:
string optional Lihat Polygon3DElement.strokeColor . |
strokeWidth optional |
Jenis:
number optional Lihat Polygon3DElement.strokeWidth . |
zIndex optional |
Jenis:
number optional Lihat Polygon3DElement.zIndex . |
Polygon3DInteractiveElement class
Class
google.maps.maps3d.Polygon3DInteractiveElement
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. Tidak seperti Polygon3DElement
, Polygon3DInteractiveElement
menerima peristiwa gmp-click
.
Elemen kustom:
<gmp-polygon-3d-interactive></gmp-polygon-3d-interactive>
Class ini memperluas
Polygon3DElement
.
Class ini mengimplementasikan
Polygon3DInteractiveElementOptions
.
Akses dengan memanggil const {Polygon3DInteractiveElement} = await google.maps.importLibrary("maps3d")
.
Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
Polygon3DInteractiveElement |
Polygon3DInteractiveElement([options]) Parameter:
Membuat Polygon3DInteractiveElement dengan opsi yang ditentukan. |
Properti | |
---|---|
Diwariskan:
altitudeMode ,
drawsOccludedSegments ,
extruded ,
fillColor ,
geodesic ,
innerCoordinates ,
outerCoordinates ,
strokeColor ,
strokeWidth ,
zIndex
|
Metode | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) Parameter:
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 |
Acara | |
---|---|
gmp-click |
function(clickEvent) Argumen:
Peristiwa ini diaktifkan saat elemen Polygon3DInteractiveElement diklik. |
Antarmuka Polygon3DInteractiveElementOptions
google.maps.maps3d.Polygon3DInteractiveElementOptions
interface
Objek Polygon3DInteractiveElementOptions yang digunakan untuk menentukan properti yang dapat ditetapkan pada Polygon3DInteractiveElement.
Antarmuka ini memperluas
Polygon3DElementOptions
.
Properti | |
---|---|
Diwariskan:
altitudeMode ,
drawsOccludedSegments ,
extruded ,
fillColor ,
geodesic ,
innerCoordinates ,
outerCoordinates ,
strokeColor ,
strokeWidth ,
zIndex
|
Class PopoverElement
Class
google.maps.maps3d.PopoverElement
Elemen HTML kustom yang merender popover. Tampilannya seperti balon dan sering kali terhubung ke penanda.
Elemen kustom:
<gmp-popover altitude-mode="absolute" light-dismiss-disabled open position-anchor="lat,lng"></gmp-popover>
Class ini memperluas
HTMLElement
.
Class ini mengimplementasikan
PopoverElementOptions
.
Akses dengan memanggil const {PopoverElement} = await google.maps.importLibrary("maps3d")
.
Lihat Library di Maps JavaScript API.
Konstruktor | |
---|---|
PopoverElement |
PopoverElement([options]) Parameter:
|
Properti | |
---|---|
altitudeMode |
Jenis:
AltitudeMode optional Default:
AltitudeMode.CLAMP_TO_GROUND Menentukan cara komponen ketinggian posisi diinterpretasikan.
Atribut HTML:
|
lightDismissDisabled |
Jenis:
boolean optional Default:
false Menentukan apakah popover ini harus "ditutup ringan" atau tidak. Perilaku "tutup ringan" mirip dengan menyetel atribut
popover="auto" yang merupakan bagian dari Popover API browser.Atribut HTML:
|
open |
Jenis:
boolean optional Default:
false Menentukan apakah popover ini harus terbuka atau tidak.
Atribut HTML:
|
positionAnchor |
Jenis:
LatLngLiteral|LatLngAltitudeLiteral|Marker3DInteractiveElement|string optional Posisi untuk menampilkan popover ini. Jika popover ditambatkan ke penanda interaktif, posisi penanda akan digunakan.
Atribut HTML:
|
Slot | |
---|---|
default |
Menempatkan konten slot di bagian utama popover. |
header |
Menempatkan konten slot di bagian heading popover. |
Properti CSS | |
---|---|
--gmp-popover-max-width |
Lebar maksimum popover, terlepas dari lebar konten. |
--gmp-popover-min-width |
Lebar minimum popover, terlepas dari lebar konten. Saat menggunakan properti ini, sebaiknya setel ke nilai yang lebih kecil dari lebar peta (dalam piksel). |
--gmp-popover-pixel-offset-x |
Offset pada sumbu x, dalam piksel, dari ujung popover dari titik pada peta yang koordinat geografisnya menjadi titik penjangkaran popover. |
--gmp-popover-pixel-offset-y |
Offset pada sumbu y, dalam piksel, dari ujung popover dari titik di peta yang koordinat geografisnya menjadi titik anchor popover. |
color-scheme |
Menunjukkan skema warna yang dapat digunakan untuk merender popover ini. Lihat dokumentasi color-scheme untuk mengetahui detail selengkapnya. Jika tidak ditentukan, nilai defaultnya adalah preferensi skema warna pengguna. |
Metode | |
---|---|
|
addEventListener(type, listener[, options]) Parameter:
Nilai yang Ditampilkan:
void Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirimkan ke target. Lihat addEventListener. |
|
removeEventListener(type, listener[, options]) Parameter:
Nilai yang Ditampilkan:
void Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener. |
PopoverElementOptions interface
google.maps.maps3d.PopoverElementOptions
interface
Objek PopoverElementOptions yang digunakan untuk menentukan properti yang dapat ditetapkan pada PopoverElement.
Properti | |
---|---|
altitudeMode optional |
Jenis:
AltitudeMode optional Lihat PopoverElement.altitudeMode . |
lightDismissDisabled optional |
Jenis:
boolean optional |
open optional |
Jenis:
boolean optional Lihat PopoverElement.open . |
positionAnchor optional |
Jenis:
LatLngLiteral|LatLngAltitudeLiteral|string|Marker3DInteractiveElement 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.
Konstanta | |
---|---|
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). |