Anda dapat otomatis membingkai penanda, polyline, poligon, dan rute 3D dalam area pandang <gmp-map-3d> dengan menetapkan atribut HTML autofits-camera atau properti autofitsCamera pada elemen turunan yang didukung. Jika satu atau
beberapa elemen turunan diikutsertakan, peta akan menghitung posisi kamera yang membuat semua
elemen yang diikutsertakan tetap terlihat.
Penyesuaian kamera otomatis tersedia di saluran v=beta Maps JavaScript API. Untuk mengetahui petunjuk tentang cara memuat saluran beta,
lihat Pembuatan versi.
Elemen yang didukung
Tabel berikut mencantumkan elemen turunan Map3DElement yang
mendukung autofits-camera (autofitsCamera):
| elemen HTML | Class JavaScript | Koleksi | Catatan |
|---|---|---|---|
<gmp-marker-3d>, <gmp-marker-3d-interactive> |
Marker3DElement,
Marker3DInteractiveElement
|
maps3d |
Membingkai position penanda. |
<gmp-marker>, <gmp-marker-interactive> |
MarkerElement,
MarkerInteractiveElement
|
maps3d |
Membingkai position penanda. |
<gmp-polyline-3d>, <gmp-polyline-3d-interactive> |
Polyline3DElement,
Polyline3DInteractiveElement
|
maps3d |
Membingkai semua koordinat dalam path polyline. |
<gmp-polygon-3d>, <gmp-polygon-3d-interactive> |
Polygon3DElement,
Polygon3DInteractiveElement
|
maps3d |
Membingkai semua koordinat dalam path poligon. |
<gmp-route-3d> |
Route3DElement
|
routes |
Menunggu permintaan rute diselesaikan, lalu membingkai jalur rute. |
Elemen yang tidak didukung
Model3DElement,
PopoverElement,
dan
FlattenerElement
tidak mendukung autofitsCamera. Untuk membingkai elemen tersebut, tetapkan
center dan range di
<gmp-map-3d> atau panggil flyCameraTo.
Menyesuaikan kamera pada pemuatan awal
Untuk membingkai elemen saat peta dimuat, tambahkan atribut autofits-camera ke
setiap elemen turunan yang Anda inginkan di dalam area tampilan awal. Anda tidak perlu
menghitung center atau range di <gmp-map-3d>:
<gmp-map-3d
style="height: 400px; width: 100%;"
mode="hybrid">
<gmp-marker-3d
position="47.6205,-122.3493"
title="Space Needle"
autofits-camera>
</gmp-marker-3d>
<gmp-marker-3d
position="47.6097,-122.3425"
title="Pike Place Market"
autofits-camera>
</gmp-marker-3d>
<gmp-polyline-3d
path="47.6205,-122.3493,0 47.6097,-122.3425,0"
stroke-color="#4285F4"
stroke-width="8"
altitude-mode="clamp-to-ground"
autofits-camera>
</gmp-polyline-3d>
</gmp-map-3d>
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&libraries=maps3d">
</script>
Ganti YOUR_API_KEY dengan kunci API Google Maps Platform Anda.
Menyesuaikan dan menganimasikan update dinamis
Saat Anda menambahkan elemen yang diikutsertakan setelah pemuatan awal, memperbarui koordinat atau
titik akhir rutenya, atau menetapkan autofitsCamera ke true, peta akan menghitung ulang
kamera untuk membingkai semua elemen yang diikutsertakan. Menghapus elemen atau menetapkan
autofitsCamera ke false akan membiarkan kamera pada posisinya dan mengecualikan elemen
tersebut dari update mendatang.
Untuk mengontrol apakah pembaruan dinamis akan langsung ditampilkan atau dianimasikan, tetapkan
autofitsCameraAnimation (autofits-camera-animation) di
Map3DElement ke nilai AutofitsCameraAnimation:
AutofitsCameraAnimation.NONE("none", default): Menyesuaikan ke posisi yang diperbarui tanpa animasi.AutofitsCameraAnimation.FLY_TO("fly-to"): Bergerak dengan mulus ke posisi yang diperbarui. Pemuatan peta awal akan langsung beralih tanpa animasi, danFLY_TOakan kembali ke peralihan langsung saat sistem operasi pengguna meminta pengurangan gerakan.
Untuk mengonfigurasi autofitsCamera dan AutofitsCameraAnimation.FLY_TO
secara terprogram, lihat contoh berikut:
<div id="map-container" style="height: 400px; width: 100%;"></div>
<script>
async function initMap() {
const {
AutofitsCameraAnimation,
Map3DElement,
Marker3DElement,
MapMode,
} = await google.maps.importLibrary('maps3d');
const map = new Map3DElement({
mode: MapMode.HYBRID,
autofitsCameraAnimation: AutofitsCameraAnimation.FLY_TO,
});
document.getElementById('map-container').append(map);
const originMarker = new Marker3DElement({
position: { lat: 37.7955, lng: -122.3937 },
autofitsCamera: true,
});
map.append(originMarker);
/* Adding a second opted-in marker flies the camera to frame both. */
const destinationMarker = new Marker3DElement({
position: { lat: 37.8080, lng: -122.4177 },
autofitsCamera: true,
});
map.append(destinationMarker);
}
</script>
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&v=beta&loading=async&callback=initMap">
</script>
Ganti YOUR_API_KEY dengan kunci API Google Maps Platform Anda.
Cara properti dan batasan kamera berinteraksi
Jika setidaknya satu elemen turunan memilih ikut serta dengan autofits-camera, Map3DElement
akan menggabungkan konfigurasi peta Anda dengan batas yang dihitung sesuai dengan
aturan berikut:
centerdanrange: Diganti oleh pembingkaian yang dihitung, yang menambahkan padding rentang 20% dan menerapkan rentang minimum 80 m. Jika tidak ada elemen turunan yang diikutsertakan yang memberikan koordinat, peta akan menggunakancenterdanrangeyang dikonfigurasi sebagai pengganti.tiltdanheading: Diperlakukan sebagai nilai yang disarankan selama framing. Jika dihilangkan, keduanya ditetapkan secara default ke0°untuk tampilan vertikal, utara-atas.rolldanfov: Dipertahankan seperti yang dikonfigurasi diMap3DElement.- Elemen turunan asinkron: Sebelum merender tampilan awal,
Map3DElementmenunggu turunan asinkron yang diikutsertakan seperti<gmp-route-3d>untuk menyelesaikan pemuatan geometri rute. - Pembatasan peta dan kamera: Batas geografis
boundsdan kamera (minAltitude,maxAltitude,minTilt,maxTilt,minHeading, danmaxHeading) masih membatasi tampilan yang disesuaikan secara otomatis. Untuk mengetahui informasi selengkapnya, lihat Membatasi tampilan dan batas kamera.