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ılabilecek 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.
    Haftada bir kez güncellenen bu kanal en güncel olanıdır.
  • Üç aylık kanal, v=quarterly ile belirtilir.
    Üç ayda bir güncellenen bu kanal, daha kolay tahmin edilebilir.
  • Beta kanalı, v=beta ile belirtilir.
    Bu kanal, weekly kanalı temel alınarak belirlenir ve haftada bir kez güncellenir. Erken testler ve geri bildirimler için ek değişiklikler içerir.
  • Alfa kanalı, v=alpha ile belirtilmiş.
    Bu kanal, beta kanalı temel alınarak belirlenir ve haftada bir kez güncellenir. Prototiplerle ilgili müşteri geri bildirimi 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 belirtilmiş.
    v=3.55, v=3.54, v=3.53 veya v=3.52 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 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ı alırsınız.

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

Şubat ayının ortasında haftalık kanal 3.56 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.54 sürümüne sahiptir. Üç 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.

Şubat ayının ortasında, üç aylık kanal 3.55 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.54
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

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

Şubat ayının ortasından sonra v=3.56, v=3.55, v=3.54 veya v=3.53 belirtebileceksiniz.

  • Sürüm 3.56 yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alacak.
  • 3.55 sürümü artık haftalık güncellemeleri almayacak.
  • 3.54 sürümü artık haftalık güncellemeleri almayacak.
  • 3.53 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.52 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.

201 {1v {1v {1v. v3.52v3.53v3.53v3.54v3.54v3.54v3.55v3.55v3.55v3.55v3.56v3.56v3.56v3.57v3.57v3.58

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.55.2" ise komut dosyası etiketinizde v=3.54 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 Şubat ortasında olacaktır. Yeni haftalık kanal 3.56 sürümünü sağlar ve bu tarihte diğer kanallar güncellenir.

Haftalık kanal güncellemesi

Haftalık kanal şu anda 3.55 sürümünü işaret etmektedir.

Şubat ayı ortasında, haftalık kanal 3.55 sürümünden 3.56 sürümüne güncellenecektir. Bu noktada yeni sürüm yeni özellikler içerecek, kullanımdan kaldırılmış özellikleri kaldıracak ve/veya geriye dönük uyumsuzluklar ekleyecektir. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Üç aylık dönem boyunca yeni sürüm; yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle her hafta güncellenecektir. Bu işlemle, kullanımdan kaldı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.54 sürümünü işaret etmektedir.

Şubat ayı ortasında, üç aylık kanal 3.54 sürümünden 3.55 sürümüne güncellenecektir. Güncelleme sonrasında bu 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. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Çeyrek boyunca bu sürümde yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri yer almayacak. Bu işlemle, kullanımdan kaldı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 yeni sürümün kullanıma sunulabilmesi için sürüm numaraları devredilir.

Sürüm 3.56

Şubat ayının ortasında yeni bir sürüm 3.56 kullanıma sunulacaktır. Bu sürüm yayınlandıktan sonra yeni özellikler içerecek, kullanımdan kaldırılan özellikleri kaldıracak ve/veya 3.55 sürümüne kıyasla geriye dönük uyumsuzluklar ekleyecektir. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Çeyrek boyunca yeni sürüm; yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle her hafta güncellenecek. Bu işlemle, kullanımdan kaldırılan özellikler kaldırılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.

Sürüm 3.55

Bu sürüm yeni özellikler içeriyor, kullanımdan kaldırılan özellikleri kaldırıyor ve/veya 3.54 sürümüne kıyasla geriye dönük uyumsuzluklar sunuyor. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Şubat ortasından sonra bu sürüm yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri ile güncellenmeyecektir. Bu işlemle, kullanımdan kaldırılan özellikler kaldırılmaz ve geriye dönük uyumsuzluklar ortaya çıkmaz.

Sürüm 3.54

Bu sürüm yeni özellikler içeriyor, kullanımdan kaldırılan özellikleri kaldırıyor ve/veya 3.53 sürümüne kıyasla geriye dönük uyumsuzluklar sunuyor. 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ştirmeleri ile güncellenmeyecek. Bu sürümden sonra desteği sonlandırılan özellikler kaldırılmaz ve yeni geriye dönük uyumsuzluklar ortaya çıkmaz.

Sürüm 3.53

Bu sürüm yeni özellikler içeriyor, kullanımdan kaldırılan özellikleri kaldırıyor ve/veya 3.52 sürümüne kıyasla geriye dönük uyumsuzluklar sunuyor. 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ştirmeleri ile güncellenmeyecek. Bu sürümden sonra desteği sonlandırılan özellikler kaldırılmaz ve yeni geriye dönük uyumsuzluklar ortaya çıkmaz.

Sürüm 3.52

Şubat ortasından sonra bu sürüm silinecek ve 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.

Sürüm desteği

Herhangi bir çeyrekte dört sürüm kullanıma sunulur. Bu sürümlerin dördü de desteklenir.

Sürüm kontrolleri

Hata ayıklama için uygulamanızda Maps JavaScript API'nin güncel sürümünü edinmek üzere 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 rehberine bakın.)

<!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

Sürüm, geliştirici kılavuzunda her zaman haftalık olarak açıklanmaktadır.

Ayrıca, her sürüm için ayrı olarak saklanan bir referans da vardır: