Sürüm oluşturma

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

Ağustos ayının ortasında, haftalık kanal 3.54 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.52'dir. Üç 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.

Ağustos ayının ortasında üç aylık kanal, 3.53 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.52
        &key=YOUR_API_KEY&callback=initMap">
</script>

Şu anda v=3.53, v=3.52, v=3.51 veya v=3.50 belirtebilirsiniz.

  • Sürüm 3.53 yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alıyor.
  • Sürüm 3.52, haftalık güncelleme almıyor.
  • 3.51 sürümü haftalık güncellemeler almıyor.
  • 3.50 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.

Ağustos ayının ortasından sonra v=3.54, v=3.53, v=3.52 veya v=3.51 değerini belirtebileceksiniz.

  • Sürüm 3.54 yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alı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.
  • Sürüm 3.51 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.50 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.

  1. Tarayıcınızdaki geliştirici araçlarında konsolu açıp google.maps.version'in değerine bakın.
  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.53.2" ise komut dosyası etiketinizde v=3.52 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 Ağustos ortalarında yapılacaktır. Yeni haftalık kanalda 3.54 sürümü sunulacak ve diğer kanallar da güncellenecektir.

Haftalık kanal güncellemesi

Haftalık kanal şu anda 3.53 sürümüne işaret etmektedir.

Ağustos ayının ortasından itibaren haftalık kanal 3.53 sürümünden 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 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.52 sürümüne işaret etmektedir.

Ağustos ayının ortasında, üç aylık kanal 3.52 sürümünden 3.53 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

Ağustos ayının ortasında, yeni bir sürümün yayınlanmasını sağlamak için sürüm numaraları kullanıma sunulur.

Sürüm 3.54

Ağustos ayının ortasında yeni bir sürüm 3.54 yayınlanacak. Bu sürümde, yeni özellikler bulunacak, kullanımdan kaldırılan özellikler kaldırılacak ve/veya sürüm 3.53'e kıyasla geriye dönük uyumsuzluklar sunulacaktır. 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.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.

Ağustos ayının ortasından itibaren bu sürüm 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.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

Bu sürüm yeni özellikler içeriyor, kullanımdan kaldırılan özellikleri kaldırıyor ve/veya sürüm 3.50 ile karşılaştırıldığında geriye dönük uyumsuzluklar getiriyor. 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.50

Ağustos 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: