Sürüm oluşturma

Maps JavaScript API ekibi, API'yi yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle düzenli olarak 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 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 kanaldır.
  • Üç aylık kanal, v=quarterly ile belirtilir.
    Bu kanal üç ayda bir güncellenir ve en öngörülebilir kanaldı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. Prototip aşamasındaki ürünlerle ilgili müşteri geri bildirimlerini toplamak 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.66, v=3.65, v=3.64 veya v=3.63 seçeneklerinden birini belirleyebilirsiniz.
    Sürüm numaraları üç ayda bir güncellenir (Üç aylık güncellemeler bölümüne bakın).

Açıkça bir kanal veya sürüm belirtmezseniz varsayılan olarak haftalık kanalı alırsınız. Premium plan'dan 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ı alırsınız.

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üzeltmeleri ile 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.66'dır. Bu sürüm her hafta yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle güncellenir.

Kasım ayının ortasında haftalık kanal 3.67 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 fazla öngörülebilirlik sağladığı için daha az sayıda ancak daha büyük güncellemelerden yararlanabilir. 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üncellemelere 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>

Şu anda üç aylık kanalın sürümü 3.65'tir. Bu sürüm, ilgili çeyrek boyunca yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri almaz. Zaman zaman bu sürüme güvenlik hatası düzeltmeleri ekleyebiliriz.

Kasım ayının ortalarında üç aylık kanal 3.66 sürümüne güncellenecek. Bu tarihte yeni sürüm, yeni özellikler içerecek, desteği sonlandırılan özellikleri kaldıracak ve/veya önceki üç ayın geriye dönük uyumsuzluklarını sunacak.

Beta kanalını seçme

Yeni beta özelliklerini ve değişiklikleri denemek için beta kanalını kullanın. Beta özellikler, özellik açısından tamamlanmıştır ancak bazı sorunlar olabilir (sorunları bildirmek ve geri bildirimde bulunmak için lütfen Issue Tracker'ı kullanın). Beta 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 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 deneysel özellikleri ve değişiklikleri denemek için alfa kanalını kullanın. Sorunları bildirmek ve geri bildirimde bulunmak için lütfen 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 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ü numaraya göre belirtin. Bunun nedeni, her üç ayda bir yeni sürümler oluşturuldukça numaralı sürümlerin 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.65,
  });
  </script>

Şu anda v=3.66, v=3.65, v=3.64 veya v=3.63 değerlerini belirtebilirsiniz.

  • 3.66 sürümü; yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alıyor.
  • 3.65 sürümü haftalık güncellemeleri almıyor.
  • 3.64 sürümü haftalık güncellemeleri almıyor.
  • 3.63 sürümü haftalık güncellemeleri almıyor.
  • Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmeleri ekleyebiliriz.
  • Yeni bir sürüm oluştururken geriye dönük uyumsuz değişiklikler yapabiliriz.

Kasım ayının ortasından sonra v=3.67, v=3.66, v=3.65 veya v=3.64 değerlerini belirtebileceksiniz.

  • 3.67 sürümü; yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alacak.
  • 3.66 sürümü artık haftalık güncellemeler almayacak.
  • 3.65 sürümü artık haftalık güncellemeler almayacak.
  • 3.64 sürümü artık haftalık güncellemeleri almayacak.
  • Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmeleri ekleyebiliriz.
  • 3.63 sürümü artık kullanılamayacak. Bu sürümü yükleme girişimleri yok sayılır ve bunun yerine varsayılan kanalınızı alırsınız.

Aşağıdaki şemada, önümüzdeki 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 2026 Kasım 2026 Şubat 2027 Mayıs 2027 v3.63 v3.64 v3.64 v3.65 v3.65 v3.65 v3.66 v3.66 v3.66 v3.66 v3.67 v3.67 v3.67 v3.68 v3.68 v3.69

Bir güncelleme uygulamamı etkiledi

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

Geçici bir çö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 eski bir sürüm numarası isteyin.
    Örneğin, google.maps.version "3.66.2" ise komut dosyası etiketinizde v=3.65 kullanın.
    Bu geçici çözüm yalnızca sınırlı bir süre için geçerlidir.

Geçici çözüm uygulandıktan sonra uygulamanızı güncellemek için zamanınız (genellikle 3 ila 6 ay) olur. Böylece uygulamanız artık belgelenmemiş veya desteği sonlandırılmış özellikleri kullanmaz ve hataları ya da hata düzeltmelerini hesaba katar.

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 her üç ayda bir yeni bir sürüm yayınlar. Bu işlem Şubat, Mayıs, Ağustos ve Kasım aylarının ortasında yapılır. Bir sonraki güncelleme Kasım ayının ortasında yapılacak. Yeni haftalık kanal 3.67 sürümünü sunacak ve diğer kanallar da o sırada güncellenecek.

Haftalık kanal güncellemesi

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

Kasım ayının ortasında, haftalık kanal 3.66 sürümünden 3.67 sürümüne güncellenecek. Bu noktada yeni sürüm, yeni özellikler içerecek, desteği sonlandırılan özellikleri kaldıracak ve/veya geriye dönük uyumsuzluklar getirecektir. 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. Desteği sonlandı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.65 sürümünü işaret ediyor.

Kasım ayının ortasında, üç aylık kanal 3.65 sürümünden 3.66 sürümüne güncellenecek. Güncelleme yapıldığında bu sürüm yeni özellikler içerecek, desteği sonlandırılan özellikleri kaldıracak ve/veya önceki üç aya ait geriye dönük uyumsuzlukları sunacak. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Çeyrek boyunca bu sürümde yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri olmayacak. Desteği sonlandırılan özellikler kaldırılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.

Sürüm güncellemeleri

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

Sürüm 3.67

Kasım ayının ortasında 3.67 adlı yeni bir sürüm yayınlanacak. Bu sürüm yayınlandığında yeni özellikler içerecek, desteği sonlandırılan özellikleri kaldıracak ve/veya 3.66 sürümüne kıyasla geriye dönük uyumsuzluklar içerecek. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Yeni sürüm, üç aylık dönem boyunca her hafta yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle güncellenecek. Desteği sonlandırılan özellikler kaldırılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.

Sürüm 3.66

Bu sürüm, yeni özellikler içerir, desteği sonlandırılan özellikleri kaldırır ve/veya 3.65 sürümüne kıyasla geriye dönük uyumsuzluklar sunar. 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üncellenmeyecek. Desteği sonlandırılan özellikler kaldırılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.

Sürüm 3.65

Bu sürüm, 3.64 sürümüne kıyasla yeni özellikler içerir, desteği sonlandırılan özellikleri kaldırır ve/veya geriye dönük uyumsuzluklar sunar. 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 özellikleri kaldırmaz ve geriye dönük yeni uyumsuzluklar getirmez.

Sürüm 3.64

Bu sürüm, 3.63 sürümüne kıyasla yeni özellikler içerir, desteği sonlandırılan özellikleri kaldırır ve/veya geriye dönük uyumsuzluklar sunar. 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 özellikleri kaldırmaz ve yeni geriye dönük uyumsuzluklar getirmez.

Sürüm 3.63

Kasım ayı ortasından sonra bu sürüm silinecek ve artık kullanılamayacak. Bu sürümü yükleme girişimleri yok sayılır ve bunun yerine varsayılan kanalınızı alırsınız.

Sürüm desteği

Herhangi bir üç aylık dönemde dört sürüm kullanılabilir. Bu sürümlerin dördü de 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ü öğrenin. 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ümleriyle ilgili belgeler

Geliştirici kılavuzu her zaman haftalık sürümü açıklar.

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