Fehlermeldungen in der Maps Static API

Wenn ein Fehler auftritt, gibt die Maps Static API möglicherweise einen Fehler oder eine Warnung aus. In diesem Leitfaden werden die einzelnen Fehlermeldungen erläutert und weitere Informationen zum Beheben von Fehlern gegeben.

Unzulässige Anforderungen

Bei einer ungültigen Anfrage gibt die Maps Static 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 size 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 die Anzeige der Karte verhindert, 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 tritt auf, wenn die Anwendung ihre Nutzungslimits überschreitet.

Anstelle der Karte angezeigtes Fehlerbild
Abbildung: Anstelle einer Karte wird ein Fehlerbild 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 anstelle einer Karte ein Fehlerbild mit einem Link angezeigt, der den Fehlertyp angibt. Beispiel: "g.co/staticmaperror/key".

Schlüssellose Fehler und Lösungen
Nutzungslimitfehler: vorgegebenes Tageslimit für Kartenaufrufe überschritten Sie verwenden die Maps Static API ohne API-Schlüssel. So beheben Sie das Problem:
  1. API-Schlüssel anfordern
  2. Abrechnung aktivieren
  3. URL signieren
Nutzungslimitfehler: digitale Signatur in Anfrage-URLs fehlt In deiner Anforderung fehlt eine digitale Signatur (erforderlich). Signieren Sie Ihre URL, um das Problem zu beheben.

Warnungen

Bei einigen Fehlerbedingungen gibt die API zwar eine Karte zurück, doch fehlen möglicherweise einige Informationen auf der Karte. In diesem Fall werden Sie durch zwei Bedingungen über die Warnung informiert.

  • Erstens: Die Karte wird angezeigt, aber mit einer gelben Fehlerleiste über der Karte und dem Text „Map error: g.co/staticmaperror“.
  • Zweitens gibt die API eine Warnung in Form des HTTP-Headers 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 gelbe Fehlerleiste, die über das Bild gelegt ist, 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 von der API als HTTP-Header ausgegeben werden können:

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 Meldung, je nach dem Element, bei dem das Geocoding fehlgeschlagen ist (Zentrierung, Markierung, Sichtbarkeit oder Pfad) und der Anzahl der Elemente, bei denen Fehler aufgetreten sind. Ein Beispiel für diese Warnung ist X-Staticmap-API-Warning:Error geocoding: marker 1, wie im Beispiel oben gezeigt.
Too many geocoded markers requested (max is 15). In der Anfrage wird die maximal zulässige Anzahl von Markierungen mit einer visuell lesbaren Adresse überschritten. Der Maximalwert beträgt 15. Diese Beschränkung gilt nur für Markierungen, die als visuell lesbare Adressen angegeben werden, für die eine Geocodierung erforderlich ist. Sie gilt nicht für Markierungen, die mit Breiten- und Längengradkoordinaten angegeben werden.
Too many geocoded polyline vertices requested (max is 15). In der Anfrage wird die zulässige Höchstzahl von Polylinien mit einer visuell lesbaren Adresse überschritten. Der Maximalwert beträgt 15. Diese Beschränkung gilt nur für Polylinien mit Eckpunkten, die als für Menschen lesbare Adressen angegeben sind und eine Geocodierung erfordern. Polylinien, die mit Breiten- und Längengradkoordinaten angegeben werden, sind davon nicht betroffen.

Du kannst die HTTP-Header-Warnungen in der Chrome-Entwicklertools-Konsole, der Firefox-Webkonsole oder anderen entsprechenden Tools in deinem Browser ansehen.