Pembuatan Versi

Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Tim Maps JavaScript API secara rutin mengupdate API dengan fitur baru, perbaikan bug, dan peningkatan performa. Halaman ini menjelaskan versi API yang tersedia untuk digunakan dalam aplikasi Anda.

Saluran rilis dan nomor versi

Dalam aplikasi, Anda dapat menentukan saluran rilis atau nomor versi:

  • Saluran mingguan ditetapkan dengan v=weekly.
    Saluran ini diupdate sekali seminggu, dan merupakan yang terbaru.
  • Saluran kuartalan ditetapkan dengan v=quarterly.
    Saluran ini diupdate sekali per kuartal, dan paling mudah diprediksi.
  • Saluran beta ditetapkan dengan v=beta.
    Saluran ini didasarkan pada saluran weekly, dan diupdate sekali per minggu. Saluran menyertakan perubahan tambahan untuk masukan dan pengujian awal.
  • Nomor versi ditetapkan dengan v=n.nn.
    Anda dapat memilih v=3.51, v=3.50, v=3.49 atau v=3.48.
    Nomor versi diupdate satu kali per kuartal (lihat Update kuartalan).

Jika Anda tidak menetapkan saluran atau versi secara eksplisit, Anda akan menerima saluran mingguan secara default. Jika Anda bermigrasi dari premium plan dan tidak secara eksplisit menetapkan saluran atau versi, Anda akan menerima saluran kuartalan secara default. Jika Anda menentukan versi yang tidak valid, Anda akan menerima saluran default.

Memilih saluran mingguan

Untuk sebagian besar aplikasi, kami merekomendasikan saluran mingguan. Ini adalah versi terbaru serta berisi perbaikan bug dan peningkatan performa terbaru. Anda dapat menetapkan saluran mingguan dengan memuat Maps JavaScript API dengan menggunakan tag skrip berikut:

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

Saat ini, saluran mingguan adalah versi 3.51. Versi ini diupdate setiap minggu dengan fitur baru, perbaikan bug, dan peningkatan performa.

Pada pertengahan Februari, saluran mingguan akan diperbarui ke versi 3.52. Pada saat itu, versi baru dapat menghapus fitur yang tidak digunakan lagi, dan/atau menyebabkan inkompatibilitas mundur.

Memilih saluran kuartalan

Beberapa aplikasi mungkin mendapatkan manfaat dari update yang lebih sedikit tetapi lebih besar, karena ini memberikan prediktabilitas yang lebih besar. Aplikasi ini harus menggunakan saluran kuartalan. Gunakan pendekatan ini jika Anda menginginkan perbaikan bug dan peningkatan performa tiba pada waktu yang diharapkan (lihat update kuartalan). Anda dapat menetapkan saluran kuartalan dengan memuat Maps JavaScript API dengan menggunakan tag skrip berikut:

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

Saat ini, saluran triwulanan adalah versi 3.50. Selama kuartal ini, versi ini tidak menerima fitur baru, perbaikan bug, atau peningkatan performa. Dari waktu ke waktu, kami dapat memasukkan perbaikan bug keamanan ke dalam versi ini.

Pada pertengahan Februari, saluran per kuartal akan diupdate ke versi 3.51. Pada saat itu, versi baru akan menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau memperkenalkan inkompatibilitas mundur dari tiga bulan sebelumnya.

Memilih saluran beta

Gunakan saluran beta untuk mencoba fitur dan perubahan beta yang baru. Fitur versi beta sudah memiliki fitur lengkap, tetapi mungkin memiliki beberapa masalah yang belum terselesaikan (gunakan Issue Tracker untuk melaporkan masalah dan memberikan masukan). Saluran beta tidak tercakup dalam SLA atau kebijakan penghentian layanan, dan beberapa perubahan mungkin tidak kompatibel dengan rilis sebelumnya.

Saluran ini didasarkan pada saluran weekly, dan diupdate sekali seminggu.

Anda dapat menetapkan saluran beta dengan memuat Maps JavaScript API menggunakan tag skrip berikut:

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

Memilih nomor versi

Tetapkan versi berdasarkan nomor hanya jika Anda rutin menguji dan mengupdate aplikasi. Hal ini karena versi bernomor pada akhirnya dihapus saat versi baru dibuat setiap tiga bulan. Anda dapat menentukan nomor versi dengan memuat Maps JavaScript API menggunakan tag skrip berikut:

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

Saat ini, Anda dapat menentukan v=3.51, v=3.50, v=3.49, atau v=3.48.

  • Versi 3.51 menerima update mingguan dengan fitur baru, perbaikan bug, dan peningkatan performa.
  • Versi 3.50 tidak menerima update mingguan.
  • Versi 3.49 tidak menerima update mingguan.
  • Versi 3.48 tidak menerima update mingguan.
  • Dari waktu ke waktu, kami dapat memasukkan perbaikan bug keamanan ke dalam versi ini.
  • Kami mungkin memperkenalkan perubahan yang tidak kompatibel dengan versi sebelumnya saat membuat versi baru.

Setelah pertengahan Februari, Anda dapat menentukan v=3.52, v=3.51, v=3.50, atau v=3.49.

  • Versi 3.52 akan menerima update mingguan dengan fitur baru, perbaikan bug, dan peningkatan performa.
  • Versi 3.51 tidak akan lagi menerima update mingguan.
  • Versi 3.50 tidak akan lagi menerima update mingguan.
  • Versi 3.49 tidak akan lagi menerima update mingguan.
  • Dari waktu ke waktu, kami dapat memasukkan perbaikan bug keamanan ke dalam versi ini.
  • Versi 3.48 tidak akan tersedia lagi. Setiap upaya untuk memuat versi ini akan diabaikan, dan Anda akan menerima saluran default.

Diagram di bawah menunjukkan versi yang akan tersedia di setiap saluran tahun depan.

Update berdampak pada aplikasi saya

Mengupdate saluran rilis dapat berdampak pada aplikasi Anda. Hal ini bisa terjadi karena aplikasi Anda mengandalkan fitur yang tidak terdokumentasi atau tidak digunakan lagi, atau karena bug atau perbaikan bug yang kami perkenalkan.

Sebagai solusi sementara, Anda dapat mengonfigurasi ulang aplikasi agar menggunakan versi yang lebih lama.

  1. Buka konsol di alat developer browser Anda, dan lihat nilai google.maps.version.
  2. Update tag skrip yang memuat API, dan minta nomor versi yang lebih lama.
    Misalnya, jika google.maps.version adalah "3.51.2", gunakan v=3.50 di tag skrip Anda.
    Solusi sementara ini hanya akan berfungsi untuk waktu terbatas.

Setelah solusi sementara diterapkan, Anda akan memiliki waktu (biasanya 3 hingga 6 bulan) untuk mengupdate aplikasi, sehingga tidak lagi menggunakan fitur yang tidak terdokumentasi atau tidak digunakan lagi, dan mempertimbangkan bug atau perbaikan bug.

Anda harus kembali ke tag skrip awal untuk memuat API tersebut.

Anda juga dapat membuat kasus dukungan atau melaporkan masalah.

Update kuartalan

Tim Maps JavaScript API merilis versi baru sekali per kuartal. Ini terjadi pada pertengahan Februari, pertengahan Mei, pertengahan Agustus, dan pertengahan November. Update berikutnya akan berlangsung pada pertengahan Februari. Saluran mingguan baru akan menyediakan versi 3.52, dan pada saat itu saluran lain akan diperbarui.

Update saluran mingguan

Saluran mingguan saat ini menunjuk ke versi 3.51.

Pada pertengahan Februari, saluran mingguan akan diperbarui dari versi 3.51 ke versi 3.52. Pada tahap ini, versi baru akan menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menimbulkan inkompatibilitas mundur. Anda mungkin perlu menguji perubahan ini saat saluran diupdate.

Selama kuartal ini, versi baru akan diupdate setiap minggu dengan fitur baru, perbaikan bug, dan peningkatan performa. API ini tidak akan menghapus fitur yang tidak digunakan lagi dan tidak akan menyebabkan inkompatibilitas mundur.

Update saluran kuartalan

Saluran per kuartal saat ini mengarah ke versi 3.50.

Pada pertengahan Februari, saluran per kuartal akan diupdate dari versi 3.50 ke versi 3.51. Setelah diupdate, versi ini akan menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menimbulkan inkompatibilitas mundur dari tiga bulan sebelumnya. Anda mungkin perlu menguji perubahan ini saat saluran diupdate.

Selama kuartal ini, versi ini tidak akan menyertakan fitur baru, perbaikan bug, atau peningkatan performa. API ini tidak akan menghapus fitur yang tidak digunakan lagi dan tidak akan menyebabkan inkompatibilitas mundur.

Update versi

Pada pertengahan Februari, nomor versi akan meluncur untuk mengakomodasi rilis versi baru.

Versi 3.52

Versi baru 3.52 akan dirilis pada pertengahan Februari. Setelah dirilis, versi ini akan menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau memperkenalkan inkompatibilitas mundur dibandingkan dengan versi 3.51. Anda harus menguji aplikasi saat berganti di antara nomor versi.

Selama kuartal ini, versi baru akan diupdate setiap minggu dengan fitur baru, perbaikan bug, dan peningkatan performa. API ini tidak akan menghapus fitur yang tidak digunakan lagi dan tidak akan menyebabkan inkompatibilitas mundur.

Versi 3.51

Versi ini mencakup fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau memperkenalkan inkompatibilitas mundur dibandingkan dengan versi 3.50. Anda harus menguji aplikasi saat berganti di antara nomor versi.

Setelah pertengahan Februari, versi ini tidak lagi diupdate dengan fitur baru, perbaikan bug, atau peningkatan performa. API ini tidak akan menghapus fitur yang tidak digunakan lagi dan tidak akan menyebabkan inkompatibilitas mundur.

Versi 3.50

Versi ini mencakup fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menyebabkan inkompatibilitas mundur dibandingkan dengan versi 3.49. Anda harus menguji aplikasi saat berganti di antara nomor versi.

Versi ini tidak lagi diupdate dengan fitur baru, perbaikan bug, atau peningkatan performa. API ini tidak akan menghapus fitur yang tidak digunakan lagi setelah versi ini dan tidak akan menyebabkan inkompatibilitas mundur baru.

Versi 3.49

Versi ini mencakup fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menyebabkan inkompatibilitas mundur dibandingkan dengan versi 3.48. Anda harus menguji aplikasi saat berganti di antara nomor versi.

Versi ini tidak lagi diupdate dengan fitur baru, perbaikan bug, atau peningkatan performa. API ini tidak akan menghapus fitur yang tidak digunakan lagi setelah versi ini dan tidak akan menyebabkan inkompatibilitas mundur baru.

Versi 3.48

Setelah pertengahan Februari, versi ini akan dihapus, dan tidak dapat digunakan lagi. Setiap upaya untuk memuat versi ini akan diabaikan, dan Anda akan menerima saluran default.

Dukungan versi

Dalam kuartal tertentu, empat versi tersedia. Keempat versi tersebut didukung.

Pemeriksaan versi

Untuk proses debug, gunakan properti google.maps.version untuk mendapatkan versi Maps JavaScript API saat ini dalam aplikasi Anda. Contoh kode berikut menulis versi API untuk konsol browser. (Untuk informasi selengkapnya tentang konsol browser, lihat panduan untuk memeriksa error pada browser.)

<!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?key=YOUR_API_KEY&callback=initMap"
    defer></script>
  </body>
</html>

Dokumentasi untuk versi API

Panduan developer selalu menjelaskan versi mingguan.

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