Sürüm oluşturma

Maps JavaScript API ekibi, API'yi düzenli olarak yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle günceller. Bu sayfada, API'nin uygulamalarınızda kullanılabilen sürümleri açıklanmaktadır.

Sürüm kanalları ve sürüm numaraları

Uygulamanızda sürüm kanallarını veya sürüm numaralarını belirtebilirsiniz:

  • Haftalık kanal, v=weekly ile belirtilir.
    Bu kanal haftada bir kez güncellenir ve en güncel bilgilere sahiptir.
  • Üç aylık kanal, v=quarterly ile belirtilir.
    Bu kanal üç ayda bir güncellenir ve en tahmin edilebilir olanıdır.
  • Beta kanalı, v=beta ile belirtilir.
    Bu kanal, weekly kanalını temel alır ve haftada bir kez güncellenir. Erken test ve geri bildirim için ek değişiklikler içerir.
  • Alfa kanalı, v=alpha ile belirtilir.
    Bu kanal, beta kanalını temel alır ve haftada bir kez güncellenir. Prototiplerle ilgili müşteri geri bildirimleri için denemeler içerir. Yalnızca geliştirme amaçlıdır ve üretimde kullanılmamalıdır.
  • Sürüm numarası, v=n.nn ile belirtilir.
    v=3.58, v=3.57, v=3.56 veya v=3.55 seçeneklerinden birini belirleyebilirsiniz.
    Sürüm numaraları üç ayda bir güncellenir (Üç aylık güncellemeler bölümüne bakın).

Belirli bir kanal veya sürüm belirtmezseniz varsayılan olarak haftalık kanal bildirimini alırsınız. Premium plandan geçiş yaptıysanız ve açıkça bir kanal veya sürüm belirtmediyseniz varsayılan olarak üç aylık kanalı alırsınız. Geçersiz bir sürüm belirtirseniz varsayılan kanalınız gösterilir.

Haftalık kanalı seçme

Çoğu uygulama için haftalık kanalı öneririz. Bu, en güncel sürümdür ve en son hata düzeltmelerini ve performans iyileştirmelerini içerir. Maps JavaScript API'yi aşağıdaki komut dosyası etiketiyle yükleyerek haftalık kanalı belirtebilirsiniz:

  <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>
  

Haftalık kanalın şu anki sürümü 3.58'dir. Bu sürüm, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenir.

Haftalık kanal, Kasım ayının ortalarında 3.59 sürümüne güncellenecek. Bu süre zarfında yeni sürüm, desteği sonlandırılan özellikleri kaldırabilir ve/veya geriye dönük uyumsuzluklara neden olabilir.

Üç aylık kanalı seçme

Bazı uygulamalar, daha az sayıda ancak daha büyük güncellemelerden yararlanabilir. Bu sayede daha fazla öngörülebilirlik elde edilir. Bu uygulamalar üç aylık kanalı kullanmalıdır. Hata düzeltmelerinin ve performans iyileştirmelerinin beklenen zamanda yayınlanmasını istiyorsanız bu yaklaşımı kullanın (üç aylık güncellemeler bölümüne bakın). Maps JavaScript API'yi aşağıdaki komut dosyası etiketiyle yükleyerek üç aylık kanalı belirtebilirsiniz:

  <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>

Üç aylık kanalda şu anda 3.57 sürümü kullanılmaktadır. Bu sürüm, üç aylık süre boyunca yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri almaz. Zaman zaman bu sürüme güvenlik hatası düzeltmeleri eklenebilir.

Üç aylık kanal, Kasım ayının ortasında 3.58 sürümüne güncellenecek. Bu süre zarfında yeni sürüm yeni özellikler içerecek, desteği sonlandırılan özellikleri kaldıracak ve/veya önceki üç aya ait geriye dönük uyumsuzluklarla ilgili değişiklikler yapacaktır.

Beta kanalını seçme

Yeni beta özellikleri ve değişiklikleri denemek için beta kanalını kullanın. Beta özellikleri eksiksizdir ancak bazı sorunları olabilir (sorunları bildirmek ve geri bildirimde bulunmak için lütfen Sorun Takip Aracı'nı kullanın). Beta kanalı herhangi bir HDS veya kullanımdan kaldırma politikasının kapsamına girmez ve bazı değişiklikler önceki sürümlerle uyumlu olmayabilir.

Bu kanal, weekly kanalını temel alır ve haftada bir kez güncellenir.

Maps JavaScript API'yi aşağıdaki komut dosyası etiketiyle yükleyerek beta kanalını belirtebilirsiniz:

  <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>

Alfa kanalını seçme

Yeni denesel özellikleri ve değişiklikleri denemek için alfa kanalını kullanın. Sorunları bildirmek ve geri bildirimde bulunmak için lütfen Sorun Takip Aracı'nı kullanın. Alfa kanalı herhangi bir HDS veya kullanımdan kaldırma politikasının kapsamına girmez ve bazı değişiklikler önceki sürümlerle uyumlu olmayabilir. Yalnızca geliştirme amaçlıdır ve üretimde kullanılmamalıdır.

Bu kanal, beta kanalını temel alır ve haftada bir kez güncellenir.

Maps JavaScript API'yi aşağıdaki komut dosyası etiketiyle yükleyerek alfa kanalını belirtebilirsiniz:

  <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>

Sürüm numarası seçme

Yalnızca uygulamanızı düzenli olarak test edip güncelliyorsanız sürüm numarasını belirtin. Bunun nedeni, her üç ayda bir yeni sürümler oluşturulduğundan, numaralandırılmış sürümlerin zaman içinde silinmesidir. Maps JavaScript API'yi aşağıdaki komut dosyası etiketiyle yükleyerek sürüm numarasını belirtebilirsiniz:

  <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.57,
  });
  </script>

Şu anda v=3.58, v=3.57, v=3.56 veya v=3.55 değerini belirtebilirsiniz.

  • 3.58 sürümü, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alır.
  • 3.57 sürümü haftalık güncelleme almaz.
  • 3.56 sürümü haftalık güncelleme almaz.
  • 3.55 sürümü haftalık güncelleme almıyor.
  • Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmeleri ekleyebiliyoruz.
  • Yeni bir sürüm oluştururken eski sürümlerle uyumlu olmayan değişiklikler yapabiliriz.

Kasım ayının ortasından sonra v=3.59, v=3.58, v=3.57 veya v=3.56 değerini belirtebilirsiniz.

  • 3.59 sürümü, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alır.
  • 3.58 sürümü artık haftalık güncelleme almayacak.
  • 3.57 sürümü artık haftalık güncelleme almayacak.
  • 3.56 sürümü artık haftalık güncelleme almayacak.
  • Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmeleri ekleyebiliyoruz.
  • 3.55 sürümü artık kullanılamayacak. Bu sürümü yükleme girişimleri göz ardı edilir ve bunun yerine varsayılan kanalınız gösterilir.

Aşağıdaki şemada, gelecek yıl her kanalda hangi sürümlerin kullanılabileceği gösterilmektedir.

v=weekly v=quarterly v=3.nn v=3.nn-1 Ağustos 2024 Kasım 2024 Şubat 2025 Mayıs 2025 v3.55 v3.56 v3.56 v3.57 v3.57 v3.57 v3.58 v3.58 v3.58 v3.58 v3.59 v3.59 v3.59 v3.60 v3.60 v3.61

Bir güncelleme başvurumu etkiledi

Sürüm kanallarını güncellediğimizde uygulamanız etkilenebilir. Bu durum, uygulamanızın dokümanları olmayan veya desteği sonlandırılmış özelliklere dayalı olmasından ya da sunduğumuz bir hata veya hata düzeltmesinden kaynaklanabilir.

Geçici bir geçici çözüm olarak, uygulamanızı eski bir sürümü kullanacak şekilde yeniden yapılandırabilirsiniz.

  1. Tarayıcınızın geliştirici araçlarında konsolu açın ve google.maps.version değerine bakın.
  2. API'yi yükleyen komut dosyası etiketini güncelleyin ve daha eski bir sürüm numarası isteyin.
    Örneğin, google.maps.version "3.58.2" ise komut dosyası etiketinizde v=3.57 kullanın.
    Bu geçici çözüm yalnızca sınırlı bir süre boyunca geçerli olacaktır.

Geçici geçici çözüm uygulandıktan sonra, uygulamanızı güncelleyerek artık belgelenmemiş veya desteği sonlandırılmış özellikleri kullanmamasını ve hataları ya da hata düzeltmelerini hesaba katmasını sağlamak için zamanınız (genellikle 3 ila 6 ay) olur.

Ardından, API'yi yüklemek için orijinal komut dosyası etiketine geri dönmeniz gerekir.

Dilerseniz destek kaydı oluşturabilir veya sorun bildirebilirsiniz.

Üç aylık güncellemeler

Maps JavaScript API ekibi üç ayda bir yeni bir sürüm yayınlar. Bu işlem Şubat, Mayıs, Ağustos ve Kasım ayının ortasında gerçekleşir. Bir sonraki güncelleme Kasım ayının ortasında yapılacaktır. Yeni haftalık kanalda 3.59 sürümü sunulur ve bu sırada diğer kanallar da güncellenir.

Haftalık kanal güncellemesi

Haftalık kanal şu anda 3.58 sürümünü gösteriyor.

Haftalık kanal, Kasım ayının ortalarında 3.58 sürümünden 3.59 sürümüne güncellenecek. Bu noktada yeni sürüm yeni özellikler içerir, desteği sonlandırılan özellikleri kaldırır ve/veya geriye dönük uyumsuzluklar sunar. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Yeni sürüm, üç aylık süre boyunca yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenecektir. Desteği sonlandırılan özellikler kaldırılmayacak ve geriye dönük uyumsuzluklara neden olmayacak.

Üç aylık kanal güncellemesi

Üç aylık kanal şu anda 3.57 sürümünü gösteriyor.

Üç aylık kanal, Kasım ayının ortasında 3.57 sürümünden 3.58 sürümüne güncellenecek. Güncelleme sonrasında bu sürüm yeni özellikler içerecek, desteği sonlandırılan özellikleri kaldıracak ve/veya önceki üç aydan itibaren geriye dönük uyumsuzluklara neden olacaktır. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Bu sürüm, üç aylık süre boyunca yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri içermeyecek. Desteği sonlandırılan özellikler kaldırılmayacak ve geriye dönük uyumsuzluklara neden olmayacak.

Sürüm güncellemeleri

Kasım ayının ortasında, sürüm numaraları yeni bir sürümün kullanıma sunulması için sıfırlanır.

Sürüm 3.59

Kasım ayının ortasında 3.59 sürümü kullanıma sunulacak. Bu sürüm, yayınlandığında yeni özellikler içerecek, desteği sonlandırılan özellikleri kaldıracak ve/veya 3.58 sürümüne kıyasla geriye dönük uyumsuzluklara neden olacaktır. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Yeni sürüm, üç aylık süre boyunca yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenecektir. Desteği sonlandırılan özellikler kaldırılmayacak ve geriye dönük uyumsuzluklara neden olmayacak.

Sürüm 3.58

Bu sürüm yeni özellikler içerir, desteği sonlandırılan özellikleri kaldırır ve/veya 3.57 sürümüne kıyasla geriye dönük uyumsuzluklara neden olur. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Kasım ayının ortasından sonra bu sürüm yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleriyle güncellenmeyecektir. Desteği sonlandırılan özellikler kaldırılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.

Sürüm 3.57

Bu sürümde yeni özellikler yer alır, desteği sonlandırılan özellikler kaldırılır ve/veya 3.56 sürümüne kıyasla geriye dönük uyumsuzluklar bulunur. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Bu sürüm artık yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleriyle güncellenmeyecek. Bu sürümden sonra desteği sonlandırılan özellikler kaldırılmaz ve geriye dönük uyumsuzluk oluşturacak yeni özellikler eklenmez.

3.56 sürümü

Bu sürüm yeni özellikler içerir, desteği sonlandırılan özellikleri kaldırır ve/veya 3.55 sürümüne kıyasla geriye dönük uyumsuzluklara neden olur. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Bu sürüm artık yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleriyle güncellenmeyecek. Bu sürümden sonra desteği sonlandırılan özellikler kaldırılmaz ve geriye dönük uyumsuzluklara neden olacak yeni özellikler eklenmez.

Sürüm 3.55

Kasım ayının ortasından sonra bu sürüm silinecek ve kullanılamayacak. Bu sürümü yükleme girişimleri göz ardı edilir ve bunun yerine varsayılan kanalınız gösterilir.

Sürüm desteği

Her üç ayda bir dört sürüm kullanılabilir. Bu sürümlerin dördü de desteklenir.

Sürüm kontrolleri

Hata ayıklama için uygulamanızda Maps JavaScript API'nin geçerli sürümünü almak üzere google.maps.version mülkünü kullanın. Aşağıdaki kod örneği, API sürümünü tarayıcı konsoluna yazar. (Tarayıcı konsolu hakkında daha fazla bilgi için tarayıcınızdaki hataları kontrol etme kılavuzunu inceleyin.)

<!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>

API sürümleriyle ilgili belgeler

Geliştirici kılavuzunda her zaman haftalık sürüm açıklanır.

Ayrıca her sürüm için ayrı olarak yönetilen bir referans vardır: