Sürüm oluşturma

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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ı veya sürüm numaraları belirtebilirsiniz:

  • Haftalık kanal, v=weekly ile belirtilir.
    En güncel kanal, haftada bir güncellenir.
  • Üç aylık kanal, v=quarterly ile belirtilir.
    Üç ayda bir güncellenen bu kanal, en çok tahmin edilebilir kanaldır.
  • Beta kanalı v=beta ile belirtilir.
    Bu kanal weekly kanalına dayalıdır ve haftada bir kez güncellenir. Erken test ve geri bildirim için ek değişiklikler içerir.
  • Alfa kanalı, v=alpha ile belirtilmiştir.
    Bu kanal beta kanalına dayalıdır ve haftada bir kez güncellenir. Prototiplerle ilgili müşteri geri bildirimleri için 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.52, v=3.51, v=3.50 veya v=3.49 seçeneklerinden birini belirleyebilirsiniz.
    Sürüm numaraları üç ayda bir güncellenir (Çeyrek güncellemeleri bölümüne bakın).

Bir kanalı veya sürümü açıkça belirtmezseniz varsayılan olarak haftalık kanalı alırsınız. Premium plandan geçiş yaptıysanız ve bir kanal veya 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ı öneririz. Bu sürüm, en güncel ve güncel sürüm olup en son hata düzeltmeleri ve performans iyileştirmeleri içerir. Maps JavaScript API'yi 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 3.52 sürümüdür. Bu sürüm yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle her hafta güncellenir.

Nisan ayının ortasında, haftalık kanal 3.53 sürümüne yükseltilecek. Bu sırada, yeni sürüm kullanımdan kaldırılan özellikleri kaldırabilir ve/veya geriye dönük uyumsuzlukları giderebilir.

Üç aylık kanalı seçme

Daha iyi tahmin edilebilirlik sağladığı için bazı uygulamalar 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 gerçekleşmesini istiyorsanız bu yaklaşımı kullanın (üç aylık güncellemeler bölümüne bakın). Maps JavaScript API'yi 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>

Şu anda üç aylık kanal sürüm 3.51'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 yapabiliriz.

Nisan ayının ortasında üç aylık kanal, 3.52 sürümüne yükseltilecek. Bu tarihte, yeni sürüm yeni özellikler içerecek, kullanımdan kaldırılan özellikleri kaldıracak ve/veya son üç ay içinde geriye dönük uyumsuzluklar başlatacaktır.

Beta kanalını seçme

Beta kanalını kullanarak yeni beta özellikleri ve değişiklikleri deneyin. Beta özellikleri eksiksizdir ancak bazı sorunlar olabilir (sorunları bildirmek ve geri bildirim sağlamak 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ını seçme

Alfa kanalı'nı kullanarak yeni deneysel özellikleri ve değişiklikleri deneyin. 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ı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.

beta kanalına dayanan bu kanal haftada bir kez güncellenir.

Maps JavaScript API'yi aşağıdaki komut dosyası etiketiyle 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 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 silinmesidir. 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.51
        &key=YOUR_API_KEY&callback=initMap">
</script>

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

  • Sürüm 3.52 yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alıyor.
  • Sürüm 3.51 haftalık güncellemeleri almıyor.
  • Sürüm 3.50 haftalık güncellemeleri almıyor.
  • Sürüm 3.49 haftalık güncellemeleri almıyor.
  • Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmelerini kullanıma sunabiliriz.
  • Yeni bir sürüm oluştururken geriye dönük olarak uyumsuz değişiklikler yapabiliriz.

Nisan ayının ortasından sonra, 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 alacaktı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 almayacak.
  • Sürüm 3.50 artık haftalık güncellemeleri almayacaktır.
  • Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmelerini kullanıma sunabiliriz.
  • Sürüm 3.49 artık kullanılamayacak. Bu sürümü yükleme girişimi yok sayılır ve bunun 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

Sürüm kanallarının güncellenmesi uygulamanızı etkileyebilir. Bu durum, uygulamanızın belgelenmemiş veya kullanımdan kaldırılmış özelliklerden yararlanmasından ya da kullanıma sunulan 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ı geliştirici araçlarınızda konsolu açın ve google.maps.version değerini kontrol edin.
  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,52.2" ise komut dosyası etiketinizde v=3.51 kullanın.
    Bu geçici çözüm yalnızca sınırlı bir süre için geçerlidir.

Geçici geçici çözüm uygulandıktan sonra uygulamanızı güncellemek için zamanınız olacak (genellikle 3-6 ay), böylece uygulamanız artık belgelenmemiş veya kullanımdan kaldırılmış özellikleri kullanmayacak ve hataları ya da hata düzeltmelerini hesaba katacaktır.

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

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

Üç aylık güncellemeler

Üç ayda bir Haritalar Maps 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 Nisan ayının ortası olacaktır. Yeni haftalık kanalda 3.53 sürümü kullanıma sunulacak ve diğer kanallar güncellenecek.

Haftalık kanal güncellemesi

Haftalık kanal şu anda 3.52 sürümünü gösteriyor.

Nisan ayının ortasında, haftalık kanal 3.52 sürümünden 3.53 sürümüne güncellenecektir. Bu aşamada yeni sürüm dahil edilir, kullanımdan kaldırılan özellikler kaldırılır ve/veya geriye dönük uyumsuzluklar oluşur. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Çeyrek boyunca yeni sürüm yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle her hafta güncellenecektir. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzlukları ortadan kaldırır.

Üç aylık kanal güncellemesi

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

Nisan ayının ortalarında, üç aylık kanal 3.51 sürümünden 3.52 sürümüne güncellenir. Güncelleme yapıldığında bu sürüm yeni özellikler içerecek, kullanımdan kaldırılan özellikleri kaldıracak ve/veya son üç ay içinde geriye dönük uyumsuzluklar başlatacak. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Üç aylık süre boyunca bu sürüme yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri dahil edilmeyecektir. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzlukları ortadan kaldırır.

Sürüm güncellemeleri

Nisan ayının ortasında, sürüm numaraları yeni sürümün yayınlanmasına uyum sağlamak için devredilir.

Sürüm 3.53

Nisan ayının ortalarında yeni bir 3.53 sürümü kullanıma sunulacaktır. Bu sürümde, yeni özellikler yer alacak, kullanımdan kaldırılan özelliklerin kaldırılması ve/veya sürüm 3.52'ye kıyasla geriye dönük uyumsuzluklar sunulacaktır. 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üncellenecektir. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzlukları ortadan kaldırır.

Sürüm 3.52

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

Nisan ayının ortasından sonra 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ı ortadan kaldırır.

Sürüm 3.51

Bu sürüm yeni özellikler içeriyor, kullanımdan kaldırılan özelliklerin kaldırılmasına ve/veya sürüm 3.50 ile karşılaştırıldığında geriye dönük uyumsuzlukların yaşanmasına neden oluyor. 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 özelliklerin kaldırılması ve yeni geriye dönük uyumsuzlukların ortaya çıkmasına neden olmayacak.

Sürüm 3.50

Bu sürüm yeni özellikler içeriyor, kullanımdan kaldırılan özellikleri kaldırır ve/veya sürüm 3.49'a kıyasla 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 özelliklerin kaldırılması ve yeni geriye dönük uyumsuzlukların ortaya çıkmasına neden olmayacak.

Sürüm 3.49

Nisan ayının ortasından sonra bu sürüm silinir ve artık kullanılamaz. Bu sürümü yükleme girişimi yok sayılır ve bunun 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 kontrolleri

Hata ayıklama sırasında, uygulamanızda Maps JavaScript API'nin geçerli sürümünü edinmek için 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 kılavuzuna 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ümleri için belgeler

Geliştirici kılavuzunda her zaman haftalık sürüm açıklanmaktadır.

Buna ek olarak her sürüm için ayrı olarak yönetilen bir referans bulunur: