Duyuru: Yeni ana harita stili yakında Google Haritalar Platformu'nda kullanıma sunulacak. Harita stilinde yapılan bu güncelleme, yeni bir varsayılan renk paleti, modernleştirilmiş raptiyeler ve harita deneyimleri ile kullanılabilirlik açısından iyileştirmeler içeriyor. Tüm harita stilleri Mart 2025'te otomatik olarak güncellenecektir. Kullanılabilirlik ve özelliği daha erken etkinleştirme hakkında daha fazla bilgi için Google Haritalar Platformu için yeni harita stili başlıklı makaleyi inceleyin.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Sürüm oluşturma

Maps JavaScript API ekibi, API'yi düzenli olarak yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle günceller. Bu sayfada, API'nin uygulamalarınızda kullanılabilen 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 kez güncellenir ve en güncel bilgilere sahiptir.
Üç aylık kanal, v=quarterly ile belirtilir.
Bu kanal üç ayda bir güncellenir ve en tahmin edilebilir olanıdır.
Beta kanalı, v=beta ile belirtilir.
Bu kanal, weekly kanalını temel alı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 belirtilir.
Bu kanal, beta kanalını temel alır ve haftada bir kez güncellenir. Prototiplerle ilgili müşteri geri bildirimleri 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 belirtilir.
v=3.59, v=3.58, v=3.57 veya v=3.56 seçeneklerinden birini belirleyebilirsiniz.
Sürüm numaraları üç ayda bir güncellenir (Üç aylık güncellemeler bölümüne bakın).

Belirli bir kanal veya sürüm belirtmezseniz varsayılan olarak haftalık kanal bildirimini 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 gösterilir.

Haftalık kanalı seçme

Çoğu uygulama için haftalık kanalı öneririz. Bu, en güncel sürümdür ve en son hata düzeltmelerini ve performans iyileştirmelerini içerir. Maps JavaScript API'yi aşağıdaki komut dosyası etiketiyle yükleyerek haftalık kanalı belirtebilirsiniz:

  <script>
    (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
      key: "YOUR_API_KEY",
      v: "weekly",
    });
  </script>

Haftalık kanalın şu anki sürümü 3.59'dur. Bu sürüm, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenir.

Haftalık kanal, Şubat ayının ortasında 3.60 sürümüne güncellenecek. Bu süre zarfında yeni sürüm, desteği sonlandırılan özellikleri kaldırabilir ve/veya geriye dönük uyumsuzluklara neden olabilir.

Üç aylık kanalı seçme

Bazı uygulamalar, daha az sayıda ancak daha büyük güncellemelerden yararlanabilir. Bu sayede daha fazla öngörülebilirlik elde edilir. Bu uygulamalar üç aylık kanalı kullanmalıdır. Hata düzeltmelerinin ve performans iyileştirmelerinin beklenen zamanda gelmesini 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>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "quarterly",
  });
  </script>

Üç aylık kanalın şu anki sürümü 3.58'dir. Bu sürüm, üç aylık süre boyunca yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri almaz. Zaman zaman bu sürüme güvenlik hatası düzeltmeleri eklenebilir.

Üç aylık kanal, Şubat ayının ortasında 3.59 sürümüne güncellenecek. Bu süre zarfında yeni sürüm yeni özellikler içerecek, desteği sonlandırılan özellikleri kaldıracak ve/veya önceki üç aya ait geriye dönük uyumsuzluklar sunacaktır.

Şubat ayının başlarında, v=3.59'ü kullanarak uygulamanızı test etmenizi öneririz.

Beta kanalını seçme

Yeni beta özellikleri ve değişiklikleri denemek için beta kanalını kullanın. Beta özellikleri eksiksizdir ancak bazı sorunları olabilir (sorunları bildirmek ve geri bildirimde bulunmak için lütfen Sorun Takip Aracı'nı 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 uyumlu olmayabilir.

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

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
  });
  </script>

Alfa kanalını seçme

Yeni denesel özellikleri ve değişiklikleri denemek için alfa kanalını kullanın. Sorunları bildirmek ve geri bildirimde bulunmak için lütfen Sorun Takip Aracı'nı 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 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.

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

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "alpha",
  });
  </script>

Sürüm numarası seçme

Yalnızca uygulamanızı düzenli olarak test edip güncelliyorsanız sürüm numarasını belirtin. Bunun nedeni, her üç ayda bir yeni sürümler oluşturulduğundan, numaralandırılmış sürümlerin zaman içinde silinmesidir. Maps JavaScript API'yi aşağıdaki komut dosyası etiketiyle yükleyerek sürüm numarasını belirtebilirsiniz:

  <script>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: 3.58,
  });
  </script>

Şu anda v=3.59, v=3.58, v=3.57 veya v=3.56 değerini belirtebilirsiniz.

3.59 sürümü, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alır.
3.58 sürümü haftalık güncelleme almıyor.
3.57 sürümü haftalık güncelleme almaz.
3.56 sürümü haftalık güncelleme almaz.
Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmeleri ekleyebiliyoruz.
Yeni bir sürüm oluştururken geriye dönük uyumlu olmayan değişiklikler yapabiliriz.

Şubat ayının ortasından sonra v=3.60, v=3.59, v=3.58 veya v=3.57 değerini belirtebilirsiniz.

3.60 sürümü, yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleri içeren haftalık güncellemeler alır.
3.59 sürümü artık haftalık güncelleme almayacak.
3.58 sürümü artık haftalık güncelleme almayacak.
3.57 sürümü artık haftalık güncelleme almayacak.
Zaman zaman herhangi bir sürüme güvenlik hatası düzeltmeleri ekleyebiliyoruz.
3.56 sürümü artık kullanılamayacak. Bu sürümü yükleme girişimleri göz ardı edilir ve bunun yerine varsayılan kanalınız gösterilir.

v=3.57 veya v=3.56 kullanıyorsanız Şubat ayının ortasından önce v=3.59 veya v=3.58'e yükseltmenizi öneririz. Sürüm değiştirirken, yeni sürümlerde desteği sonlandırılan özelliklerin kaldırılabileceğini ve/veya geriye dönük uyumsuzluklar olabileceğini unutmayın.

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

Bir güncelleme başvurumu etkiledi

Sürüm kanallarını güncellediğimizde uygulamanız etkilenebilir. Bu durum, uygulamanızın dokümanları olmayan veya desteği sonlandırılmış özelliklere dayalı olmasından ya da sunduğumuz bir hata veya hata düzeltmesinden kaynaklanabilir.

Geçici bir geçici çözüm olarak, uygulamanızı eski bir sürümü kullanacak şekilde yeniden yapılandırabilirsiniz.

Tarayıcınızın geliştirici araçlarında konsolu açın ve google.maps.version değerine bakın.
API'yi yükleyen komut dosyası etiketini güncelleyin ve daha eski bir sürüm numarası isteyin.
Örneğin, google.maps.version "3.59.2" ise komut dosyası etiketinizde v=3.58 kullanın.
Bu geçici çözüm yalnızca sınırlı bir süre boyunca geçerli olacaktır.

Geçici geçici çözüm uygulandıktan sonra, uygulamanızı güncelleyerek artık belgelenmemiş veya desteği sonlandırılmış özellikleri kullanmamasını ve hataları ya da hata düzeltmelerini hesaba katmasını sağlamak için zamanınız (genellikle 3 ila 6 ay) olacaktır.

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

Dilerseniz destek kaydı oluşturabilir veya sorun bildirebilirsiniz.

Üç aylık güncellemeler

Maps JavaScript API ekibi üç ayda bir yeni bir sürüm yayınlar. Bu işlem Şubat, Mayıs, Ağustos ve Kasım ayının ortasında gerçekleşir. Bir sonraki güncelleme şubat ayının ortasında yapılacaktır. Yeni haftalık kanalda 3.60 sürümü sağlanacak ve bu sırada diğer kanallar da güncellenecek.

Haftalık kanal güncellemesi

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

Haftalık kanal, Şubat ayının ortasında 3.59 sürümünden 3.60 sürümüne güncellenecek. Bu noktada yeni sürüm yeni özellikler içerir, desteği sonlandırılan özellikleri kaldırır ve/veya geriye dönük uyumsuzluklar sunar. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Yeni sürüm, üç aylık süre boyunca yeni özellikler, hata düzeltmeleri ve performans iyileştirmeleriyle haftalık olarak güncellenecektir. Desteği sonlandı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.58 sürümünü gösteriyor.

Üç aylık kanal, Şubat ayının ortasında 3.58 sürümünden 3.59 sürümüne güncellenecek. Güncelleme sonrasında bu sürüm yeni özellikler içerecek, desteği sonlandırılan özellikleri kaldıracak ve/veya önceki üç aydan itibaren geriye dönük uyumsuzluklara neden olacaktır. Kanal güncellendiğinde bu değişiklikleri test etmeniz gerekebilir.

Bu sürüm, üç aylık süre boyunca yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleri içermeyecek. Desteği sonlandırılan özellikler kaldırılmayacak ve geriye dönük uyumsuzluklara neden olmayacak.

Sürüm güncellemeleri

Şubat ayının ortasında, sürüm numaraları yeni bir sürümün kullanıma sunulması için sıfırlanır.

3.60 sürümü

Şubat ayının ortasında 3.60 sürümü kullanıma sunulacak. Yayınlandıktan sonra bu sürüm yeni özellikler içerecek, desteği sonlandırılan özellikleri kaldıracak ve/veya 3.59 sürümüne kıyasla geriye dönük uyumsuzluklara neden olacak. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Sürüm 3.59

Bu sürüm yeni özellikler içerir, desteği sonlandırılan özellikleri kaldırır ve/veya 3.58 sürümüne kıyasla geriye dönük uyumsuzluklar sunar. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

Şubat ayının ortasından sonra bu sürüm yeni özellikler, hata düzeltmeleri veya performans iyileştirmeleriyle güncellenmeyecektir. Desteği sonlandırılan özellikler kaldırılmayacak ve geriye dönük uyumsuzluklara neden olmayacak.

Sürüm 3.58

Bu sürüm yeni özellikler içerir, desteği sonlandırılan özellikleri kaldırır ve/veya 3.57 sürümüne kıyasla geriye dönük uyumsuzluklara neden olur. 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 geriye dönük uyumsuzluklara neden olacak yeni özellikler eklenmez.

Sürüm 3.57

Bu sürümde yeni özellikler yer alır, desteği sonlandırılan özellikler kaldırılır ve/veya 3.56 sürümüne kıyasla geriye dönük uyumsuzluklar bulunur. Sürüm numaraları arasında geçiş yaparken uygulamanızı test etmeniz gerekir.

3.56 sürümü

Şubat ayının ortasından sonra bu sürüm silinecek ve artık kullanılamayacak. Bu sürümü yükleme girişimleri göz ardı edilir ve bunun yerine varsayılan kanalınız gösterilir.

Sürüm desteği

Her üç ayda bir dört sürüm kullanılabilir. 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 üzere google.maps.version mülkünü 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ılavuzunu 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ümleriyle ilgili belgeler

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

Ayrıca her sürüm için ayrı olarak yönetilen bir referans vardır:

3.59 Sürüm API Referansı (haftalık kanal)
3.58 Sürümü API Referansı (üç aylık kanal)
3.57 Sürümü API Referansı
3.56 Sürüm API Referansı
3.0 ile 3.55 arasındaki sürümler silindi.