Ringkasan

Fitur dengan teknologi WebGL untuk Maps JavaScript API memungkinkan Anda mengontrol kemiringan dan rotasi, menambahkan objek 3D langsung ke peta, dan lainnya. Fitur berikut tercakup di dalamnya:

Mulai

Untuk menggunakan fitur WebGL baru, Anda harus menggunakan peta vektor. Bagian ini menunjukkan caranya.

Tentukan opsi renderingType

Gunakan opsi renderingType untuk menentukan jenis rendering raster atau vektor untuk peta Anda (tidak memerlukan ID peta):

  1. Muat library RenderingType; hal ini dapat dilakukan saat memuat library Maps:

    const { Map, RenderingType } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary;
    
  2. Saat menginisialisasi peta, gunakan opsi renderingType untuk menentukan RenderingType.VECTOR atau RenderingType.RASTER:

    map = new Map(
      document.getElementById('map') as HTMLElement,
      {
        zoom: 4,
        center: position,
        renderingType: RenderingType.VECTOR,
      }
    );
    

Opsi renderingType menggantikan setelan jenis rendering yang dibuat dengan mengonfigurasi ID peta.

  • Untuk mengaktifkan kemiringan dan rotasi, tetapkan opsi peta tiltInteractionEnabled ke benar (true) atau panggil map.setTiltInteractionEnabled.
  • Untuk mengaktifkan penggeseran, tetapkan opsi peta headingInteractionEnabled ke true atau panggil map.setHeadingInteractionEnabled.

Menggunakan ID peta untuk menetapkan jenis rendering

Anda juga dapat menentukan jenis rendering menggunakan ID peta. Untuk membuat ID peta baru, ikuti langkah-langkah di Menggunakan Gaya Visual Peta Berbasis Cloud - Dapatkan ID peta. Pastikan untuk menetapkan Jenis peta ke JavaScript, lalu pilih opsi Vector. Centang Tilt atau Rotation untuk mengaktifkan kemiringan dan rotasi pada peta. Dengan melakukannya, Anda dapat menyesuaikan nilai ini secara terprogram, dan juga memungkinkan pengguna menyesuaikan kemiringan dan arah secara langsung di peta. Jika penggunaan kemiringan atau arah akan berdampak buruk pada aplikasi Anda, biarkan Tilt dan Rotation tidak dicentang agar pengguna tidak dapat menyesuaikan kemiringan dan rotasi.

Membuat ID Peta Vektor

Selanjutnya, perbarui kode inisialisasi peta Anda dengan ID peta yang Anda buat. Anda dapat menemukan ID peta di halaman Pengelolaan Peta. Berikan ID peta saat Anda membuat instance peta menggunakan properti mapId seperti yang ditunjukkan di sini:

map = new google.maps.Map(document.getElementById('map'), {
  center: {lat: -34.397, lng: 150.644},
  zoom: 8,
  mapId: 'MAP_ID'
});

Menggunakan elemen <gmp-map>

Peta vektor, kemiringan, dan arah diaktifkan secara default saat menggunakan elemen <gmp-map>, yang memungkinkan Anda menambahkan peta ke halaman menggunakan HTML. Pelajari lebih lanjut.

Contoh

Contoh telah diberikan untuk mendemonstrasikan fitur berikut: