Fehlermeldungen in der Maps Static API

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Die Maps Static API kann einen Fehler oder eine Warnung ausgeben, wenn etwas nicht funktioniert. In diesem Leitfaden werden die einzelnen Fehlermeldungen und weitere Anleitungen zum Beheben von Fehlern erläutert.

Unzulässige Anforderungen

Bei einer ungültigen Anfrage gibt die Maps Static API den HTTP-Statuscode 4xx und eine Nachricht 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 von der API zurückgegebene Meldung auf Details zu bestimmten Problemen.

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

Fehler, die die Anzeige einer Karte verhindern

Wenn die Anfrage gültig ist, aber ein anderer Fehler auftritt, der verhindert, dass die Karte angezeigt wird, gibt die Maps Static API je nach Fehler entweder Text oder ein Fehlerbild anstelle der Karte zurück. Ein Beispiel für eine solche Fehlerbedingung ist, wenn die Anwendung ihre Nutzungslimits überschreitet.

Anstelle der Karte angezeigtes Fehlerbild
Abbildung: Es wird ein Fehlerbild anstelle einer Karte angezeigt

Wenn Sie die Maps Static API ohne API-Schlüssel verwenden oder die Abrechnung für Ihr Konto nicht aktiviert ist, wird auf der Seite ein Fehlerbild anstelle einer Karte mit einem Link angezeigt, der die Art des Fehlers angibt. Beispiel: "g.co/staticmaperror/key"

Schlüssellose Fehler und Lösungen
Fehler bei den Nutzungslimits: Das tägliche Limit für Kartenaufrufe wurde überschritten Sie verwenden die Maps Static API ohne API-Schlüssel. So beheben Sie das Problem:
  1. API-Schlüssel abrufen
  2. Abrechnung aktivieren
  3. URL signieren
Fehler durch Nutzungslimits: Fehlende digitale Signatur bei Anfrage-URLs In Ihrer Anfrage fehlt eine digitale Signatur (erforderlich). So kannst du das Problem beheben: URL signieren

Warnungen

Bei einigen Fehlerbedingungen gibt die API eine Karte zurück, einige Informationen fehlen jedoch. In diesem Fall werden Sie über zwei Bedingungen auf die Warnung hingewiesen.

  • Erstens: Die Karte wird angezeigt, aber mit einer gelben Fehlerleiste über dem Kartentext mit dem Text "Map error: g.co/staticmaperror".
  • 2. Die API gibt eine Warnung in Form eines HTTP-Headers mit dem Namen X-Staticmap-API-Warning zurück.

Die folgende URL enthält beispielsweise einen unerwarteten Wert im Parameter markers:

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY

Die API gibt eine Karte zurück, zeigt aber einen gelben Fehlerbalken über dem Bild mit dem Fehler: g.co/staticmaperror":

Die Karte wird angezeigt, aber mit Map error: g.co/staticmaperror

Außerdem gibt die API den folgenden HTTP-Header zurück:

X-Staticmap-API-Warning:Error geocoding: marker 1

In der folgenden Tabelle werden die Warnungen beschrieben, die die API möglicherweise als HTTP-Header ausgibt:

Warnungen in X-Staticmap-API-Warning Headern
Error geocoding: [center, ][marker #number, ][visible #num, ][path #num, ]* Bei dem Versuch, das Geocoding für die Anforderung auszuführen, ist ein Fehler aufgetreten. Es gibt viele Varianten dieser Nachricht, je nachdem, bei welchem Element das Geocoding fehlgeschlagen ist (Zentrum, Markierung, sichtbar oder Pfad) und wie viele Elemente fehlgeschlagen sind. Ein Beispiel für diese Warnung ist X-Staticmap-API-Warning:Error geocoding: marker 1, wie im obigen Beispiel gezeigt.
Too many geocoded markers requested (max is 15). Die Anfrage gibt mehr als die maximal zulässige Anzahl an Markierungen mit menschenlesbarer Adresse an. Der Maximalwert beträgt 15. Diese Beschränkung gilt nur für Markierungen, die als menschenlesbare Adresse angegeben sind und die eine Geocodierung erfordern. Sie gilt nicht für Markierungen, die mit Breiten- und Längengraden angegeben werden.
Too many geocoded polyline vertices requested (max is 15). Die Anfrage gibt mehr als die maximal zulässige Anzahl von Polylinien mit einer für Menschen lesbaren Adresse an. Der Maximalwert beträgt 15. Dieses Limit gilt nur für Polylinien mit Eckpunkten, die als menschenlesbare Adressen angegeben sind, die eine Geocodierung erfordern. Sie gilt nicht für Polylinien, die mit Breiten- und Längengraden angegeben werden.

HTTP-Header-Warnungen werden in der Chrome-Entwicklertools-Konsole, in der Firefox-Webkonsole und in anderen gleichwertigen Tools in deinem Browser angezeigt.