Bu sayfada, Maps Embed API'nin döndürebileceği hata mesajları açıklanmaktadır. Bir hata oluştuğunda Maps Embed API, harita yerine hata mesajı metni sunar. Bazı hata koşulları da yaşanabilir ve bu durum, koyu renkli bir filigranlı harita görüntülenmesine neden olur.
Geçersiz istekler
Geçersiz bir istek olması durumunda, Maps Embed API bir HTTP 4xx
durum kodu ve sorunu açıklayan bir mesaj döndürür. Aşağıda, bu tür hata durumlarına ilişkin örnekler verilmiştir. Not: Bu liste, olası hataların tam listesi değildir. Belirli sorunların ayrıntıları için lütfen API tarafından döndürülen asıl hata kodunu ve mesajı kontrol edin.
Hata durumu örneği | Durum kodu |
---|---|
İstek geçersiz bir parametre içeriyor veya gerekli bir parametre eksik. Örneğin, zoom parametresi beklenen sayısal değer aralığında değil veya istekte gerekli bir parametre eksik. |
400 BAD REQUEST |
İstekte yer alan API anahtarı geçersiz. | 403 FORBIDDEN |
API anahtarı ve QPS hataları
API anahtarı ve QPS hataları, geçersiz istek olarak ele alınır. Olası nedenler şunlardır:
- Eksik veya geçersiz API anahtarı. Bu hatayı çözmek için isteğinizin geçerli bir API anahtarı içerdiğinden emin olun. API anahtarı alın.
- Projeniz için Maps Embed API etkin değil. API'leri etkinleştirme ve devre dışı bırakma hakkında bilgi edinin.
- API anahtarında kısıtlama ihlali var. API anahtarı en iyi uygulamaları hakkında daha fazla bilgi edinin.
Faturalandırma ve HTTP yönlendiren hataları
Karanlık bir harita veya "yalnızca geliştirme amaçlı" filigranlı"negatif" bir Street View resmi, aşağıdakilerden herhangi biri geçerli olduğunda döndürülür:
- Hesabınızda faturalandırma etkinleştirilmemiştir. Faturalandırmayı etkinleştirin.
- Sağlanan faturalandırma yöntemi geçersiz (örneğin, süresi dolmuş bir kredi kartı). Bu sorunu çözmek için Google Cloud Console'u ziyaret edin ve geçerli bir ödeme yöntemi belirttiğinizden emin olun.
- Belirlenen günlük sınır aşıldı. Günlük faturalandırılabilir sınırları nasıl görüntüleyeceğinizi veya değiştireceğinizi öğrenin.
- İstekte HTTP yönlendireni yok ve yönlendiren tarafından kısıtlanmış bir API anahtarı kullanıyorsunuz. Yönlendiren ekleme hakkında daha fazla bilgi edinin.
Tarayıcınızdaki hatalar kontrol ediliyor
Faturalandırma ve HTTP yönlendiricisi hataları için Maps Embed API, window.console
öğesine hata mesajları yazar. Geçersiz istekler (API anahtarı ve QPS hataları dahil) için konsolda yalnızca HTTP 4xx
durum kodu raporlanır. Bu bölümde, Google Chrome'da konsol çıkışını nasıl kontrol edebileceğiniz açıklanmaktadır. Başka bir tarayıcı kullanıyorsanız lütfen tarayıcınızın
geliştirici belgelerini kontrol edin. Bu liste, bazı diğer tarayıcılarda konsol çıkışını kontrol etmek için kullanılabilecek araçların yer aldığı bir listedir.
- Internet Explorer için Konsol.
- Firefox için Web Konsolu.
- Android için uzaktan hata ayıklama.
- iOS için Web Denetleyicisi.
Chrome'da, konsol çıkışını aşağıdaki gibi kontrol etmek için JavaScript Konsolu'nu kullanabilirsiniz.
- Geliştirici Araçları'nı açmak için menü simgesi > Diğer Araçlar > Geliştirici Araçları'nı seçin.
- JavaScript Konsolu'nu açmak için Geliştirici Araçları penceresinin üst tarafındaki Konsol sekmesini tıklayın. JavaScript Konsolu'nu açıp kapatmak için ESC tuşunu da kullanabilirsiniz.