Bu sayfa, Cloud Translation API ile çevrilmiştir.

Sürüm oluşturma
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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.60, v=3.59, v=3.58 veya v=3.57 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ı 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.60'tır. Bu sürüm, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenir.

Haftalık kanal, Mayıs ayı ortalarında 3.61 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 kanalın şu anki sürümü 3.59'dur. 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, Mayıs ayının ortasında 3.60 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 uyumsuzluklar sunacaktır.

Mayıs ayının başlarında, v=3.60'ü kullanarak uygulamanızı test etmenizi öneririz.

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

Şu anda v=3.60, v=3.59, v=3.58 veya v=3.57 değerini belirtebilirsiniz.

3.60 sürümü, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alır.
3.59 sürümü haftalık güncelleme almaz.
3.58 sürümü haftalık güncelleme almıyor.
3.57 sürümü haftalık güncelleme almaz.
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.

Mayıs ayının ortasından sonra v=3.61, v=3.60, v=3.59 veya v=3.58 değerini belirtebilirsiniz.

3.61 sürümü, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alır.
3.60 sürümü artık haftalık güncelleme almayacak.
3.59 sürümü artık haftalık güncelleme almayacak.
3.58 sürümü artık haftalık güncelleme almayacak.
Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmeleri ekleyebiliyoruz.
3.57 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.

v=3.58 veya v=3.57 sürümünü kullanıyorsanız Mayıs ayının ortasından önce v=3.60 veya v=3.59 sürümüne yükseltmenizi öneririz. Sürüm değiştirirken, yeni sürümlerin desteği sonlandırılmış özellikleri kaldırabileceğini ve/veya geriye dönük uyumsuzluklara neden olabileceğini unutmayın.

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

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 kullanıma 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.

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

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) olacaktır.

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 Mayıs ayının ortasında yapılacak. Yeni haftalık kanalda 3.61 sürümü sağlanacak ve bu sırada diğer kanallar da güncellenecek.

Haftalık kanal güncellemesi

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

Haftalık kanal, Mayıs ayının ortasında 3.60 sürümünden 3.61 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.59 sürümünü gösteriyor.

Üç aylık kanal, Mayıs ayı ortalarında 3.59 sürümünden 3.60 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

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

3.61 sürümü

Mayıs ayının ortasında yeni 3.61 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.60 sürümüne kıyasla geriye dönük uyumsuzluklara neden olacak. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

3.60 sürümü

Bu sürüm yeni özellikler içerir, desteği sonlandırılan özellikleri kaldırır ve/veya 3.59 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.

Mayıs 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.59

Bu sürüm yeni özellikler içerir, desteği sonlandırılan özellikleri kaldırır ve/veya 3.58 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.

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.

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.

Sürüm 3.57

Mayıs ayının ortasından sonra bu sürüm 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 üç 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:

3.60 sürümü API referansı (haftalık kanal)
3.59 Sürümü API Referansı (üç aylık kanal)
3.58 Sürümü API Referansı
3.57 Sürümü API Referansı
3.0 ile 3.56 arasındaki sürümler silindi.

Sürüm oluşturma Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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

Haftalık kanalı seçme

Üç aylık kanalı seçme

Beta kanalını seçme

Alfa kanalını seçme

Sürüm numarası seçme

Bir güncelleme başvurumu etkiledi

Üç aylık güncellemeler

Haftalık kanal güncellemesi

Üç aylık kanal güncellemesi

Sürüm güncellemeleri

3.61 sürümü

3.60 sürümü

Sürüm 3.59

Sürüm 3.58

Sürüm 3.57

Sürüm desteği

Sürüm kontrolleri

API sürümleriyle ilgili belgeler

Sürüm oluşturma
Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.