Fehlermeldungen

Auf dieser Seite werden die Fehlermeldungen beschrieben, die von der Maps Embed API zurückgegeben werden können. Wenn ein Fehler auftritt, zeigt die Maps Embed API den Fehlermeldungstext anstelle der Karte an. Außerdem können bestimmte Fehlerbedingungen auftreten, die dazu führen, dass eine Karte mit dunklem Wasserzeichen angezeigt wird.

Unzulässige Anforderungen

Bei einer ungültigen Anfrage gibt die Maps Embed API den HTTP-Statuscode 4xx und eine Meldung zurück, in der das Problem beschrieben wird. Nachstehend finden Sie Beispiele für die Fehlerbedingungen. Hinweis: Dies ist keine vollständige Liste der möglichen Fehler. Prüfen Sie den tatsächlichen Fehlercode und die Meldung, die von der API zurückgegeben werden, um Details zu bestimmten Problemen zu erhalten.

Beispiel: Fehlerbedingung Statuscode
Die Anfrage enthält einen ungültigen Parameter oder ein erforderlicher Parameter fehlt. Beispielsweise liegt der Parameter zoom nicht im erwarteten Bereich numerischer Werte oder ein erforderlicher Parameter fehlt in der Anfrage. 400 BAD REQUEST
Der in der Anforderung enthaltene API-Schlüssel ist ungültig. 403 FORBIDDEN

API-Schlüssel- und QPS-Fehler

Fehler des API-Schlüssels und der Abfragen pro Sekunde werden als ungültige Anfragen behandelt. Mögliche Ursachen:

Abrechnungs- und HTTP-Referrer-URL-Fehler

Eine abgedunkelte Karte oder ein „negatives“ Street View-Bild mit dem Wasserzeichen „Nur für Entwicklungszwecke“ wird zurückgegeben, wenn eine der folgenden Bedingungen zutrifft:

Fehler im Browser überprüfen

Bei Abrechnungs- und HTTP-Referrer-URL-Fehlern schreibt die Maps Embed API Fehlermeldungen in window.console. Bei ungültigen Anfragen (einschließlich API-Schlüssel- und Abfragen pro Sekunde-Fehlern) wird in der Konsole nur der HTTP-Statuscode 4xx gemeldet. In diesem Abschnitt wird erläutert, wie Sie die Konsolenausgabe in Google Chrome überprüfen können. Wenn Sie einen anderen Browser verwenden, lesen Sie bitte in der Entwicklerdokumentation Ihres Browsers nach. Hier ist eine Liste mit Tools, mit denen Sie die Konsolenausgabe in einigen anderen Browsern prüfen können.

In Chrome können Sie die JavaScript-Konsole verwenden, um die Konsolenausgabe zu prüfen. Gehen Sie dazu so vor:

  1. Wählen Sie das Menüsymbol > Weitere Tools > Entwicklertools aus, um die Entwicklertools zu öffnen.
  2. Klicken Sie zum Öffnen der JavaScript-Konsole oben im Fenster der Entwicklertools auf den Tab Konsole. Sie können auch die Esc-Taste verwenden, um die JavaScript-Konsole ein-/auszuschalten.