Otomatis menyesuaikan kamera dengan elemen peta

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, dan FLY_TO akan 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:

  • center dan range: 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 menggunakan center dan range yang dikonfigurasi sebagai pengganti.
  • tilt dan heading: Diperlakukan sebagai nilai yang disarankan selama framing. Jika dihilangkan, keduanya ditetapkan secara default ke 0° untuk tampilan vertikal, utara-atas.
  • roll dan fov: Dipertahankan seperti yang dikonfigurasi di Map3DElement.
  • Elemen turunan asinkron: Sebelum merender tampilan awal, Map3DElement menunggu turunan asinkron yang diikutsertakan seperti <gmp-route-3d> untuk menyelesaikan pemuatan geometri rute.
  • Pembatasan peta dan kamera: Batas geografis bounds dan kamera (minAltitude, maxAltitude, minTilt, maxTilt, minHeading, dan maxHeading) masih membatasi tampilan yang disesuaikan secara otomatis. Untuk mengetahui informasi selengkapnya, lihat Membatasi tampilan dan batas kamera.

Langkah berikutnya