Sürüm oluşturma

Maps JavaScript API ekibi, API'yi düzenli olarak yeni özellikleri, hata düzeltmeleri ve performans iyileştirmeleri. Bu sayfada, API'nın uygulamalarınızda kullanabileceğiniz sürümlerini ifade eder.

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 her üç ayda bir güncellenir ve en tahmin edilebilir kanaldır.
  • Beta kanalı v=beta ile belirtilir.
    Bu kanal, weekly kanalı temel alınmıştır ve haftada bir kez güncellenir. Erken test ve geri bildirim için ek değişiklikler içeriyor.
  • Alfa kanalı v=alpha ile belirtilir.
    Bu kanal, beta kanalı temel alınmıştır ve haftada bir kez güncellenir. Prototiplerle ilgili müşteri geri bildirimlerine yönelik denemeleri 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.58, v=3.57, v=3.56 veya v=3.55 arasından seçim yapabilirsiniz.
    Sürüm numaraları üç ayda bir güncellenir (Üç aylık güncellemeler'e bakın).

Bir kanalı veya sürümü açıkça belirtmezseniz haftalık kanal alırsınız. varsayılan olarak. Premium plandan geçiş yaptıysanız ve taşımadıysanız bir kanal veya sürüm belirtirseniz üç aylık bir kanalı varsayılan olarak alırsınız. Şu durumda: 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 son ve en güncel sürüme sahip olur ve en son hata düzeltmelerini ve performans iyileştirmelerini içerir. Maps JavaScript API'yi aşağıdaki kodla yükleyerek haftalık kanalı belirtebilirsiniz. komut dosyası etiketi:

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

Haftalık kanal, Kasım ayının ortalarında şu şekilde güncellenecek: Sürüm 3.59'dur. Bu tarihte, yeni sürüm desteği sonlandırılmış özellikleri kaldırabilir ve/veya geriye dönük uyumsuzluklara yol açabilir.

Üç aylık kanalı seçme

Bazı uygulamalar daha az ancak daha büyük güncellemelerden yararlanabilir, çünkü daha fazla öngörülebilirlik. Bu başvurular üç aylık kanalı kullanmalıdır. Bu yaklaşımı kullanın hata düzeltmeleri ve performans iyileştirmelerinin beklenen zamanda ulaşmasını istiyorsanız (üç aylık güncellemelere bakın). Maps JavaScript API'yi aşağıdaki kodla yükleyerek üç aylık kanalı belirtebilirsiniz. komut dosyası etiketi:

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

Şu anda üç aylık kanal sürümü 3.57'dir. Üç aylık dönem boyunca bu sürüm yeni özellikleri, hata düzeltmelerini veya performans iyileştirmeleri. Zaman zaman bu sürümde güvenlik hataları düzeltmeleri yapabiliriz.

Üç aylık kanal, Kasım ayının ortalarında 3.58 sürümüne güncellenecektir. Bu tarihte, yeni sürüm yeni özellikler içerecek, kullanımdan kaldırılan özellikleri kaldıracak, ve/veya önceki üç aydan eski uyumsuzluklara yol açabilir.

Beta kanalını seçme

Yeni beta özelliklerini ve değişikliklerini denemek için beta kanalını kullanın. Beta özellikler özellikler tamamlandı, ancak çözülmemiş sorunları olabilir (lütfen Sorun İzleyici sorun bildirin ve geri bildirim sağlayın). Beta kanalı, HDS veya kullanımdan kaldırma politikası ve bazı değişiklikler geriye dönük uyumlu olmayabilir önceki sürümlerle birlikte.

Bu kanal, weekly kanalını temel alır ve haftada bir kez güncellenir.

Aşağıdaki komut dosyasıyla Maps JavaScript API'yi yükleyerek beta kanalını belirtebilirsiniz. etiket:

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

Alfa kanalını seçme

Deneysel yeni özellikleri ve değişiklikleri denemek için alfa kanalını kullanın. Lütfen şunu kullanın: Sorun İzleyici sorun bildirmek ve geri bildirim sağlamak için. Alfa kanalı, herhangi bir HDS (Hizmet Düzeyi Sözleşmesi) veya kullanımdan kaldırma kapsamında değil 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.

Aşağıdaki komut dosyasıyla Maps JavaScript API'yi yükleyerek alfa kanalını belirtebilirsiniz. etiket:

  <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

Numaraya göre bir sürüm belirtmeniz için uygulamanızı düzenli olarak test edip güncellemeniz gerekir. Bunun nedeni, numaralandırılmış sürümlerin yeni sürümler oluşturuldukça silinmesidir . Maps JavaScript API'yi yükleyerek sürüm numarasını belirtebilirsiniz şununla değiştirin:

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

Şu anda, v=3.58, v=3.57, v=3.56 veya v=3.55.

  • 3.58 sürümü yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri.
  • 3.57 sürümü haftalık güncellemeleri almıyor.
  • 3.56 sürümü haftalık güncellemeleri almıyor.
  • 3.55 sürümü haftalık güncellemeleri almıyor.
  • Zaman zaman güvenlik hataları için düzeltmeler sunabiliriz bunu kullanabilirsiniz.
  • Yeni bir sürüm oluştururken geriye dönük olarak uyumsuz değişiklikler yapabiliriz.

Kasım ayının ortalarından sonra, v=3.59, v=3.58, v=3.57 veya v=3.56.

  • 3.59 sürümü yeni özellikleri, hata düzeltmelerini ve performans iyileştirmeleri.
  • 3.58 sürümü artık haftalık güncelleme almayacak.
  • 3.57 sürümü artık haftalık güncelleme almayacak.
  • 3.56 sürümü artık haftalık güncelleme almayacak.
  • Zaman zaman güvenlik hataları için düzeltmeler sunabiliriz bunu kullanabilirsiniz.
  • 3.55 sürümü artık kullanılamayacak. Bu sürümü yüklemeyle ilgili tüm denemeler yoksayılır ve bunun yerine varsayılan kanalınızı alırsınız.
ziyaret edin.

Aşağıdaki şema, her kanalda hangi sürümlerin kullanılabileceğini gösterir yardımcı olmaktır.

v=weekly v=üç aylık v=3.nn v=3.nn-1 Ağustos 2024 Kasım 2024 Şubat 2025 Mayıs 2025 v3.55 v3.56 v3.56 v3.57 v3.57 v3.57 v3.58 v3.58 v3.58 v3.58 v3.59 v3.59 v3.59 v3.60 v3.60 v3.61

Bir güncelleme uygulamamı etkiledi

Sürüm kanallarının güncellenmesi uygulamanızı etkileyebilir. Bunun nedeni, Uygulamanız belgelenmemiş veya desteği sonlandırılmış özellikleri kullanıyor ya da bir hata veya hata nedeniyle düzelttik.

Geçici bir çözüm olarak, uygulamanızı daha 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.
  2. API'yi yükleyen komut dosyası etiketini güncelleyin ve daha eski bir sürüm numarası isteyin.
    . Örneğin, google.maps.version "3.58.2" ise şunu kullanın: Komut dosyası etiketinizde v=3.57.
    . Bu geçici çözüm yalnızca sınırlı bir süre için işe yarayacaktır.

Geçici çözüm uygulandıktan sonra, projeyle ilgili sorunları bildirmek için (genellikle 3-6 ay) uygulamanızı, belgelenmemiş veya desteği sonlandırılmış özellikleri ve hesapları artık kullanmayacak şekilde güncelleyin. inceleyin.

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

Ayrıca isterseniz destek kaydı veya sorun bildirin.

Üç aylık güncellemeler

Maps JavaScript API ekibi üç ayda bir yeni bir sürüm yayınlar. Bu dönem Şubat ayının ortası, Mayıs ayının ortası, Ağustos ayının ortası ve Kasım ayının ortalarında gerçekleşir. Bir sonraki güncelleme Kasım ortalarında olacak. Haftalık yeni kanalda 3.59 sürümü sunulacak. O zaman diğer kanallar güncellenecek.

Haftalık kanal güncellemesi

Haftalık kanal şu anda 3.58 sürümüne işaret ediyor.

Haftalık kanal, Kasım ayının ortalarında 3.58 sürümünden Sürüm 3.59'dur. Bu noktada, yeni sürüm yeni özellikler içerecek, kullanımdan kaldırılan özellikleri kaldıracak, ve/veya geriye dönük uyumsuzluklara yol açabilir. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Bu üç aylık dönem boyunca yeni sürüm, yeni özelliklerle haftalık olarak güncellenecektir. hata düzeltmeleri ve performans iyileştirmeleri. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzluklara yol açmaz.

Üç aylık kanal güncellemesi

Üç aylık kanal şu anda 3.57 sürümüne işaret ediyor.

Üç aylık kanal, Kasım ayının ortalarında 3.57 sürümünden güncellenecektir 3.58 sürümüne geçebilirsiniz. Güncellendikten sonra bu sürüm yeni özellikler içerecek, kullanımdan kaldırılan özellikleri kaldıracak, ve/veya önceki üç aydan geriye dönük uyumsuzluklar ortaya çıkarabilir. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Üç aylık dönem boyunca bu sürüm yeni özellikleri, hata düzeltmelerini, performans iyileştirmelerinden yararlanabilirsiniz. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzluklara yol açmaz.

Sürüm güncellemeleri

Kasım ayının ortalarında yeni bir sürümün kullanıma sunulması için sürüm numaraları devredilir yeni sürüm olduğundan emin olun.

Sürüm 3.59

Kasım ayının ortalarında yeni bir sürüm 3.59 yayınlanacak. Bu sürüm, yayınlandıktan sonra yeni özellikler içerecek, kullanımdan kaldırılan özellikleri kaldıracak, ve/veya 3.58 sürümüne kıyasla geriye dönük uyumsuzluklar ortaya çıkardı. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Bu üç aylık dönem boyunca yeni sürüm, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzluklara yol açmaz.

Sürüm 3.58

Bu sürüm yeni özellikler içeriyor, desteği sonlandırılmış özellikleri kaldırıyor ve/veya yeni özellikler içeriyor eski sürümlerdeki uyumsuzlukların neden olduğu 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 özelliklerle güncellenmeyecek. veya performans iyileştirmeleri. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzluklara yol açmaz.

Sürüm 3.57

Bu sürüm yeni özellikler içeriyor, desteği sonlandırılmış özellikleri kaldırıyor ve/veya yeni özellikler içeriyor eski sürümlerdeki uyumsuzlukların neden olduğu 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 yeni özellikler kullanıma sunulmaz. geriye dönük uyumsuzluklar hakkında bilgi edindiniz.

Sürüm 3.56

Bu sürüm yeni özellikler içeriyor, desteği sonlandırılmış özellikleri kaldırıyor ve/veya yeni özellikler içeriyor eski sürümlerdeki uyumsuzlukların neden olduğu 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 yeni özellikler kullanıma sunulmaz. geriye dönük uyumsuzluklar hakkında bilgi edindiniz.

Sürüm 3.55

Kasım ayının ortalarından sonra bu sürüm silinecek ve artık kullanılamayacak. Bu sürümü yükleme girişimleri yoksayılır ve 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 mevcuttur. Bu sürümlerin dördü de desteklenir.

Sürüm kontrolleri

Hata ayıklama için google.maps.version özelliğini kullanarak uygulamanızda Maps JavaScript API'nin mevcut sürümüne sahip olmanız gerekir. Aşağıdaki kod örneğin, API sürümünü tarayıcı konsoluna yazar. (Tarayıcı konsolu hakkında daha fazla bilgi edinmek için tarayıcınızdaki hataları kontrol etme.)

<!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ılavuzu her zaman haftalık sürümü tanımlar.

Ayrıca, her sürüm için ayrı olarak korunan bir referans mevcuttur: