3D Maps

Class 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-hidden description="string" gesture-handling="auto" heading="number" internal-usage-attribution-ids="id1 id2" map-id="string" 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" default-ui-disabled></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:  options:  Map3DElementOptions optional

Properti
bounds	Jenis:  LatLngBounds|LatLngBoundsLiteral optional Jika ditetapkan, membatasi posisi kamera dalam batas lintang/bujur 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 khusus lintang, gunakan bujur barat dan timur masing-masing -180 dan 180. Untuk batas khusus bujur, gunakan lintang utara dan selatan masing-masing 90 dan -90.
center	Jenis:  LatLngAltitude|LatLngAltitudeLiteral optional Pusat peta yang diberikan sebagai LatLngAltitude, dengan ketinggian dalam meter di atas permukaan tanah. Perhatikan bahwa ini belum tentu lokasi kamera, karena kolom range memengaruhi jarak kamera dari pusat peta. Jika tidak ditetapkan, setelan defaultnya adalah {lat: 0, lng: 0, altitude: 63170000}. 63.170.000 meter adalah ketinggian maksimum yang diizinkan (jari-jari Bumi dikalikan 10). Atribut HTML: <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultUIHidden	Jenis:  boolean optional Default: false Jika true, semua tombol UI default akan disembunyikan. Atribut HTML: <gmp-map-3d default-ui-hidden></gmp-map-3d>
description	Jenis:  string optional Jika diberikan, deskripsi aksesibilitas (misalnya, untuk digunakan dengan pembaca layar) akan ditambahkan ke peta dengan nilai yang diberikan. Atribut HTML: <gmp-map-3d description="string"></gmp-map-3d>
gestureHandling	Jenis:  GestureHandling optional Default: GestureHandling.GREEDY Mengontrol penanganan gestur kooperatif. Jika disetel ke COOPERATIVE, tombol pengubah atau gestur dua jari diperlukan untuk men-scroll peta. Jika disetel ke GREEDY, halaman host tidak dapat di-scroll dari peristiwa pengguna di elemen peta. Jika disetel ke AUTO, penanganan gestur ditentukan oleh kemampuan scroll halaman host. Atribut HTML: <gmp-map-3d gesture-handling="auto"></gmp-map-3d> <gmp-map-3d gesture-handling="cooperative"></gmp-map-3d> <gmp-map-3d gesture-handling="greedy"></gmp-map-3d>
heading	Jenis:  number optional Arah kompas peta, dalam derajat, dengan utara sejati adalah nol. Jika tidak ada kemiringan, setiap rotasi akan ditafsirkan sebagai arah. Atribut HTML: <gmp-map-3d heading="number"></gmp-map-3d>
internalUsageAttributionIds	Jenis:  Iterable<string> optional Menambahkan ID atribusi penggunaan ke penginisialisasi, yang membantu Google memahami library dan contoh mana yang berguna bagi developer, seperti penggunaan library pengelompokan penanda. Untuk memilih tidak mengirim ID atribusi penggunaan, Anda dapat menghapus properti ini dengan aman. Hanya nilai unik yang akan dikirim. Perubahan pada nilai ini setelah pembuatan instance dapat diabaikan. Atribut HTML: <gmp-map-3d internal-usage-attribution-ids="id1 id2"></gmp-map-3d>
language	Jenis:  string optional Bahasa yang akan digunakan untuk merender bahasa peta dasar. Akan ditetapkan secara default ke bahasa yang diminta oleh developer saat memuat Maps JS API.
mapId	Jenis:  string optional Menentukan ID Peta yang akan digunakan untuk mengambil gaya visual peta berbasis cloud untuk peta. Ini tidak boleh ditetapkan setelah peta diinisialisasi. Oleh karena itu, kami memastikan mapId hanya ditetapkan selama inisialisasi dan tidak memublikasikan atribut ini ke saluran yang ditampilkan kepada publik. Atribut HTML: <gmp-map-3d map-id="string"></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 (radius Bumi dikalikan 10). Atribut HTML: <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading	Jenis:  number optional Sudut maksimum arah (rotasi) peta. Nilai yang valid adalah antara 0 dan 360 derajat. minHeading dan maxHeading mewakili interval <= 360 derajat yang memungkinkan gestur kepala. minHeading = 180 dan maxHeading = 90 akan memungkinkan heading di [0, 90] dan heading di [180, 360]. minHeading = 90 dan maxHeading = 180 akan memungkinkan 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 (radius Bumi dikalikan 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 mewakili interval <= 360 derajat yang memungkinkan gestur kepala. minHeading = 180 dan maxHeading = 90 akan memungkinkan heading di [0, 90] dan heading di [180, 360]. minHeading = 90 dan maxHeading = 180 akan memungkinkan 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>
mode	Jenis:  MapMode optional Menentukan mode yang harus digunakan untuk merender peta. Jika tidak ditetapkan, peta tidak akan dirender. Atribut HTML: <gmp-map-3d mode="hybrid"></gmp-map-3d> <gmp-map-3d mode="satellite"></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>
region	Jenis:  string optional Wilayah yang akan digunakan untuk mencoba merender POI peta dasar. Akan ditetapkan secara default ke wilayah yang diminta oleh developer saat memuat Maps JS API.
roll	Jenis:  number optional Rotasi kamera di sekitar vektor tampilan dalam derajat. Untuk mengatasi ambiguitas, jika tidak ada kemiringan, setiap rotasi 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 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>
defaultUIDisabled	Tidak digunakan lagi: Sebagai gantinya, gunakan Map3DElement.defaultUIHidden. Properti ini akan dihapus dalam rilis mendatang. 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>

Metode
addEventListener	addEventListener(type, listener[, options]) Parameter:  type:  string String peka huruf besar/kecil yang mewakili jenis peristiwa yang akan diproses. listener:  EventListener|EventListenerObject Objek yang menerima notifikasi. Ini harus berupa fungsi atau objek dengan metode handleEvent options:  boolean|AddEventListenerOptions optional Lihat opsi. Peristiwa kustom hanya mendukung capture dan passive. Nilai Hasil:  void Menyiapkan fungsi yang akan dipanggil setiap kali peristiwa yang ditentukan dikirim ke target. Lihat addEventListener.
flyCameraAround	flyCameraAround(options) Parameter:  options:  FlyAroundAnimationOptions Nilai Hasil:  Tidak ada Metode ini mengorbitkan kamera di sekitar lokasi tertentu selama durasi tertentu. Animasi dapat diulang sebanyak FlyAroundAnimationOptions.repeatCount kali. Kamera akan bergerak searah 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 FlyAroundAnimationOptions.repeatCount adalah nol, tidak akan ada putaran, dan animasi akan langsung selesai setelah dimulai.
flyCameraTo	flyCameraTo(options) Parameter:  options:  FlyToAnimationOptions Nilai Hasil:  Tidak ada Metode ini menggerakkan kamera secara parabolik dari lokasi saat ini ke lokasi akhir yang ditentukan selama durasi yang ditentukan. Metode ini bersifat asinkron karena animasi hanya dapat dimulai setelah peta dimuat dalam jumlah minimum. Metode ini akan ditampilkan setelah animasi dimulai.
removeEventListener	removeEventListener(type, listener[, options]) Parameter:  type:  string String yang menentukan jenis peristiwa yang pemroses peristiwanya akan dihapus. listener:  EventListener|EventListenerObject Pemroses peristiwa dari pengendali peristiwa yang akan dihapus dari target peristiwa. options:  boolean|EventListenerOptions optional Lihat opsi. Nilai Hasil:  void Menghapus pemroses peristiwa yang sebelumnya didaftarkan dengan addEventListener dari target. Lihat removeEventListener.
stopCameraAnimation	stopCameraAnimation() Parameter:  Tidak ada Nilai Hasil:  Tidak ada Metode ini menghentikan animasi terbang yang mungkin sedang berjalan. Kamera tetap berada di tempatnya di tengah animasi; kamera tidak berteleportasi 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:  animationEndEvent:  Event Peristiwa ini diaktifkan saat animasi terbang berakhir. Peristiwa ini menggelembung melalui hierarki DOM.
gmp-centerchange	function(centerChangeEvent) Argumen:  centerChangeEvent:  Event Peristiwa ini dipicu saat properti pusat Map3DElement berubah.
gmp-click	function(clickEvent) Argumen:  clickEvent:  LocationClickEvent|PlaceClickEvent Peristiwa ini diaktifkan saat elemen Map3DElement diklik.
gmp-error	function(mapInitializationErrorEvent) Argumen:  mapInitializationErrorEvent:  Event Peristiwa ini diaktifkan saat peta gagal diinisialisasi.
gmp-headingchange	function(headingChangeEvent) Argumen:  headingChangeEvent:  Event Peristiwa ini dipicu saat properti heading Map3DElement berubah.
gmp-map-id-error	function(mapIdErrorEvent) Argumen:  mapIdErrorEvent:  Event Peristiwa ini diaktifkan jika properti mapId Map3DElement tidak valid.
gmp-rangechange	function(rangeChangeEvent) Argumen:  rangeChangeEvent:  Event Peristiwa ini dipicu saat properti rentang Map3DElement berubah.
gmp-rollchange	function(rollChangeEvent) Argumen:  rollChangeEvent:  Event Peristiwa ini dipicu saat properti roll Map3DElement berubah.
gmp-steadychange	function(steadyChangeEvent) Argumen:  steadyChangeEvent:  SteadyChangeEvent Peristiwa ini diaktifkan saat status stabil Map3DElement berubah.
gmp-tiltchange	function(tiltChangeEvent) Argumen:  tiltChangeEvent:  Event Peristiwa ini dipicu saat properti kemiringan Map3DElement berubah.

Antarmuka Map3DElementOptions

Antarmuka google.maps.maps3d.Map3DElementOptions

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	Tidak digunakan lagi: Sebagai gantinya, gunakan Map3DElement.defaultUIHidden. Properti ini akan dihapus dalam rilis mendatang. Jenis:  boolean optional Lihat Map3DElement.defaultUIDisabled.
defaultUIHidden optional	Jenis:  boolean optional Lihat Map3DElement.defaultUIHidden.
description optional	Jenis:  string optional Lihat Map3DElement.description.
gestureHandling optional	Jenis:  GestureHandling optional Lihat Map3DElement.gestureHandling.
heading optional	Jenis:  number optional Lihat Map3DElement.heading.
internalUsageAttributionIds optional	Jenis:  Iterable<string> optional Lihat Map3DElement.internalUsageAttributionIds.
language optional	Jenis:  string optional Lihat Map3DElement.language.
mapId optional	Jenis:  string optional Lihat Map3DElement.mapId.
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.
region optional	Jenis:  string optional Lihat Map3DElement.region.
roll optional	Jenis:  number optional Lihat Map3DElement.roll.
tilt optional	Jenis:  number optional Lihat Map3DElement.tilt.

Konstanta MapMode

Konstanta google.maps.maps3d.MapMode

Menentukan mode yang harus digunakan untuk merender peta.

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 pada citra satelit atau fotorealistik.
SATELLITE	Mode peta ini menampilkan citra satelit atau fotorealistik jika tersedia.

Konstanta GestureHandling

Konstanta google.maps.maps3d.GestureHandling

Menentukan cara peristiwa gestur harus ditangani pada elemen peta.

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

Konstanta
AUTO	Hal ini memungkinkan peta memilih apakah akan menggunakan penanganan gestur kooperatif atau greedy. Ini adalah perilaku default jika tidak ditentukan. Hal ini akan menyebabkan peta memasuki mode kooperatif jika peta mendominasi induk scroll-nya (biasanya halaman host) sehingga pengguna tidak dapat men-scroll dari peta ke konten lain.
COOPERATIVE	Tindakan ini akan memaksa mode kooperatif, yang memerlukan tombol pengubah atau gestur dua jari untuk men-scroll peta.
GREEDY	Tindakan ini akan memaksa mode greedy, sehingga halaman host tidak dapat di-scroll dari peristiwa pengguna di elemen peta.

Antarmuka FlyAroundAnimationOptions

Antarmuka google.maps.maps3d.FlyAroundAnimationOptions

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 satu siklus animasi dalam milidetik.
repeatCount optional	Jenis:  number optional Menentukan frekuensi animasi harus diulang. Jika angkanya nol, animasi akan langsung selesai setelah dimulai.
rounds optional	Tidak digunakan lagi: Sebagai gantinya, gunakan FlyAroundAnimationOptions.repeatCount. 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 default.

Antarmuka FlyToAnimationOptions

Antarmuka google.maps.maps3d.FlyToAnimationOptions

Opsi penyesuaian untuk Animasi FlyCameraTo.

Properti
endCamera	Jenis:  CameraOptions Lokasi yang harus ditunjuk kamera di akhir animasi.
durationMillis optional	Jenis:  number optional Durasi animasi dalam milidetik. Durasi 0 akan memindahkan 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.

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.

Class SteadyChangeEvent

Class google.maps.maps3d.SteadyChangeEvent

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

Class LocationClickEvent

Class google.maps.maps3d.LocationClickEvent

Peristiwa ini dibuat dengan 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 ditampilkan akan kurang akurat. Selain itu, elevasi dasar laut dapat ditampilkan untuk nilai ketinggian saat mengklik permukaan air dari posisi kamera yang lebih tinggi. Peristiwa ini menggelembung melalui hierarki DOM.

Class PlaceClickEvent

Class google.maps.maps3d.PlaceClickEvent

Peristiwa ini dibuat dengan mengklik ikon tempat di Map3DElement. Untuk mencegah popover default muncul, panggil metode preventDefault() pada peristiwa ini agar tidak 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 Nilai Hasil:  Promise<Place> Mengambil Place untuk ID tempat ini. Dalam objek Place yang dihasilkan, properti id akan diisi. Kolom tambahan selanjutnya dapat diminta melalui Place.fetchFields(), yang tunduk pada pengaktifan dan penagihan Places API normal. Promise akan ditolak jika terjadi error saat mengambil Place.