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.59
,v=3.58
,v=3.57
veyav=3.56
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.59'dur. Bu sürüm, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenir.
Haftalık kanal, Şubat ayının ortasında 3.60 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 mevcut sürümü 3.58'dir. 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, Şubat ayının ortasında 3.59 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.58, }); </script>
Şu anda 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ü haftalık güncelleme almıyor.
- 3.57 sürümü haftalık güncelleme almaz.
- 3.56 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.
Şubat ayının ortasından sonra 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ü artık haftalık güncelleme almayacak.
- 3.58 sürümü artık haftalık güncelleme almayacak.
- 3.57 sürümü artık haftalık güncelleme almayacak.
- Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmeleri ekleyebiliyoruz.
- 3.56 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.
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.
- 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.59.2" ise komut dosyası etiketinizdev=3.58
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 şubat ayının ortasında yapılacaktır. Yeni haftalık kanalda 3.60 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.59 sürümünü gösteriyor.
Haftalık kanal, Şubat ayının ortasında 3.59 sürümünden 3.60 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ılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.
Üç aylık kanal güncellemesi
Üç aylık kanal şu anda 3.58 sürümünü gösteriyor.
Üç aylık kanal, Şubat ayının ortasında 3.58 sürümünden 3.59 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ılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.
Sürüm güncellemeleri
Şubat ayının ortasında, sürüm numaraları yeni bir sürümün kullanıma sunulması için sıfırlanır.
3.60 sürümü
Şubat ayının ortasında 3.60 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.59 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.
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ı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.
Şubat 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.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.
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.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ü
Şubat 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.59 Sürüm API Referansı (haftalık kanal)
- 3.58 Sürümü API Referansı (üç aylık kanal)
- 3.57 Sürümü API Referansı
- 3.56 Sürüm API Referansı
- 3.0 ile 3.55 arasındaki sürümler silindi.