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, uygulamalarınızda kullanabileceğiniz API sürümleri açıklanmaktadır.

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

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

  • v=weekly ile haftalık kanal belirtilir.
    Bu kanal haftada bir kez güncellenir ve en güncel kanaldır.
  • v=quarterly ile üç aylık kanal belirtilir.
    Bu kanal üç ayda bir güncellenir ve en tahmin edilebilir kanaldır.
  • v=beta ile beta kanalı belirtilir.
    Bu kanal, weekly kanalına dayanır ve haftada bir kez güncellenir. Bu sürümde, erken test ve geri bildirim için ek değişiklikler yer almaktadır.
  • Alfa kanalı, v=alpha ile belirtilir.
    Bu kanal, beta kanalına dayanır ve haftada bir kez güncellenir. Prototipteki 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.62, v=3.61, v=3.60 veya v=3.59 arasından seçim yapabilirsiniz.
    Sürüm numaraları üç ayda bir güncellenir (bkz. Üç aylık güncellemeler).

Bir kanal veya sürüm açıkça belirtilmezse varsayılan olarak haftalık kanalı alırsınız. Premium plandan geçiş yaptıysanız ve bir kanal ya da 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ı alırsınız.

Haftalık kanalı seçme

Çoğu uygulama için haftalık kanalı öneririz. Bu sürüm, en güncel ve en yeni sürümdür. 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>

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

Kasım ayının ortalarında haftalık kanal 3.63 sürümüne güncellenecek. Bu durumda, yeni sürümde desteği sonlandırılan özellikler kaldırılabilir ve/veya geriye dönük uyumsuzluklar ortaya çıkabilir.

Üç 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 sağlanır. Bu uygulamalar, üç aylık kanalı kullanmalıdır. Hata düzeltmelerinin ve performans iyileştirmelerinin beklenen bir zamanda gelmesini 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 kanalın mevcut sürümü 3.61'dir. Bu sürüm, çeyrek boyunca yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri almaz. Zaman zaman bu sürüme güvenlik hata düzeltmeleri ekleyebiliriz.

Kasım ayının ortalarında, üç aylık kanal 3.62 sürümüne güncellenecek. Bu tarihte yeni sürümde yeni özellikler yer alacak, kullanımdan kaldırılan özellikler kaldırılacak ve/veya önceki üç aya ait geriye dönük uyumsuzluklar tanıtılacak.

Beta kanalını seçme

Yeni beta özelliklerini ve değişikliklerini denemek için beta kanalını kullanın. Beta özellikleri tamamlanmıştır ancak bazı çözülmemiş sorunlar olabilir (lütfen sorunları bildirmek ve geri bildirimde bulunmak için Issue Tracker'ı 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 geriye dönük olarak uyumlu olmayabilir.

Bu kanal, weekly kanalına dayanı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 deneysel özellikleri ve değişiklikleri denemek için alfa kanalını kullanın. Lütfen sorunları bildirmek ve geri bildirimde bulunmak için Issue Tracker'ı kullanın. Alfa kanalı, herhangi bir HDS veya kullanımdan kaldırma politikası kapsamında değildir ve bazı değişiklikler önceki sürümlerle geriye dönük olarak uyumlu olmayabilir. Yalnızca geliştirme amaçlıdır ve üretimde kullanılmamalıdır.

Bu kanal, beta kanalına dayanı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ü numarayla belirtin. Bunun nedeni, her çeyrekte yeni sürümler oluşturuldukça numaralandırılmış sürümlerin sonunda 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.61,
  });
  </script>

Şu anda v=3.62, v=3.61, v=3.60 veya v=3.59 değerini belirtebilirsiniz.

  • 3.62 sürümü, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenmektedir.
  • 3.61 sürümü haftalık güncellemeler almıyor.
  • 3.60 sürümü haftalık güncellemeler almıyor.
  • 3.59 sürümü haftalık güncellemeler almıyor.
  • Zaman zaman güvenlik hata düzeltmelerini herhangi bir sürüme dahil edebiliriz.
  • Yeni bir sürüm oluştururken eski sürümlerle uyumsuz değişiklikler yapabiliriz.

Kasım ayının ortasından sonra v=3.63, v=3.62, v=3.61 veya v=3.60 değerini belirtebileceksiniz.

  • 3.63 sürümü; yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alacak.
  • 3.62 sürümü artık haftalık güncellemeler almayacak.
  • 3.61 sürümü artık haftalık güncellemeler almayacak.
  • 3.60 sürümü artık haftalık güncellemeler almayacak.
  • Zaman zaman güvenlik hata düzeltmelerini herhangi bir sürüme dahil edebiliriz.
  • 3.59 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, önümüzdeki yıl boyunca her kanalda hangi sürümlerin kullanılabileceği gösterilmektedir.

v=weekly v=quarterly v=3.nn v=3.nn-1 Aug 2025 Nov 2025 Feb 2026 May 2026 v3.59 v3.60 v3.60 v3.61 v3.61 v3.61 v3.62 v3.62 v3.62 v3.62 v3.63 v3.63 v3.63 v3.64 v3.64 v3.65

Bir güncelleme uygulamamı etkiledi

Yayın kanallarını güncellediğimizde bu durum uygulamanızı etkileyebilir. Bu durum, uygulamanızın belgelenmemiş veya desteği sonlandırılmış özelliklere dayanmasından ya da bizim eklediğimiz 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.62.2" ise komut dosyası etiketinizde v=3.61 kullanın.
    Bu geçici çözüm yalnızca sınırlı bir süre için geçerli olacaktır.

Geçici çözüm uygulandıktan sonra, uygulamanızı güncellemek için genellikle 3 ila 6 ay süren bir zamanınız olur. Bu süre içinde, uygulamanızın artık belgelenmemiş veya desteği sonlandırılmış özellikleri kullanmadığından ve hataları ya da hata düzeltmelerini hesaba kattığından emin olmanız gerekir.

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

Ayrıca destek kaydı oluşturabilir veya sorun bildirebilirsiniz.

Üç aylık güncellemeler

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

Haftalık kanal güncellemesi

Haftalık kanal şu anda 3.62 sürümünü işaret ediyor.

Kasım ayının ortalarında, haftalık kanal 3.62 sürümünden 3.63 sürümüne güncellenecek. Bu noktada yeni sürümde yeni özellikler yer alacak, desteği sonlandırılan özellikler kaldırılacak ve/veya geriye dönük uyumsuzluklar ortaya çıkacak. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Yeni sürüm, çeyrek boyunca her hafta yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle güncellenecek. Kullanımdan kaldırılan özellikler kaldırılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.

Üç aylık kanal güncellemesi

Üç aylık kanal şu anda 3.61 sürümünü işaret ediyor.

Kasım ayının ortalarında, üç aylık kanal 3.61 sürümünden 3.62 sürümüne güncellenecek. Güncelleme yapıldığında bu sürümde yeni özellikler yer alır, kullanımdan kaldırılan özellikler kaldırılır ve/veya önceki üç aya göre geriye dönük uyumsuzluklar ortaya çıkar. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Bu sürüm, çeyrek boyunca yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri içermeyecek. Kullanımdan kaldırılan özellikler kaldırılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.

Sürüm güncellemeleri

Kasım ayının ortalarında, yeni bir sürümün yayınlanması için sürüm numaraları değişir.

Sürüm 3.63

Kasım ayının ortalarında yeni bir sürüm (3.63) yayınlanacak. Bu sürüm yayınlandığında yeni özellikler içerecek, kullanımdan kaldırılan özellikleri kaldıracak ve/veya 3.62 sürümüne kıyasla geriye dönük uyumsuzluklar sunacaktır. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Yeni sürüm, çeyrek boyunca her hafta yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle güncellenecektir. Kullanımdan kaldırılan özellikler kaldırılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.

Sürüm 3.62

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

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

Sürüm 3.61

Bu sürümde yeni özellikler eklenir, kullanımdan kaldırılan özellikler kaldırılır ve/veya 3.60 sürümüne kıyasla geriye dönük uyumsuzluklar sunulur. 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 kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük olarak uyumsuzluklara neden olmaz.

Sürüm 3.60

Bu sürümde yeni özellikler eklenir, kullanımdan kaldırılan özellikler kaldırılır ve/veya 3.59 sürümüne kıyasla geriye dönük uyumsuzluklar sunulur. 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 kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük olarak uyumsuzluklara neden olmaz.

Sürüm 3.59

Bu sürüm, Kasım ayı ortasından sonra silinecek ve 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.

Sürüm desteği

Her üç aylık dönemde dört sürüm kullanılabilir. Bu dört sürümün tümü desteklenir.

Sürüm kontrolleri

Hata ayıklama için google.maps.version özelliğini kullanarak uygulamanızdaki Maps JavaScript API'nin mevcut sürümünü edinin. 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ılavuzuna bakın.)

<!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ümlerinin belgeleri

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

Ayrıca, her sürüm için ayrı olarak tutulan bir referans vardır: