Bu sayfada, Haritalar İçe Aktarma API'si tarafından döndürülebilecek hata mesajları açıklanmaktadır. Hata oluştuğunda Maps Embed API, harita yerine hata mesajı metnini gösterir. Ayrıca, koyulaştırılmış ve filigranlı bir haritanın görüntülenmesine neden olan belirli hata koşulları da ortaya çıkabilir.
Geçersiz istekler
Geçersiz bir istek durumunda Haritalar İçe Aktarma API'si bir HTTP 4xx durum kodu ve sorunu açıklayan bir mesaj döndürür. Hata koşullarına örnek olarak aşağıdakileri verebiliriz. Not: Bu listede olası her hata yer almamaktadır. Belirli sorunların ayrıntıları için API tarafından döndürülen gerçek 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 kota hataları
API anahtarı ve kota hataları geçersiz istek olarak değerlendirilir. Olası nedenler şunlardır:
- API anahtarı eksik veya geçersiz. Bu hatayı düzeltmek için isteğinizin geçerli bir API anahtarı içerdiğinden emin olun. API anahtarı alın.
- Maps Embed API, projenizde 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ı
Aşağıdakilerden herhangi biri geçerli olduğunda "sadece geliştirme amaçları için" filigranlı, karartılmış bir harita veya"negatif" Street View görüntüsü döndürülür:
- Hesabınızda faturalandırma etkinleştirilmedi. Faturalandırmayı etkinleştirin.
- Sağlanan faturalandırma yöntemi geçersizdir (ör. süresi dolmuş bir kredi kartı). Bu sorunu çözmek için Google Cloud Console'u ziyaret edin ve geçerli bir ödeme yöntemi sağladığınızdan emin olun.
- Kendi belirlediğiniz 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 eksik ve yönlendiren kısıtlamalı bir API anahtarı kullanıyorsunuz. Yönlendiren ekleme hakkında daha fazla bilgi edinin.
Tarayıcınızdaki hataları kontrol etme
Faturalandırma ve HTTP yönlendiren hataları için Haritalar İçe Aktarma API'si window.console adresine hata mesajları yazar. Geçersiz istekler (API anahtarı ve kota 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 inceleyin. Diğer bazı tarayıcılarda konsol çıkışını kontrol etmek için kullanabileceğiniz araçların listesini aşağıda bulabilirsiniz.
- Internet Explorer için Konsol.
- Firefox için Web Konsolu.
- Android için uzaktan hata ayıklama.
- iOS için Web İnceleyici.
Chrome'da konsol çıkışını kontrol etmek için JavaScript Konsolu'nu aşağıdaki gibi 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 kısmındaki Konsol sekmesini tıklayın. JavaScript Konsolu'nu açmak veya kapatmak için ESC tuşunu da kullanabilirsiniz.