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 kullanılabilen 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 güncellenmektedir ve en güncel kanaldır. - Üç aylık kanal,
v=quarterly
ile belirtilir.
Bu kanal üç ayda bir güncellenir ve en tahmin edilebilir kanaldır. - Beta kanalı
v=beta
ile belirtilir.weekly
adlı kanalı temel alan bu kanal haftada bir kez güncellenir. Erken test ve geri bildirimler için ek değişiklikler içerir. - Alfa kanalı,
v=alpha
ile belirtilir.beta
adlı kanalı temel alan bu kanal haftada bir kez güncellenir. Bu bölümde, prototiplerle ilgili müşteri geri bildirimlerine yönelik denemeler yer alır. 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.54
,v=3.53
,v=3.52
veyav=3.51
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 plandan geçiş yaptıysanız ve bir kanal ya da sürüm açık bir şekilde 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 önerilir. Bu, en güncel ve güncel sürümdür, en son hata düzeltmelerini ve performans iyileştirmelerini içerir. Haritalar JavaScript API'sini aşağıdaki komut dosyası etiketiyle yükleyerek haftalık kanalı belirtebilirsiniz:
<script async
src="https://maps.googleapis.com/maps/api/js?v=weekly
&key=YOUR_API_KEY&callback=initMap">
</script>
Şu anda haftalık kanal sürüm 3.54'tür. Bu sürüm yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenir.
Kasım ayının ortasında, haftalık kanal 3.55 sürümüne güncellenecektir. Bu sırada yeni sürüm, kullanımdan kaldırılan özellikleri kaldırabilir ve/veya geriye dönük uyumsuzluklar başlatabilir.
Üç aylık kanalı seçme
Bazı uygulamalar daha iyi tahmin edilebilirlik sağladığından daha az ancak daha büyük güncellemelerden yararlanabilir. Bu başvurular üç aylık kanalı kullanmalıdır. Hata düzeltmelerinin ve performans iyileştirmelerinin beklenen bir zamanda ulaşmasını istiyorsanız bu yaklaşımı kullanın (üç aylık güncellemelere bakın). Haritalar JavaScript API'sini aşağıdaki komut dosyası etiketiyle yükleyerek üç aylık kanalı belirtebilirsiniz:
<script async
src="https://maps.googleapis.com/maps/api/js?v=quarterly
&key=YOUR_API_KEY&callback=initMap">
</script>
Üç aylık kanal sürümü şu anda 3.53'tür. Üç aylık dönem boyunca bu sürüm yeni özellikleri, hata düzeltmelerini veya performans iyileştirmelerini almaz. Zaman zaman bu sürümde güvenlik hatası düzeltmeleri sunabiliriz.
Kasım ayının ortasında, üç aylık kanal 3.54 sürümüne güncellenecektir. Bu aşamada yeni sürüm yeni özellikler içerecek, kullanımdan kaldırılan özellikleri kaldıracak ve/veya önceki üç aya yönelik geriye dönük uyumsuzluklar başlatacaktır.
Beta kanalını seçme
Yeni beta özellikleri ve değişiklikleri denemek için beta kanalını kullanın. Beta özellikleri tamdır ancak bazı önemli sorunları olabilir (sorunları bildirmek ve geri bildirimde bulunmak için lütfen Sorun İzleyici'yi kullanın). Beta kanalı, herhangi bir HDS veya kullanımdan kaldırma politikasının kapsamında değildir ve bazı değişiklikler önceki sürümlerle geriye dönük uyumlu olmayabilir.
weekly
kanalına dayanan bu kanal haftada bir kez güncellenir.
Maps JavaScript API'yi aşağıdaki komut dosyası etiketiyle yükleyerek beta kanalını belirtebilirsiniz:
<script async
src="https://maps.googleapis.com/maps/api/js?v=beta
&key=YOUR_API_KEY&callback=initMap">
</script>
Alfa kanalı 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 Sorun İzleyici'yi kullanın. Alfa kanalı, herhangi bir HDS veya kullanımdan kaldırma politikasının 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.
beta
kanalına dayanan bu kanal haftada bir kez güncellenir.
Alfa kanalını, Maps JavaScript API'yi aşağıdaki komut dosyası etiketiyle yükleyerek belirtebilirsiniz:
<script async
src="https://maps.googleapis.com/maps/api/js?v=alpha
&key=YOUR_API_KEY&callback=initMap">
</script>
Sürüm numarası seçme
Yalnızca uygulamanızı düzenli olarak test edip güncellerseniz sürüme göre bir sürüm belirtin. Bunun nedeni, her üç ayda bir yeni sürümler oluşturulduğunda numaralı sürümlerin silineceğidir. Maps JavaScript API'yi aşağıdaki komut dosyası etiketiyle yükleyerek sürüm numarasını belirleyebilirsiniz:
<script async
src="https://maps.googleapis.com/maps/api/js?v=3.53
&key=YOUR_API_KEY&callback=initMap">
</script>
Şu anda v=3.54
, v=3.53
, v=3.52
veya v=3.51
belirtebilirsiniz.
- Sürüm 3.54 yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alıyor.
- 3.53 sürümü haftalık güncellemeler almıyor.
- Sürüm 3.52, haftalık güncelleme almıyor.
- 3.51 sürümü haftalık güncellemeler almıyor.
- Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmeleri sunabiliriz.
- Yeni bir sürüm oluştururken eski sürümlerle uyumsuz olan değişiklikler yayınlayabiliriz.
Kasım ayının ortalarından sonra v=3.55
, v=3.54
, v=3.53
veya v=3.52
değerini belirtebileceksiniz.
- Sürüm 3.55 yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alır.
- Sürüm 3.54 artık haftalık güncellemeleri almayacaktır.
- Sürüm 3.53 artık haftalık güncellemeleri almayacaktır.
- Sürüm 3.52 artık haftalık güncellemeleri almayacaktır.
- Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmeleri sunabiliriz.
- Sürüm 3.51 artık kullanılamayacak. Bu sürümü yüklemek için yapılan tüm girişimler yok sayılır ve onun 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.
Uygulamamı etkileyen bir güncelleme var
Sürüm kanallarını güncellememiz başvurunuzu etkileyebilir. Bu durum, uygulamanızın belgelenmemiş veya kullanımdan kaldırılmış özelliklerden yararlanmasından ya da kullanıma sunduğumuz bir hata veya hata düzeltmesinden kaynaklanıyor olabilir.
Geçici bir çözüm olarak, uygulamanızı eski bir sürüm kullanacak şekilde yeniden yapılandırabilirsiniz.
- Tarayıcınızdaki geliştirici araçlarında konsolu açıp
google.maps.version
'in 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.54.2" ise komut dosyası etiketinizdev=3.53
kullanın.
Bu geçici çözüm yalnızca sınırlı bir süre için kullanılabilir.
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 kullanımdan kaldırılan özellikleri kullanmaz ve hataları ya da hata düzeltmelerini hesaba katar.
Daha sonra 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
Her üç ayda bir Haritalar JavaScript API ekibi yeni bir sürüm yayınlar. Bu durum, Şubat ayının ortasında, Mayıs ayının ortasında, Ağustos ayının ortasında ve Kasım ayının ortasında gerçekleşir. Bir sonraki güncelleme Kasım ayının ortalarında yapılacaktır. Yeni haftalık kanalda 3.55 sürümü sunulacak ve o zaman diğer kanallar güncellenecek.
Haftalık kanal güncellemesi
Haftalık kanal şu anda 3.54 sürümünü işaret etmektedir.
Kasım ayının ortasında, haftalık kanal 3.54 sürümünden 3.55 sürümüne güncellenecektir. Bu aşamada, yeni sürüm yeni özellikler içerecek, kullanımdan kaldırılan özellikleri kaldıracak ve/veya geriye dönük uyumsuzluklar sağlayacaktır. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.
Bu üç aylık dönem boyunca yeni sürüm, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenecektir. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzluklar yaratmaz.
Üç aylık kanal güncellemesi
Üç aylık kanal şu anda 3.53 sürümüne işaret etmektedir.
Kasım ayının ortasında, üç aylık kanal 3.53 sürümünden 3.54 sürümüne güncellenecektir. Güncellemeden sonra bu sürüm yeni özellikler içerecek, kullanımdan kaldırılan özellikleri kaldıracak ve/veya önceki üç ay içinde geriye dönük uyumsuzluklar başlatacaktır. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.
Üç aylık süreçte bu sürüm yeni özellikleri, hata düzeltmelerini veya performans iyileştirmelerini içermeyecektir. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzluklar yaratmaz.
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ına uygun şekilde kullanıma sunulur.
Sürüm 3.55
Kasım ayının ortalarında yeni bir sürüm 3.55 kullanıma sunulacaktır. Bu sürümde, yeni özellikler yer alır, kullanımdan kaldırılan özellikler kaldırılır ve/veya sürüm 3.54'e kıyasla geriye dönük uyumsuzluklar ortaya çıkar. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.
Üç aylık dönem boyunca yeni sürüm, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenir. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzluklar yaratmaz.
Sürüm 3.54
Bu sürüm yeni özellikler içeriyor, kullanımdan kaldırılan özellikleri kaldırır ve/veya sürüm 3.53'e kıyasla geriye dönük uyumsuzluklar ortaya çıkarır. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.
Kasım ayının ortalarından sonra bu sürüm artık yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleriyle güncellenmeyecek. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzluklar yaratmaz.
Sürüm 3.53
Bu sürümde yeni özellikler var, kullanımdan kaldırılan özellikler kaldırılıyor ve/veya sürüm 3.52'ye kıyasla geriye dönük uyumsuzluklar ortaya çıkıyor. 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 özellikler kaldırılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.
Sürüm 3.52
Bu sürümde yeni özellikler var, kullanımdan kaldırılan özellikler kaldırılıyor ve/veya sürüm 3.51'e kıyasla geriye dönük uyumsuzluklar ortaya çıkıyor. 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 özellikler kaldırılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.
Sürüm 3.51
Kasım ayının ortasından itibaren bu sürüm silinecek ve artık kullanılamayacaktır. Bu sürümü yüklemek için yapılan tüm girişimler yok sayılır ve onun 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 denetimleri
Hata ayıklama için uygulamanızda Maps JavaScript API'nin geçerli sürümünü edinmek amacıyla google.maps.version
özelliğini 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 rehberini 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ümleri için belgeler
Geliştirici kılavuzunda her zaman haftalık sürüm açıklanmaktadır.
Ayrıca, her sürüm için ayrı bir kaynak referansı vardır:
- Sürüm 3.54 API Referansı (haftalık kanal)
- Sürüm 3.53 API Referansı (üç aylık kanal)
- Sürüm 3.52 API Referansı
- Sürüm 3.51 API Referansı
- Sürüm 3.0-3.50 silindi.