Fehlermeldungen in der Maps Static API

Die Maps Static API gibt einen Fehler oder eine Warnung aus, wenn eine Anfrage fehlschlägt. In diesem Leitfaden werden die Fehlermeldungen erläutert und Anleitungen zur Behebung der Fehler 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, wie in der folgenden Liste dargestellt. Prüfen Sie den tatsächlichen Fehlercode und die Meldung, die von der API zurückgegeben werden, um Details zu bestimmten Problemen zu erhalten.

Die Anfrage enthält einen ungültigen Parameter oder ein erforderlicher Parameter fehlt. Der Parameter size liegt beispielsweise 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 verhindern, dass eine Karte angezeigt wird

Wenn die Anfrage gültig ist, aber ein anderer Fehler auftritt, der verhindert, dass die Karte angezeigt wird, gibt die Maps Static API anstelle der Karte entweder Text oder ein Fehlerbild zurück. Ein Fehler tritt beispielsweise auf, wenn die Anwendung ihre Nutzungslimits überschreitet.

Anstelle der Karte angezeigtes Fehlerbild
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
Fehler bei Nutzungslimits: Das bereitgestellte Tageslimit für Kartenaufrufe wurde überschritten Sie verwenden die Maps Static API ohne API-Schlüssel. So beheben Sie diesen Fehler:
  1. API-Schlüssel anfordern
  2. Abrechnung aktivieren
  3. URL signieren
Fehler bei Nutzungslimits: In den Anfrage-URLs fehlt die digitale Signatur. Ihrer Anfrage fehlt eine erforderliche digitale Signatur. Um diesen Fehler zu beheben, signieren Sie Ihre URL.

Warnungen

Bei einigen Fehlerbedingungen gibt die API eine Karte zurück, auf der jedoch einige Informationen fehlen können. In diesem Fall können Sie die Warnung anhand der folgenden Bedingungen erkennen:

  • Die Karte wird mit einem gelben Fehlerbalken überlagert, auf dem der Text „Kartenfehler: g.co/staticmaperror“ zu sehen ist.
  • Die API gibt eine Warnung in Form eines HTTP-Headers namens 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 mit dem Text „Kartenfehler: g.co/staticmaperror“ an:

Karte wird mit dem Fehler „g.co/staticmaperror“ angezeigt
Karte mit einem gelben Warnbalken

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. Je nach Element, bei dem die Geocodierung fehlgeschlagen ist, z. B. center, marker, visible oder path, und der Anzahl der Elemente, bei denen die Geocodierung fehlgeschlagen ist, gibt es viele Varianten dieser Meldung. Ein Beispiel für diese Warnung ist X-Staticmap-API-Warning:Error geocoding: marker 1, wie im vorherigen Beispiel gezeigt.
Too many geocoded markers requested (max is 15). In der Anfrage wird die zulässige maximale Anzahl von Markierungen mit einer lesbaren Adresse überschritten. Der Maximalwert beträgt 15. Dieses Limit gilt nur für Marker, die als menschenlesbare Adresse angegeben werden und für die Geocoding 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 werden mehr als die zulässige maximale Anzahl von Polylinien mit einer lesbaren Adresse angegeben. Der Maximalwert beträgt 15. Dieses Limit gilt nur für Polylinien mit Eckpunkten, die als für Menschen lesbare Adressen angegeben sind, für die Geocoding erforderlich ist. Sie gilt nicht für Polylinien, die mit Breiten- und Längengradkoordinaten angegeben werden.

Die HTTP-Header-Warnungen können Sie in der Chrome-Entwicklertools-Konsole, der Webkonsole von Firefox oder anderen gleichwertigen Tools Ihres Browsers sehen.