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:
- Fehlender oder ungültiger API-Schlüssel. Achten Sie darauf, dass Ihre Anfrage einen gültigen API-Schlüssel enthält, um diesen Fehler zu beheben. API-Schlüssel anfordern
- Die Maps Embed API ist für Ihr Projekt nicht aktiviert. APIs aktivieren und deaktivieren
- Der API-Schlüssel verstößt gegen eine Einschränkung. Weitere Informationen zu Best Practices für API-Schlüssel
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:
- Die Abrechnung wurde in Ihrem Konto nicht aktiviert. Aktivieren Sie die Abrechnung.
- Die angegebene Abrechnungsmethode ist ungültig (z. B. eine abgelaufene Kreditkarte). Um das Problem zu beheben, rufen Sie die Google Cloud Console auf und prüfen Sie, ob Sie eine gültige Zahlungsmethode angegeben haben.
- Ein selbst auferlegtes Tageslimit wurde überschritten. Informationen zum Aufrufen oder Ändern von Abrechnungslimits pro Tag
- In der Anfrage fehlt ein HTTP-Referrer und Sie verwenden einen API-Schlüssel mit Einschränkung auf Verweis-URLs. Weitere Informationen zum Hinzufügen von Verweis-URLs
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.
- Konsole für Internet Explorer
- Webkonsole für Firefox
- Remote-Debugging für Android
- Web Inspector für iOS
In Chrome können Sie die JavaScript-Konsole verwenden, um die Konsolenausgabe zu prüfen. Gehen Sie dazu so vor:
- Wählen Sie das Menüsymbol > Weitere Tools > Entwicklertools aus, um die Entwicklertools zu öffnen.
- 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.