Maps Demo Key alın: Maps Demo Key ile belirli Maps JavaScript API ve Places UI Kit özelliklerini ücretsiz olarak deneyin. Fatura bilgisi gerekmez.

Google, içerikleri tercih ettiğiniz dile çevirmek için yapay zeka teknolojisini kullanır. Yapay zeka çevirilerinde hata olabilir.

Sorun giderme

API Anahtarı ve Faturalandırma Hataları

Belirli durumlarda, "yalnızca geliştirme amaçlı" metniyle filigran eklenmiş karartılmış bir harita veya "negatif" Street View görüntüsü gösterilebilir. Bu davranış genellikle API anahtarı veya faturalandırmayla ilgili sorunlar olduğunu 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?

API anahtarı, Maps JavaScript API'yi yüklemek için kullanılan URL'de key parametresi olarak iletilir. API anahtarı kullanıp kullanmadığınızı kontrol etmek için birkaç seçeneği aşağıda bulabilirsiniz:

Google Haritalar Platformu API Checker Chrome uzantısını kullanın. Bu sayede, web sitenizin Google'ın lisanslı Maps 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 bu 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 kodda YOUR_API_KEY yerine API anahtarınızı girin.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
Tarayıcıda web siteniz tarafından oluşturulan ağ trafiğini kontrol edin. Chrome'da bu, DevTools Ağ sekmesi kullanılarak görüntülenebilir. Web sitenizin yaptığı ağ isteklerini burada görebilirsiniz. Maps JavaScript API kullanılarak yapılan istekler maps/api/js yolunda yer alır. Burada, isteklerin key parametresini kullanıp kullanmadığını onaylayabilirsiniz. Ağ sekmesini görüntülerken ağ trafiğinizi maps/api/js ile filtrelemek yararlı 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 sayfasındaki talimatların tamamını uygulayın.
Başlayın

Evet, API anahtarı kullanıyorum.

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

Projenize bağlı bir faturalandırma hesabı var mı?

Emin değilim. Projeme bir faturalandırma hesabı eklenip eklenmediğini nasıl kontrol edebilirim?

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

Sol taraftaki çubukta Google Haritalar Platformu > Kimlik bilgileri bölümünden erişilebilen Kimlik bilgileri bölümüne gidin.
Web sitenizde kullandığınız API anahtarının listede yer aldığından emin olun. Durum böyle değilse farklı bir projeye geçip kimlik bilgilerini orada kontrol edin.
API anahtarınızın projesini bulamıyorsanız bu projeye erişiminizi kaybetmiş olabilirsiniz. Kuruluşunuzdaki diğer kullanıcılardan yardım isteyin. Orijinal proje bulunamıyorsa şunları yapmanız gerekir:
1. Yeni bir proje oluşturun. Bunu yapmak için proje listesinden Yeni Proje'yi veya Kaynak Yöneticisi sayfasından Proje Oluştur'u seçebilirsiniz.
2. Yeni bir API anahtarı oluşturma. Bu işlem Kimlik bilgileri sayfasında yapılabilir. Bu sayfada Kimlik bilgileri oluştur'u tıklayın ve ardından API anahtarı'nı seçin.

Projenizi Cloud Console'da bulduktan sonra, sol taraftaki menüden Faturalandırma bölümüne giderek bir faturalandırma hesabının ekli olup olmadığını kontrol edin.

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

Cloud Console'da 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ı ekli.

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

Sağlanan ödeme 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 kendi belirlediğiniz günlük sınır aşıldı mı?

API'lerinizden herhangi birinde günlük sınır belirlediyseniz (beklenmedik artışları önlemek için bu yaygın bir uygulamadır) günlük sınırınızı artırarak bu sorunu çö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çin ve Kotalar sekmesini tıklayın.

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

IP adresleri 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, Geocoding Hizmeti'ne bakın). Maps JavaScript API istemci tarafı hizmetlerini kullanmak için HTTP yönlendirenleri kısıtlamasıyla güvenli hale getirilebilecek ayrı bir API anahtarı oluşturmanız gerekir (API anahtarı alma, ekleme ve kısıtlama başlıklı makaleyi inceleyin).

Kodunuz çalışmıyorsa:

Brendan Kenny ve Mano Marks, harita kodunuzu çalışır duruma getirmenize yardımcı olmak için bu videoda bazı yaygın hataları ve bunların nasıl düzeltileceğini açıklıyor.

Yazım hatası olup olmadığını kontrol edin. 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 sırası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 tanımladığınızdan emin olun.
- Harita için div öğesinin sıfır olmayan açık bir CSS yüksekliğine (ör. height: 400px) sahip olduğundan emin olun. Varsayılan olarak div öğeleri 0 yüksekliğinde oluşturulur ve bu nedenle görünmez.
Referans uygulama için örneklerimizi inceleyin.
Sorunları belirlemenize yardımcı olması için Chrome Geliştirici Araçları'nda bulunan gibi bir JavaScript hata ayıklayıcısı kullanın. JavaScript konsolunda InvalidKeyMapError veya ApiNotActivatedMapError gibi hatalar olup olmadığına bakarak başlayın ve bunları çözmek için Hata Mesajları kılavuzuna bakın.
Sorularınızı Stack Overflow'da yayınlayın. İyi sorular sormayla ilgili yönergeleri Destek sayfasında bulabilirsiniz.