Pembuatan Versi

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 per minggu, dan merupakan yang terbaru.
Saluran per kuartal 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.52, v=3.51, v=3.50 atau v=3.49.
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 menggunakan tag skrip berikut:

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

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

Pada pertengahan bulan Mei, saluran mingguan akan diupdate ke versi 3.53. Pada saat itu, versi baru dapat menghapus fitur yang tidak digunakan lagi, dan/atau menerapkan 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 dilakukan pada waktu yang diharapkan (lihat update per kuartal). Anda dapat menetapkan saluran per kuartal dengan memuat Maps JavaScript API menggunakan tag skrip berikut:

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

Versi saluran per kuartal saat ini adalah versi 3.51. Selama kuartal ini, versi ini tidak diupdate dengan fitur baru, perbaikan bug, atau peningkatan performa. Kami dapat melakukan perbaikan bug keamanan pada versi ini dari waktu ke waktu.

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

Pada awal bulan Mei, sebaiknya uji aplikasi Anda menggunakan v=3.52.

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 akan dihapus saat versi baru dibuat setiap kuartal. 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.51
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

Versi 3.52 akan diupdate setiap minggu dengan fitur baru, perbaikan bug, dan peningkatan performa.
Versi 3.51 tidak akan diupdate setiap minggu.
Versi 3.50 tidak akan diupdate setiap minggu.
Versi 3.49 tidak akan diupdate setiap minggu.
Kami dapat melakukan perbaikan bug keamanan pada semua versi dari waktu ke waktu.
Kami dapat menerapkan perubahan inkompatibilitas mundur saat membuat versi baru.

Setelah pertengahan bulan Mei, Anda dapat menentukan v=3.53, v=3.52, v=3.51, atau v=3.50.

Versi 3.53 akan diupdate setiap minggu dengan fitur baru, perbaikan bug, dan peningkatan performa.
Versi 3.52 tidak akan lagi diupdate setiap minggu.
Versi 3.51 tidak akan lagi diupdate setiap minggu.
Versi 3.50 tidak akan lagi diupdate setiap minggu.
Kami dapat melakukan perbaikan bug keamanan pada semua versi dari waktu ke waktu.
Versi 3.49 tidak akan tersedia lagi. Setiap upaya untuk memuat versi ini akan diabaikan, dan Anda akan menerima saluran default sebagai gantinya.

Jika Anda menggunakan v=3.50 atau v=3.49, sebaiknya upgrade aplikasi Anda ke v=3.52 atau v=3.51 sebelum pertengahan bulan Mei. Saat beralih versi, ingat bahwa versi yang lebih baru dapat menghapus fitur yang tidak digunakan lagi, dan/atau menyebabkan inkompatibilitas mundur.

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

Update berdampak pada aplikasi saya

Update yang kami lakukan pada 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.

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

Setelah solusi sementara diterapkan, Anda akan memiliki waktu (biasanya 3 hingga 6 bulan) untuk mengupdate aplikasi, sehingga aplikasi tidak lagi menggunakan fitur yang tidak tercatat atau tidak digunakan lagi, dan menyelesaikan 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. Update ini akan terjadi pada pertengahan bulan Februari, pertengahan bulan Mei, pertengahan bulan Agustus, dan pertengahan bulan November. Update berikutnya akan dilakukan pada pertengahan bulan Mei. Saluran mingguan baru akan menyediakan versi 3.53, dan pada saat itu saluran lain akan diupdate.

Update saluran mingguan

Saluran mingguan saat ini mengarah ke versi 3.52.

Pada pertengahan bulan Mei, saluran mingguan akan diupdate dari versi 3.52 ke versi 3.53. Pada tahap ini, versi baru akan menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menerapkan 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. Versi ini tidak akan menghapus fitur yang tidak digunakan lagi dan tidak akan menerapkan inkompatibilitas mundur.

Update saluran per kuartal

Saluran per kuartal saat ini mengarah ke versi 3.51.

Pada pertengahan bulan Mei, saluran per kuartal akan diupdate dari versi 3.51 ke versi 3.52. Setelah diupdate, versi ini akan menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menerapkan 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. Versi ini tidak akan menghapus fitur yang tidak digunakan lagi dan tidak akan menerapkan inkompatibilitas mundur.

Update versi

Pada pertengahan bulan Mei, nomor versi masih akan kompatibel dengan versi terakhir untuk mengakomodasi rilis versi baru.

Versi 3.53

Versi baru, yaitu versi 3.53, akan dirilis pada pertengahan bulan Mei. Setelah dirilis, versi ini akan menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menyebabkan inkompatibilitas mundur dibandingkan dengan versi 3.52. Anda harus menguji aplikasi setiap kali berganti versi.

Versi 3.52

Versi ini menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menerapkan inkompatibilitas mundur dibandingkan dengan versi 3.51. Anda harus menguji aplikasi setiap kali berganti versi.

Setelah pertengahan bulan Mei, versi ini tidak akan lagi diupdate dengan fitur baru, perbaikan bug, atau peningkatan performa. Versi ini tidak akan menghapus fitur yang tidak digunakan lagi dan tidak akan menerapkan inkompatibilitas mundur.

Versi 3.51

Versi ini menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menerapkan inkompatibilitas mundur dibandingkan dengan versi 3.50. Anda harus menguji aplikasi setiap kali berganti versi.

Versi ini tidak lagi diupdate dengan fitur baru, perbaikan bug, atau peningkatan performa. Versi ini tidak akan menghapus fitur yang tidak digunakan lagi di versi yang lebih baru dari versi ini dan tidak akan menerapkan inkompatibilitas mundur baru.

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 setiap kali berganti versi.

Versi 3.49

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

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 dikelola secara terpisah untuk setiap versi:

Referensi API Versi 3.52 (saluran mingguan)
Referensi API Versi 3.51 (saluran per kuartal)
Referensi API Versi 3.50
Referensi API Versi 3.49
Versi 3.0 hingga 3.48 telah dihapus.