Fehlermeldungen in der Maps Static API

Die Maps Static API kann einen Fehler oder eine Warnung ausgeben, wenn etwas falsch. In diesem Leitfaden werden die einzelnen Fehlermeldungen erläutert und es werden weitere Schritte zur Fehlerbehebung beschrieben.

Unzulässige Anforderungen

Bei einer ungültigen Anfrage gibt die Maps Static API Ein HTTP-Statuscode 4xx und eine Nachricht mit einer Beschreibung der Problem. Nachstehend finden Sie Beispiele für die Fehlerbedingungen. Hinweis: Dies ist keine 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 einen fehlenden erforderlichen Parameter. Beispielsweise liegt der Parameter size nicht im erwarteten Bereich der numerischen Werte oder fehlt in der Anfrage. 400 BAD REQUEST
Der in der Anforderung enthaltene API-Schlüssel ist ungültig. 403 FORBIDDEN

Fehler, die das Anzeigen einer Karte verhindern

Wenn die Anfrage gültig ist, aber ein anderer Fehler auftritt, der die Anzeige der Karte verhindert, gibt die Maps Static API je nach Fehler entweder Text oder ein Fehlerbild zurück. Ein Beispiel für einen solchen Fehler Bedingung ist, wenn die Anwendung ihre Nutzungslimits.

Anstelle der Karte angezeigtes Fehlerbild
Abbildung: Ein Fehlerbild wird anstelle einer Karte angezeigt

Wenn Sie die Maps Static API ohne API-Schlüssel verwenden oder die Abrechnung nicht aktiviert ist, wird auf der Seite ein Fehlerbild statt eines -Karte mit einem Link, der den Fehlertyp angibt. Beispiel: „g.co/staticmaperror/key“.

Schlüssellose Fehler und Lösungen
Nutzungsbeschränkungsfehler: angegebenes Tageslimit für Kartenaufrufe überschritten Sie verwenden die Maps Static API ohne API-Schlüssel. Bis beheben, müssen Sie:
  1. API-Schlüssel anfordern
  2. Abrechnung aktivieren
  3. URL signieren
Fehler bei Nutzungsbeschränkungen: Bei Anfrage-URLs fehlt die digitale Signatur In Ihrer Anfrage fehlt eine digitale Signatur (erforderlich). Um das Problem zu beheben, URL signieren

Warnungen

Bei einigen Fehlerbedingungen gibt die API eine Karte zurück. Einige Informationen können jedoch auf der Karte fehlen. In diesem Fall werden Sie auf zwei Arten über die Warnung informiert.

  • Erstens wird die Karte angezeigt, allerdings mit einer gelben Fehlerleiste, oben auf der Karte mit dem Text „Map error: g.co/staticmaperror“.
  • Zweitens: 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 markers-Parameter:

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 jedoch eine überlagerte gelbe Fehlerleiste an. über dem Bild mit „Map error: 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 als HTTP-Header ausgeben kann:

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, abhängig von dem Element, bei dem die Geocodierung fehlgeschlagen (center, Markierung, sichtbar oder Pfad) und die Anzahl der Elemente der fehlgeschlagen ist. Ein Beispiel für diese Warnung ist X-Staticmap-API-Warning:Error geocoding: marker 1, als wie im obigen Beispiel dargestellt.
Too many geocoded markers requested (max is 15). In der Anfrage wird mehr als die maximal zulässige Anzahl von Markierungen angegeben. mit einer visuell lesbaren Adresse. Der Maximalwert beträgt 15. Beachten Sie, dass dieses Limit gilt nur für Markierungen, die als visuell lesbare Adresse erfordert Geocoding. Sie gilt nicht für Markierungen, die mit Längen- und Breitengrade angeben.
Too many geocoded polyline vertices requested (max is 15). In der Anfrage ist eine größere Anzahl von Polylinien mit einer visuell lesbaren Adresse angegeben als zulässig. Der Maximalwert beträgt 15. Beachten Sie, dass dieses Limit gilt nur für Polylinien mit Scheitelpunkten, die als für Menschen lesbare Adressen angegeben sind, Geocoding ist erforderlich. Sie gilt nicht für Polylinien, die mit Breiten- und Längengradkoordinaten angegeben sind.

Sie finden die HTTP-Header-Warnungen in der Chrome DevTools-Konsole, der Firefox-Webkonsole oder in anderen ähnlichen Tools in Ihrem Browser.