Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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ıyorsunuzdur:
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.
Web siteniz tarafından oluşturulan ağ trafiğini tarayıcıda kontrol edin.
Chrome'da bu bilgi, DevToolsAğ 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.
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'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:
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:
Yeni bir proje oluşturun. Proje listesinden Yeni Proje'yi seçerek veya Kaynak Yöneticisi sayfasındanProje Oluştur'u seçerek bu işlemi yapabilirsiniz.
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.
API'de kendiniz belirlediğiniz günlük sınırı aştıysanız
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.
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 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.
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.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-05-13 UTC."],[[["To use the Google Maps JavaScript API, you must include an API key and enable billing for your project."],["If you see a darkened map or a negative Street View image watermarked with \"for development purposes only\", you might have an issue with your API key or billing."],["Troubleshooting steps involve verifying your API key implementation, checking billing account attachment, ensuring billing method validity, and reviewing daily usage limits and IP restrictions."],["This page offers solutions to common billing and API errors, and links to resources for further assistance."]]],["Using the Maps JavaScript API requires a valid API key and enabled billing. Issues like a darkened map typically stem from these. Verify API key usage via browser checks, source code, or network traffic. Ensure the project linked to your API key has an active billing account. Check for invalid payment methods or exceeded API daily limits. If restricted by IP address, create a key with HTTP referrers. Troubleshoot by checking for typos, verifying map element properties, or using a JavaScript debugger.\n"]]