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 seminggu sekali, 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.
  • Saluran alfa ditetapkan dengan v=alpha.
    Saluran ini didasarkan pada saluran beta, dan diupdate sekali per minggu. Saluran ini mencakup eksperimen untuk masukan pelanggan tentang prototipe. Saluran ini hanya ditujukan untuk pengembangan dan tidak boleh digunakan dalam produksi.
  • Nomor versi ditetapkan dengan v=n.nn.
    Anda dapat memilih v=3.59, v=3.58, v=3.57 atau v=3.56.
    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 paket premium 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>
    (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
      key: "YOUR_API_KEY",
      v: "weekly",
    });
  </script>

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

Pada pertengahan bulan Februari, saluran mingguan akan diupdate ke versi 3.60. Pada saat itu, versi baru mungkin akan 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 hal ini memberikan prediktabilitas yang lebih besar. Aplikasi ini harus menggunakan saluran kuartalan. Gunakan pendekatan ini jika Anda ingin perbaikan bug dan peningkatan performa tersedia pada waktu yang diharapkan (lihat update kuartalan). Anda dapat menetapkan saluran kuartalan dengan memuat Maps JavaScript API menggunakan tag skrip berikut:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "quarterly",
  });
  </script>

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

Pada pertengahan bulan Februari, saluran per kuartal akan diupdate ke versi 3.59. Pada saat itu, versi baru akan menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menerapkan 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 per minggu.

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
  });
  </script>

Memilih saluran alfa

Gunakan saluran alfa untuk mencoba fitur dan perubahan eksperimental baru. Gunakan Issue Tracker untuk melaporkan masalah dan memberikan masukan. Saluran alfa tidak tercakup dalam SLA atau kebijakan penghentian layanan, dan beberapa perubahan mungkin tidak kompatibel dengan rilis sebelumnya. Saluran ini hanya ditujukan untuk pengembangan dan tidak boleh digunakan dalam produksi.

Saluran ini didasarkan pada saluran beta, dan diupdate sekali per minggu.

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "alpha",
  });
  </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>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: 3.58,
  });
  </script>

Saat ini, Anda dapat menentukan v=3.59, v=3.58, v=3.57, atau v=3.56.

  • Versi 3.59 akan diupdate setiap minggu dengan fitur baru, perbaikan bug, dan peningkatan performa.
  • Versi 3.58 tidak akan diupdate setiap minggu.
  • Versi 3.57 tidak akan diupdate setiap minggu.
  • Versi 3.56 tidak akan diupdate setiap minggu.
  • Kami dapat menyediakan perbaikan bug keamanan pada semua versi dari waktu ke waktu.
  • Kami dapat menerapkan perubahan inkompatibilitas mundur saat membuat versi baru.

Setelah pertengahan bulan Februari, Anda dapat menentukan v=3.60, v=3.59, v=3.58, atau v=3.57.

  • Versi 3.60 akan diupdate setiap minggu dengan fitur baru, perbaikan bug, dan peningkatan performa.
  • Versi 3.59 tidak akan lagi menerima update mingguan.
  • Versi 3.58 tidak akan lagi menerima update mingguan.
  • Versi 3.57 tidak akan lagi diupdate setiap minggu.
  • Kami dapat menyediakan perbaikan bug keamanan pada semua versi dari waktu ke waktu.
  • Versi 3.56 tidak akan tersedia lagi. Setiap percobaan untuk memuat versi ini akan diabaikan, dan Anda akan menerima saluran default sebagai gantinya.

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

v=weekly v=quarterly v=3.nn v=3.nn-1 Nov 2024 Feb 2025 May 2025 Aug 2025 v3.56 v3.57 v3.57 v3.58 v3.58 v3.58 v3.59 v3.59 v3.59 v3.59 v3.60 v3.60 v3.60 v3.61 v3.61 v3.62

Update berdampak pada aplikasi saya

Update yang kami lakukan pada saluran rilis dapat berdampak pada aplikasi Anda. Hal ini dapat terjadi karena aplikasi Anda mengandalkan fitur yang tidak terdokumentasi atau tidak digunakan lagi, atau karena terkena bug atau mendapatkan perbaikan bug yang kami sediakan.

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. Perbarui tag skrip yang memuat API, dan minta nomor versi yang lebih lama.
    Misalnya, jika google.maps.version adalah "3.59.2", gunakan v=3.58 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 Anda, sehingga aplikasi ini tidak lagi mengandalkan fitur yang tidak terdokumentasi atau tidak digunakan lagi, dan mengatasi bug yang muncul atau menerapkan perbaikan bug yang disediakan.

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 Februari. Saluran mingguan yang baru akan menyediakan versi 3.60, dan pada saat itu saluran lain akan diupdate.

Update saluran mingguan

Saluran mingguan saat ini mengarah ke versi 3.59.

Pada pertengahan bulan Februari, saluran mingguan akan diupdate dari versi 3.59 ke versi 3.60. 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 kuartalan

Saluran kuartalan saat ini mengarah ke versi 3.58.

Pada pertengahan bulan Februari, saluran per kuartal akan diupdate dari versi 3.58 ke versi 3.59. 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 Februari, nomor versi masih akan kompatibel dengan versi terakhir untuk mengakomodasi rilis versi baru.

Versi 3.60

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

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.

Versi 3.59

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

Setelah pertengahan bulan Februari, 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.58

Versi ini menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menerapkan inkompatibilitas mundur dibandingkan dengan versi 3.57. Anda harus menguji aplikasi setiap kali berganti nomor 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.57

Versi ini menyertakan fitur baru, menghapus fitur yang tidak digunakan lagi, dan/atau menerapkan inkompatibilitas mundur dibandingkan dengan versi 3.56. Anda harus menguji aplikasi setiap kali berganti nomor 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.56

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