Duyuru: Yakında Google Haritalar Platformu'nda yeni temel harita stili kullanıma sunulacak. Harita stilinde yapılan bu güncelleme; yeni bir varsayılan renk paleti, modernleştirilmiş raptiyeler, harita deneyimleri ve kullanılabilirlik ile ilgili iyileştirmeler içerir. 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.

Sorun giderme

API Anahtarı ve Faturalandırma Hataları

Belirli durumlarda, "sadece geliştirme amaçları için" metniyle filigranlanmış, karartılmış bir harita veya "negatif" bir Street View görüntüsü gösterilebilir. Bu davranış genellikle API anahtarıyla veya faturalandırmayla ilgili sorunları gösterir. Google Haritalar Platformu ürünlerini kullanmak için hesabınızda faturalandırmanın etkinleştirilmesi ve tüm isteklerin geçerli bir API anahtarı içermesi gerekir. Aşağıdaki akış, bu sorunu gidermenize yardımcı olacaktır:

API anahtarı kullanıyor musunuz?

Emin değilim. API anahtarı kullanıp kullanmadığımı nasıl kontrol edebilirim?

Maps JavaScript API'yi yüklemek için kullanılan URL'de key parametresi olarak bir API anahtarı iletilir. API anahtarı kullanıp kullanmadığınızı kontrol etmek için birkaç seçenek vardır:

Google Haritalar Platformu API Kontrolü Chrome uzantısını kullanın. Bu sayede, web sitenizin Google'ın lisanslı Haritalar API'lerini doğru şekilde uygulayıp uygulamadığını belirleyebilirsiniz.
Maps JavaScript API'yi yüklemek için bir kitaplık veya eklenti kullanıyorsanız söz konusu kitaplığın ayarlarını kontrol edin ve API anahtarı seçeneğini bulun.
Tarayıcınızdaki hataları kontrol edin. Aşağıdaki mesajları görüyorsanız API anahtarınızı doğru şekilde kullanmıyorsunuz demektir:

Google Maps JavaScript API uyarısı: NoApiKeys
Google Maps JavaScript API hatası: MissingKeyMapError

Web geliştiricileri için:

Uygulamanızın kaynak koduna erişiminiz varsa Maps JavaScript API'yi yüklemek için kullanılan <script> etiketini bulun. Maps JavaScript API'yi yüklerken aşağıdaki koddaki YOUR_API_KEY yerine API anahtarınızı koyun.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Web siteniz tarafından oluşturulan ağ trafiğini tarayıcıda kontrol edin. Chrome'da bu, DevTools Ağ sekmesi kullanılarak görüntülenebilir. Burada, web siteniz tarafından yapılan ağ isteklerini görürsünüz. Maps JavaScript API kullanılarak yapılan istekler maps/api/js yolunun altında olur. Burada, isteklerin key parametresini kullanıp kullanmadığını onaylayabilirsiniz. Ağ sekmesini görüntülerken maps/api/js'ye göre ağ trafiğinizi filtrelemeniz faydalı olabilir.

Hayır, API anahtarı kullanmıyorum.

API anahtarı almak için aşağıdaki düğmeyi tıklayın. Rehberli kurulum görmüyorsanız Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaledeki talimatları eksiksiz olarak uygulayın.
Başlayın

Evet, API anahtarı kullanıyorum.

Mükemmel! Şimdi projenize faturalandırma hesabı eklenip eklenmediğini kontrol edelim.

Projenize faturalandırma hesabı eklenmiş mi?

Emin değilim. Faturalandırma hesabının projeme eklenip eklenmediğini nasıl kontrol edebilirim?

Google Cloud Console'daki Faturalandırma sayfasına gidin ve API anahtarınızın oluşturulduğu projeyi seçin. Anahtarın projeyle ilişkilendirildiğini onaylamak için:

Sol taraftaki Google Haritalar Platformu > Kimlik Bilgileri bölümünden Kimlik Bilgileri'ne gidin.
Web sitenizde şu anda kullandığınız API anahtarının listelenip listelenmediğini kontrol edin. Aksi takdirde farklı bir projeye geçip oradaki kimlik bilgilerini kontrol edin.
API anahtarınızın projesini bulamıyorsanız bu projeye erişimi kaybetmiş olabilirsiniz. Kuruluşunuzdaki diğer kişilerden yardım isteyin. Orijinal proje bulunamazsa:
1. Yeni bir proje oluşturun. Proje listesinden Yeni Proje'yi seçerek veya Kaynak Yöneticisi sayfasından Proje Oluştur'u seçerek bu işlemi yapabilirsiniz.
2. Yeni bir API anahtarı oluşturma. Bu işlem Credentials (Kimlik Bilgisi) sayfasında yapılabilir. Bu menüden Create credentials'ı (Kimlik bilgileri oluştur) tıklayın ve ardından API key'i (API anahtarı) seçin.

Cloud Console'da projenizi bulduktan sonra soldaki menüde Faturalandırma bölümüne giderek bir faturalandırma hesabı eklenip eklenmediğini kontrol edin.

Hayır, projeme bağlı bir faturalandırma hesabı yok.

Cloud Console'daki Faturalandırmayı etkinleştir sayfasına gidin ve projenize bir faturalandırma hesabı ekleyin. Daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin.

Evet, projeme bir faturalandırma hesabı eklendi.

Mükemmel! Sağlanan faturalandırma yönteminin geçerli olduğundan emin olalım.

Sağlanan faturalandırma yöntemi artık geçerli değil mi (ör. süresi dolmuş bir kredi kartı)?

Cloud Console'da ödeme yöntemi ekleyebilir, kaldırabilir veya güncelleyebilirsiniz.

API'de kullanıcının belirlediği günlük sınır aşıldı mı?

API'lerinizden herhangi biri için günlük sınır belirlediyseniz (beklenmedik artışları önlemek için yaygın olarak yapılır) bu sorunu günlük sınırınızı artırarak çözebilirsiniz.

Günlük sınırlarınızı Cloud Console'daki API'ler ve Hizmetler Kontrol Paneli'ne giderek kontrol edebilirsiniz. Bu bölümde:

İstenirse bir proje seçin.
Listeden bir API seçip Kotalar sekmesini tıklayın.

API anahtarınızda IP adresi kısıtlaması var mı?

IP adresi kısıtlaması olan API anahtarları yalnızca sunucu tarafında kullanılmak üzere tasarlanmış web hizmetleriyle (ör. Geocoding API ve diğer Web Hizmeti API'leri) kullanılabilir. Bu web hizmetlerinin çoğu, Maps JavaScript API'de eşdeğer hizmetlere sahiptir (örneğin, Coğrafi Kodlama Hizmeti'ne bakın). Maps JavaScript API istemci tarafı hizmetlerini kullanmak için HTTP yönlendirenleri kısıtlamasıyla güvence altına alınabilecek ayrı bir API anahtarı oluşturmanız gerekir (API anahtarı alma, ekleme ve kısıtlama bölümüne bakın).

Kodunuz çalışmıyorsa:

Brendan Kenny ve Mano Marks, haritalar kodunuzu kullanıma sunmanıza yardımcı olmak için bu videoda sık yapılan bazı hatalara ve bunların nasıl düzeltileceğine değiniyor.

Yazım hatalarını arayın. JavaScript'in büyük/küçük harfe duyarlı bir dil olduğunu unutmayın.
Temel bilgileri kontrol edin. En yaygın sorunlardan bazıları ilk harita oluşturma aşamasında ortaya çıkar. Örneğin:
- Harita seçeneklerinizde zoom ve center özelliklerini belirttiğinizi onaylayın.
- Haritanın ekranda görüneceği bir div öğesi bildirdiğinizden emin olun.
- Haritanın div öğesinin yüksekliğinin olduğundan emin olun. Varsayılan olarak, div öğeleri 0 yüksekliğinde oluşturulur ve bu nedenle görünmezdir.
Referans uygulama için örneklerimize göz atın.
Sorunları belirlemenize yardımcı olması için Chrome Geliştirici Araçları'nda bulunan gibi bir JavaScript hata ayıklayıcı kullanın. JavaScript konsolunda hata olup olmadığına bakarak başlayın.
Sorularınızı Stack Overflow'a gönderin. Etkileyici sorular yayınlamayla ilgili yönergeleri Destek sayfasında bulabilirsiniz.