Anda sudah siap!

Untuk mulai mengembangkan, masuklah ke dokumentasi developer kami.

Aktifkan Google Maps JavaScript API

Untuk membantu Anda memulai, kami akan memandu Anda melalui Google Developers Console untuk melakukan beberapa hal terlebih dahulu:

  1. Buat atau pilih sebuah proyek
  2. Aktifkan Google Maps JavaScript API dan layanan terkait
  3. Buat kunci yang sesuai
Lanjutkan

Penetapan Versi

Tim Google Maps JavaScript API secara teratur memperbarui API dengan fitur baru, perbaikan bug, dan peningkatan kinerja. Laman ini menjelaskan versi API yang tersedia untuk digunakan dalam aplikasi Anda, baik dalam pengujian maupun lingkungan produksi. Versi API memiliki nama berikut ini:

  • Eksperimental
  • Rilis
  • Beku

Kami juga menyediakan praktik terbaik untuk mengelola prosedur penetapan versi Anda berdasarkan tipe atau kegunaan aplikasi Anda.

Rollover versi dan tipe versi

Setiap triwulan kami memotong versi bernomor yang baru dan merilisnya untuk digunakan oleh umum sebagai versi eksperimental. Pada waktu yang sama, versi eksperimental sebelumnya menjadi versi rilis, dan versi rilis menjadi versi beku. Proses ini disebut pergantian versi.

Sepanjang triwulan kami terus menambah perbaikan bug untuk versi eksperimental dan versi rilis. Pembaruan ini dicatat dalam catatan rilis Google Maps JavaScript API.

Anda bisa menunjukkan versi API yang akan dimuat dalam aplikasi Anda dengan menetapkan parameter v permintaan bootstrap Google Maps JavaScript API. Opsi berikut ini didukung:

  • Versi eksperimental, ditetapkan dengan v=3.exp.
  • Versi rilis, ditetapkan dengan v=3.
  • Nomor versi tertentu. Misalnya v=3.25 atau v=3.26.

Jika Anda tidak secara eksplisit menetapkan versi, Anda secara default akan menerima versi eksperimental jika berada pada standard plan (ini termasuk pelanggan yang tidak memberikan kunci). Jika Anda menggunakan premium plan dan tidak menetapkan versi, Anda secara default akan menerima versi rilis.

Versi eksperimental

Versi eksperimental — saat ini 3.27 — berisi fitur terbaru dan perbaikan bug saat disediakan untuk umum. Perubahan yang dilakukan pada versi eksperimental tidak dijamin berjalan stabil. Kami mendorong Anda agar secara teratur menguji aplikasi dengan versi eksperimental, yang bisa Anda lakukan dengan menambahkan v=3.27 ketika memuat API. Jika menginginkan tantangan, Anda bisa menambahkan v=3.exp untuk selalu menerima versi eksperimental saat ini dengan semua fitur terbaru.

Anda bisa menetapkan versi eksperimental dengan bootstrap berikut ini:

<script async defer
    src="https://maps.googleapis.com/maps/api/js?v=3.exp
        &key=YOUR_API_KEY&callback=initMap">

Versi rilis

Kami terus menerapkan perbaikan bug untuk versi rilis, sambil memastikan rangkaian fitur tetap stabil. Perbaikan dicantumkan dalam daftar catatan rilis.

Versi rilis saat ini adalah 3.26. Anda bisa memintanya dengan salah satu bootstrap berikut:

<script async defer
    src="https://maps.googleapis.com/maps/api/js?v=3
        &key=YOUR_API_KEY&callback=initMap">

<script async defer
    src="https://maps.googleapis.com/maps/api/js?v=3.26
        &key=YOUR_API_KEY&callback=initMap">

Versi beku

Bila merilis sejumlah versi baru, kami menetapkan versi rilis terbaru, yang berarti kami tidak lagi memperbaruinya dengan perbaikan bug secara teratur. Akan tetapi, kami kadang-kadang mungkin membuat perubahan, misalnya jika ada alasan yang sah untuk melakukannya.

Setiap kali kami memperkenalkan versi beku yang baru, kami menghentikan versi beku sebelumnya. Menetapkan versi yang dihentikan, seperti v=3.0, akan selalu mengembalikan versi beku terbaru.

Versi beku saat ini adalah 3.25. Anda bisa memintanya dengan bootstrap berikut:

<script async defer
    src="https://maps.googleapis.com/maps/api/js?v=3.25
        &key=YOUR_API_KEY&callback=initMap">

Praktik terbaik

Tim Google Maps JavaScript API berusaha semaksimal mungkin untuk menjaga kompatibilitas pada berbagai versi API. Namun, agar bisa terus memberikan layanan yang modern, serta karena alasan operasional, kami kadang-kadang membuat perubahan yang mungkin memengaruhi fitur yang ada. Dalam hal demikian mungkin diperlukan, terutama untuk aplikasi yang lebih canggih, melakukan penyesuaian kode menggunakan Google Maps JavaScript API sehingga kode Anda terus bekerja seperti yang diharapkan. Di bawah ini kami menyajikan praktik terbaik yang bagi untuk penggunaan versi, untuk beberapa skenario umum.

Untuk aplikasi yang memiliki ketersediaan tinggi/lalu lintas tinggi

Bersedia melakukan kerja ekstra untuk memastikan stabilitas dan ketersediaan

Untuk memastikan tidak ada masalah yang timbul dari pergantian versi, kami menyarankan Anda agar secara eksplisit menetapkan nomor versi rilis saat ini untuk API dalam bootstrap. Misalnya, v=3.26. Agar API tidak diturunkan ke versi beku seiring berjalannya waktu, maka perlu berlangganan notifikasi pergantian versi dari Google Maps pada grup Notifikasi dan Pengumuman Google Maps JS API v3.

Setelah pergantian versi berlangsung (setiap kuartal), sistem produksi Anda akan meminta API versi beku. Pada saat ini, kami sarankan agar menyiapkan lingkungan staging/development untuk menguji aplikasi Anda dengan API versi rilis yang baru. Jika muncul suatu masalah, Anda bisa membuat penyesuaian yang diperlukan dalam kode Anda. Bila Anda yakin aplikasi berjalan lancar dengan versi rilis baru dari API, Anda bisa mendorong perbaikan yang diperlukan (jika ada) sekaligus memperbarui aplikasi Anda untuk meminta nomor versi yang sesuai dengan versi rilis baru.

Untuk aplikasi biasa

Kami menyarankan Anda menetapkan v=3 dalam permintaan bootstrap. Ini berarti Anda selalu mendapatkan versi rilis terbaru Google Maps JavaScript API yang telah ditujukan untuk lalu lintas volume besar dan telah diterapkan perbaikan bug yang diperlukan. Umumnya Anda berharap tidak ada aksi yang diperlukan saat pergantian versi. Akan tetapi, untuk memastikan aplikasi Anda berfungsi dengan lancar kami menyarankan untuk mendaftar notifikasi pergantian versi dari Google pada grup Notifikasi dan Pengumuman Google Maps JS API v3.

Setelah pergantian dilakukan, aplikasi Anda menggunakan versi baru Google Maps JavaScript API. Anda juga mungkin perlu memeriksa catatan rilis untuk mempelajari perubahan apa saja yang mungkin memengaruhi Anda. Jika menemukan sesuatu dalam aplikasi Anda yang tidak bekerja dengan benar, Anda bisa beralih kembali ke versi lama dengan secara eksplisit menetapkan nomor versi beku saat ini dalam permintaan bootstrap saat membuat penyesuaian yang diperlukan dalam kode Anda.

Untuk aplikasi terbaru

Menginginkan akses lebih dini ke fitur terbaru

Untuk aplikasi yang tidak mementingkan ketersediaan yang konsisten, kami menyarankan Anda mengambil semua fitur terbaru dengan meminta versi eksperimental (v=3.exp) dari Google Maps JavaScript API. Versi eksperimental sudah sepenuhnya diuji oleh Google sebelum dirilis setiap minggu dan biasanya cukup stabil. Akan tetapi, siklus rilis mingguan berarti perlu lebih waspada untuk memastikan aplikasi Anda tetap bekerja seperti yang diharapkan.

Pemeriksaan versi

Untuk debugging, gunakan properti google.maps.version untuk mendapatkan versi Google Maps JavaScript API terkini dalam aplikasi Anda. Contoh kode berikut menulis versi API untuk konsol browser. (Untuk informasi selengkapnya tentang konsol browser, lihat panduan untuk memeriksa kesalahan di browser Anda.)

<!DOCTYPE html>
<html>
  <head>
    <title>Display Google Maps API Version</title>
  </head>
  <body>
    <script>
      function initMap() {
        // Add your map here.
        console.log('Google Maps API version: ' + google.maps.version);
      }
    </script>
    <script src="https://maps.googleapis.com/maps/api/js?YOUR_API_KEY&callback=initMap"
    async defer></script>
  </body>
</html>

Dokumentasi untuk versi API

Panduan developer selalu menjelaskan versi eksperimental.

Selain itu, ada referensi yang dipelihara secara terpisah untuk setiap versi:

Kirim masukan tentang...

Google Maps JavaScript API
Google Maps JavaScript API
Butuh bantuan? Kunjungi halaman dukungan kami.