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.
    Bu kanal haftada bir güncellenir ve en güncel kanaldır.
  • Üç aylık kanal, v=quarterly ile belirtilir.
    Bu kanal üç ayda bir güncellenir ve en öngörülebilir niteliktedir.
  • 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.
  • Sürüm numarası v=n.nn ile belirtilir.
    v=3.50, v=3.49, v=3.48 veya v=3.47 seçeneklerinden birini belirleyebilirsiniz.
    Sürüm numaraları üç ayda bir güncellenir (Üç aylık güncellemeler 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 başvuru için haftalık kanal önerilir. Bu, en güncel ve güncel sürümdür ve en son hata düzeltmeleri ile 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.50'dir. Bu sürüm; yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenir.

Kasım ayının ortalarında, haftalık kanal 3.51 sürümüne güncellenir. Bu durumda yeni sürüm, kullanımdan kaldırılan özellikleri kaldırabilir ve/veya geriye dönük uyumsuzlukları ortaya çıkarabilir.

Üç aylık kanalı seçme

Bazı uygulamalar daha az tahmin edilebilirlik içerdiğinden daha fazla güncellemenin faydasını görebilir. 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). Aşağıdaki komut dosyası etiketiyle Haritalar JavaScript API'sini yükleyerek üç aylık bir kanal belirleyebilirsiniz:

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

Üç aylık dönemin sürümü 3.49'dur. Üç aylık dönemde bu sürüm yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri almayacaktır. Zaman zaman bu sürümde güvenlik hatası düzeltmeleri yapabiliriz.

Kasım ayının ortalarında, üç aylık kanal 3.50 sürümüne güncellenir. Bu aşamada 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 yaratacaktır.

Beta kanalını seçme

Beta kanalını kullanarak yeni beta özelliklerini ve değişikliklerini deneyebilirsiniz. Beta özellikler tam kapsamlıdır ancak bekleyen 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ına girmez ve bazı değişiklikler eski 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>

Sürüm numarası seçme

Yalnızca uygulamanızı düzenli olarak test edip güncelliyorsanız sürüme göre sürüm belirtin. Bunun nedeni, her çeyrekte yeni sürümler oluşturulduğundan 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.49
        &key=YOUR_API_KEY&callback=initMap">
</script>

Şu anda v=3.50, v=3.49, v=3.48 veya v=3.47 değerini belirtebilirsiniz.

  • Sürüm 3.50 yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık güncellemeler alıyor.
  • 3.49 sürümü haftalık güncelleme almıyor.
  • 3.48 sürümü haftalık güncelleme almıyor.
  • 3.47 sürümü haftalık güncelleme almıyor.
  • Zaman zaman herhangi bir sürümde güvenlik hatası düzeltmeleri yapabiliriz.
  • Yeni bir sürüm oluştururken geriye dönük uyumlu olmayan değişiklikleri kullanıma sunabiliriz.

Kasım ayının ortasından sonra v=3.51, v=3.50, v=3.49 veya v=3.48 değerini belirtebileceksiniz.

  • 3.51 sürümü yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık güncellemeler alır.
  • Sürüm 3.50 artık haftalık güncelleme almayacaktır.
  • 3.49 sürümü artık haftalık güncelleme almayacaktır.
  • Sürüm 3.48 artık haftalık güncelleme almayacaktır.
  • Zaman zaman herhangi bir sürümde güvenlik hatası düzeltmeleri yapabiliriz.
  • Sürüm 3.47 artık kullanılamayacak. Bu sürümü yükleme girişimleri yok sayılır ve bunun yerine varsayılan kanalınızı alırsınız.

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

Başvurumu etkileyen bir güncelleme var

Sürüm kanallarını güncellememiz, uygulamanızı etkileyebilir. Bunun nedeni, uygulamanızın belgelenmemiş veya kullanımdan kaldırılmış özelliklerden yararlanması 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 daha eski bir sürüm numarası isteyin.
    Örneğin, google.maps.version &3T;3.50.2&quot ise komut dosyası etiketinizde v=3.49 kullanın.
    Bu geçici çözüm, yalnızca sınırlı bir süre için geçerlidir.

Geçici çözüm uygulandıktan sonra uygulamanızı güncellemek için zamanınız (genellikle 3 ila 6 ay) olur, böylece artık doküman haline getirilmiş veya kullanımdan kaldırılan özellikleri kullanmaz, ayrıca hataları veya hata düzeltmelerini hesaba katar.

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

Üç ayda bir Maps JavaScript API ekibi yeni bir sürüm yayınlar. Bu değişiklik şubat, mayıs ve ağustos aylarında ve Kasım ayının ortalarında gerçekleşmektedir. Bir sonraki güncelleme Kasım ayının ortalarında yapılacaktır. Yeni haftalık kanalda 3.51 sürümü sunulacaktır. Bu tarihte diğer kanallar güncellenecektir.

Haftalık kanal güncellemesi

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

Kasım ayının ortalarında, haftalık kanal 3.50 sürümünden 3.51 sürümüne güncellenir. 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ı ön plana çıkaracaktır. 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 haftalık olarak güncellenecektir. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzlukları teşvik etmez.

Üç aylık kanal güncellemesi

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

Kasım ayının ortalarında, üç aylık kanal, 3.49 sürümünden 3.50 sürümüne güncellenir. Güncellemeden sonra 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ı önleyecektir. 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 almayacaktır. Kullanımdan kaldırılan özellikleri kaldırmaz ve geriye dönük uyumsuzlukları teşvik etmez.

Sürüm güncellemeleri

Kasım ayının ortalarında, sürüm numaraları yeni bir sürümün yayınlanması için devreye girer.

Sürüm 3.51

Kasım ayının ortalarında yeni bir 3.51 sürümü 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.50 sürümüyle kıyaslandığında geriye dönük uyumsuzluklar oluşturacaktır. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Üç aylık dönemde 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ı teşvik etmez.

Sürüm 3.50

Bu sürüm yeni özellikler içeriyor, kullanımdan kaldırılan özellikleri kaldırıyor ve/veya sürüm 3.49'a kıyasla geriye dönük uyumsuzluklar ortaya çıkar. 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 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ı teşvik etmez.

Sürüm 3.49

Bu sürüm yeni özellikler içeriyor, kullanımdan kaldırılan özellikleri kaldırıyor ve/veya sürüm 3.48'e kıyasla geriye dönük uyumsuzluklar ortaya çıkarı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 özellikleri kaldırmayacak ve geriye dönük olarak uyumsuzluklar başlatmayacaktır.

Sürüm 3.48

Bu sürüm yeni özellikler içeriyor, kullanımdan kaldırılan özellikleri kaldırıyor ve/veya sürüm 3.47'ye kıyasla geriye dönük uyumsuzluklar ortaya çıkar. 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 özellikleri kaldırmayacak ve geriye dönük olarak uyumsuzluklar başlatmayacaktır.

Sürüm 3.47

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 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 mevcuttur. Bu sürümlerin dördü de desteklenir.

Sürüm kontrolleri

Hata ayıklama için, uygulamanızda Maps JavaScript API'nin geçerli sürümünü almak 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 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ılavuzu her zaman haftalık sürümü açıklar.

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