Sürüm oluşturma

Haftalık kanalı seçme

Çoğu uygulama için haftalık kanalı öneririz. Bu, en güncel ve en güncel sürümdür ve en son hata düzeltmelerini ve performans iyileştirmelerini içerir. Aşağıdaki komut dosyası etiketiyle Maps JavaScript API'yi 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 3.56 sürümüdür. Bu sürüm yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle her hafta güncellenir.

Mayıs ayının ortasında haftalık kanal 3.57 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 uyumsuzluklara yol açabilir.

Üç aylık kanalı seçme

Bazı uygulamalar, daha fazla öngörülebilirlik sağladığı için daha az ama 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 ulaşmasını istiyorsanız bu yaklaşımı kullanın (üç aylık güncellemeler bölümüne bakın). Aşağıdaki komut dosyası etiketiyle Maps JavaScript API'yi 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>

Şu anda üç aylık kanal 3.55 sürümüdür. Üç aylık dönem boyunca bu sürüm yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri almaz. Zaman zaman bu sürüme güvenlik hatası düzeltmeleri ekleyebiliriz.

Üç aylık kanal, Mayıs ayının ortasında 3.56 sürümüne güncellenecektir. Bu tarihte yeni sürüm yeni özellikler içerecek, kullanımdan kaldırılmış özellikleri kaldıracak ve/veya önceki üç aya ait geriye dönük uyumsuzluklar ekleyecektir.

Beta kanalını seçme

Yeni beta özelliklerini ve değişikliklerini denemek için beta kanalını kullanın. Beta özellikleri eksiksiz özelliklerdir ancak bazı çözülmemiş sorunlar içerebilir (lütfen sorunları bildirmek ve geri bildirim sağlamak için Sorun İzleyici'yi 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 uyumlu olmayabilir.

Bu kanal, weekly kanalı temel alınarak belirlenir ve 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ını seçme

Yeni deneysel özellikleri ve değişiklikleri denemek için alfa kanalını kullanın. Lütfen sorunları bildirmek ve geri bildirim sağlamak için Sorun İzleyici'yi 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 geriye dönük uyumlu olmayabilir. Yalnızca geliştirme amaçlıdır ve üretimde kullanılmamalıdır.

Bu kanal, beta kanalı temel alınarak belirlenir ve haftada bir kez güncellenir.

Aşağıdaki komut dosyası etiketiyle Maps JavaScript API'yi yükleyerek alfa kanalını 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üncelliyorsanız numaraya göre sürüm belirtin. Bunun nedeni, her üç ayda bir yeni sürümler oluşturuldukça, numaralı sürümlerin de silinmesidir. Aşağıdaki komut dosyası etiketiyle Maps JavaScript API'yi yükleyerek sürüm numarasını belirtebilirsiniz:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.55
        &key=YOUR_API_KEY&callback=initMap">
</script>

Şu anda v=3.56, v=3.55, v=3.54 veya v=3.53 değerlerini belirtebilirsiniz.

• Sürüm 3.56; yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alıyor.
• Sürüm 3.55 haftalık güncellemeleri almıyor.
• Sürüm 3.54 haftalık güncellemeleri almıyor.
• Sürüm 3.53 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 olarak uyumsuz değişiklikler yapabiliriz.

Mayıs ayının ortasından sonra v=3.57, v=3.56, v=3.55 veya v=3.54 belirtebileceksiniz.

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

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

Bir güncelleme başvurumu etkiledi

Sürüm kanallarını güncellememiz, uygulamanızı etkileyebilir. Bunun nedeni, uygulamanızın belgelenmemiş veya desteği sonlandırılmış özelliklere dayanması ya da kullanıma sunduğumuz bir hata veya hata düzeltmesi olabilir.

Geçici bir çözüm olarak, uygulamanızı eski bir sürümü kullanacak şekilde yeniden yapılandırabilirsiniz.

1. Tarayıcı geliştirici araçlarınızda 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 değeri "3.56.2" ise komut dosyası etiketinizde v=3.55 kullanın.
   Bu geçici çözüm yalnızca sınırlı bir süre boyunca işe yarar.

Geçici çözüm kullanıma sunulduğunda uygulamanızı güncellemek için zamanınız (genellikle 3 ila 6 ay) olacaktır. Böylece, uygulamanız artık belgelenmemiş veya desteği sonlandırılmış özellikleri ve hata ya da hata düzeltme hesaplarını kullanmaz.

Bu durumda, API'yi yüklemek için orijinal komut dosyası etiketine geri dönmeniz gerekir.

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

Üç aylık güncellemeler

Haritalar JavaScript API ekibi üç ayda bir yeni bir sürüm yayınlar. Bu değişiklik Şubat, Mayıs, Ağustos ortası ve Kasım ayı ortalarında yapılır. Bir sonraki güncelleme Mayıs ortası olacak. Yeni haftalık kanal 3.57 sürümünü sunacak ve bu tarihte diğer kanallar güncellenecek.