Auf dieser Seite werden die Fehlermeldungen beschrieben, die vom Maps Embed API. Wenn ein Fehler auftritt, Die Maps Embed API zeigt anstelle der Karte eine Fehlermeldung an. Es können auch bestimmte Fehlerbedingungen auftreten, die zur Anzeige einer dunkler Karte mit Wasserzeichen.
Unzulässige Anforderungen
Bei einer ungültigen Anfrage gibt die Maps Embed API
Ein HTTP-Statuscode 4xx und eine Nachricht mit einer Beschreibung der
Problem. Nachstehend finden Sie Beispiele für die Fehlerbedingungen. Hinweis: Dies ist kein
eine vollständige Liste der möglichen Fehler. Überprüfe den tatsächlichen Fehlercode.
und eine Nachricht, die von der API zurückgegeben wird, um Details zu bestimmten Problemen zu erhalten.
| Beispiel: Fehlerbedingung | Statuscode |
|---|---|
Die Anfrage enthält einen ungültigen Parameter oder ein erforderlicher Parameter ist
fehlen. Der Parameter zoom befindet sich beispielsweise nicht im
erwarteter 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 Kontingentfehler
API-Schlüssel- und Kontingentfehler werden als ungültige Anfragen behandelt. Mögliche Ursachen umfassen Folgendes:
- API-Schlüssel fehlt oder ist ungültig. Um diesen Fehler zu beheben, -Anfrage einen gültigen API-Schlüssel enthält. Fordern Sie einen API-Schlüssel an.
- Die Maps Embed API ist für Ihr Projekt nicht aktiviert. Weitere Informationen Aktivieren und Deaktivieren von APIs
- Für den API-Schlüssel liegt ein Einschränkungsverstoß vor. Lesen Best Practices für API-Schlüssel
Fehler bei der Abrechnung und bei der HTTP-Referrer-URL
Eine verdunkelte Karte bzw. ein "negativ" Street View-Bild, mit Wasserzeichen "für nur zu Entwicklungszwecken.“ wird zurückgegeben, wenn eine der folgenden Bedingungen zutrifft:
- Die Abrechnung wurde für Ihr Konto nicht aktiviert. Aktivieren Sie die Abrechnung.
- Die angegebene Abrechnungsmethode ist ungültig (z. B. ein abgelaufenes Guthaben). . Um dieses 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. Hier erfahren Sie, wie Sie die täglichen Abrechnungslimits aufrufen oder ändern.
- In der Anfrage fehlt eine HTTP-Referrer-URL und Sie verwenden eine API-Schlüssel mit Verweis-URL. Informationen Weitere Informationen zum Hinzufügen von Referrern
Fehler im Browser überprüfen
Bei Abrechnungs- und HTTP-Referrer-Fehlern schreibt die Maps Embed API
Fehlermeldungen an window.console. Bei ungültigen Anfragen (einschließlich
API-Schlüssel- und Kontingentfehler) angezeigt wird, wird nur der HTTP-Statuscode 4xx gemeldet.
in der Konsole. In diesem Abschnitt wird erläutert, wie Sie die Konsolenausgabe in
Google Chrome Falls Sie einen anderen Browser verwenden, prüfen Sie bitte den Entwickler
Dokumentation für Ihren Browser. Hier finden Sie eine Liste mit Tools,
die Konsolenausgabe
in einigen anderen Browsern prüfen.
- 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 um die Konsolenausgabe zu überprüfen.
- Um die Entwicklertools zu öffnen, wähle das Menüsymbol > Weitere Tools > Entwicklertools.
- Um die JavaScript-Konsole zu öffnen, klicken Sie oben im Fenster „Entwicklertools“ öffnen. Mit der Esc-Taste können Sie zwischen JavaScript-Konsole.