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:

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ıyorsunuzdur:

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 bilgi, 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.

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

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

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şkilendirildiğini onaylamak için:

  1. Sol taraftaki Google Haritalar Platformu > Kimlik Bilgileri bölümünden Kimlik Bilgileri'ne gidin.
  2. 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.
  3. 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şlemi Kimlik Bilgileri sayfasından yapabilirsiniz. Bu sayfaya geldiğinizde Kimlik bilgileri oluştur'u tıklayın ve ardından API anahtarı'nı seçin.

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

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

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

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

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

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

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

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 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 işleminde 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.
    • 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ünmez.
    Referans uygulama için örneklerimize göz atın.
  • Chrome Geliştirici Araçları'nda bulunanlar gibi bir JavaScript hata ayıklayıcı kullanarak sorunları tespit edebilirsiniz. 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.