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 anstelle der Karte eine Fehlermeldung an. Bei bestimmten Fehlerbedingungen wird eine dunkle Karte mit einem Wasserzeichen angezeigt.
Unzulässige Anforderungen
Bei einer ungültigen Anfrage gibt die Maps Embed API den HTTP-Statuscode 4xx
und eine Nachricht zurück, die das Problem beschreibt. Nachstehend finden Sie Beispiele für die Fehlerbedingungen. Hinweis: Dies ist keine vollständige Liste der möglichen Fehler. Details zu bestimmten Problemen finden Sie im tatsächlichen Fehlercode und in der Fehlermeldung, die von der API zurückgegeben wird.
Beispiel: Fehlerbedingung | Statuscode |
---|---|
Die Anfrage enthält einen ungültigen Parameter oder einen fehlenden erforderlichen Parameter. Beispielsweise liegt der Parameter zoom nicht im erwarteten Bereich der numerischen 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:
- Fehlender oder ungültiger API-Schlüssel. Um diesen Fehler zu beheben, muss Ihre Anfrage einen gültigen API-Schlüssel enthalten. API-Schlüssel anfordern
- Die Maps Embed API ist für Ihr Projekt nicht aktiviert. Weitere Informationen zum Aktivieren und Deaktivieren von APIs
- Der API-Schlüssel verstößt gegen eine Einschränkung. Weitere Informationen zu Best Practices für API-Schlüssel
Abrechnungs- und HTTP-Referenzfehler
Eine dunkle Karte oder ein „negatives“ Street View-Bild mit dem Wasserzeichen „for development purposes only“ (nur für Entwicklungszwecke) wird zurückgegeben, wenn einer der folgenden Punkte zutrifft:
- Die Abrechnung ist für Ihr Konto nicht aktiviert. Aktivieren Sie die Abrechnung.
- Die angegebene Abrechnungsmethode ist ungültig (z. B. eine abgelaufene Kreditkarte). 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 Ansehen oder Ändern der abrechenbaren Tageslimits
- In der Anfrage fehlt ein HTTP-Referrer und Sie verwenden einen API-Schlüssel mit Referrer-Einschränkungen. Weitere Informationen zum Hinzufügen von Verweisquellen
Fehler im Browser prüfen
Bei Abrechnungs- und HTTP-Referrer-Fehlern schreibt die Maps Embed API Fehlermeldungen in window.console
. Bei ungültigen Anfragen (einschließlich API-Schlüssel- und Kontingentfehlern) wird in der Console nur der HTTP-Statuscode 4xx
gemeldet. In diesem Abschnitt wird erläutert, wie Sie die Konsolenausgabe in Google Chrome prüfen können. Falls 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. Dazu gehen Sie so vor:
- Wählen Sie das Dreipunkt-Menü > Weitere Tools > Entwicklertools aus.
- Klicken Sie oben im Fenster „Entwicklertools“ auf den Tab Konsole, um die JavaScript-Konsole zu öffnen. Sie können die JavaScript-Konsole auch mit der ESC-Taste ein- und ausblenden.