Pembuatan Versi

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.

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.