Hata Mesajları

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:

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:

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.

Chrome'da, konsol çıkışını aşağıdaki gibi kontrol etmek için JavaScript Konsolu'nu kullanabilirsiniz.

  1. Geliştirici Araçları'nı açmak için menü simgesi > Diğer Araçlar > Geliştirici Araçları'nı seçin.
  2. 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.