Fehlerbehebung

Nach dem Senden einer Anfrage erhalten Sie möglicherweise eine Antwort mit Fehlerdetails.

2D-Kacheln und Street View-Bilder

In der folgenden Liste finden Sie Fehler, die bei der Verwendung von 2D-Kacheln und Street View-Bildern auftreten können.

Fehlerliste

In der folgenden Liste sind die Fehler aufgeführt, die bei der Verwendung der Map Tiles API auftreten können.

required

Ihrer Anfrage fehlt ein URL-Parameter. In der Fehlermeldung wird angegeben, welcher Parameter fehlt.

notFound, invalid

Die Werte für x, y oder z liegen außerhalb des zulässigen Bereichs.

• Bei normalen Kartenkacheln hängt die maximale Zoomstufe von der jeweiligen Kartenkachel und den von Ihnen angeforderten Kartenoptionen ab.

• Bei regulären Kartenkacheln muss die X-Koordinate im Bereich [0, (2^Zoom)-1] liegen.

• Bei normalen Kartenkacheln muss die y-Koordinate im Bereich [0, (2^(Zoom-1))-1] liegen.

• Der Zoom für Street View-Kacheln muss zwischen null und fünf liegen.

• Bei Street View-Kacheln sind die X- und Y-Koordinatenbereiche bis zur Zoomstufe 5 mit denen regulärer Kartenkacheln identisch. An diesem Punkt sind die Maximalwerte imageHeight oder imagewidth geteilt durch tileHeight oder tileWidth.

forbidden: In der Anfrage fehlt ein gültiger API-Schlüssel.

expired

Ihr session-Token ist abgelaufen. Ein Sitzungstoken ist ab dem Zeitpunkt der Erstellung zwei Wochen lang gültig. Dieser Wert kann sich jedoch ohne vorherige Ankündigung ändern. Wenn dieser Fehler auftritt, musst du ein neues Sitzungstoken abrufen, wie unter Sitzungstokens verwenden beschrieben.

badRequest

Ihre Anfrage war fehlerhaft. Häufige Gründe dafür sind:

• Sie haben einen terrain-Kartentyp angegeben, ohne eine roadmap-Ebene einzubeziehen.

• Sie haben ein styles-Array für einen Kartentyp verwendet, der keine Straßenkarte ist.

• Sie haben in einer Street View-Metadatenanfrage einen Wert für „latitude“ (Breitengrad) und „longitude“ (Längengrad) sowie eine Panorama-ID gesendet.

quotaExceeded, rateLimitExceeded

Ihre Anwendung hat das zulässige Kontingent oder die zulässige Anzahl von Abfragen pro Sekunde überschritten.

Beispiel für Fehlermeldung

{
  "error": {
    "code": 403,
    "message": "The request is missing a valid API key.",
    "errors": [
      {
        "message": "The request is missing a valid API key.",
        "domain": "global",
        "reason": "forbidden"
      }
    ],
    "status": "PERMISSION_DENIED"
  }
}

Anfragen wiederholen

Wenn Anfragen mit quotaExceeded und rateLimitExceeded fehlschlagen, sollten Sie die Anfrage so wiederholen, dass fehlerhafte Anfragen oder großflächige Fehler die Google-Server nicht überlasten, da viele Clients versuchen, Anfragen in schneller Folge zu wiederholen. Das bedeutet, dass Sie den exponentiellen Backoff verwenden sollten, wenn Sie Ihre Anfragen wiederholen. Bei der exponentiellen Backoff-Methode müssen Sie Ihre Anfragen zeitlich verteilen, damit der Server sich erholen kann.

Wenn eine Anfrage beispielsweise fehlschlägt, versuchen Sie es nach einer Sekunde noch einmal. Wenn dieser Versuch jedoch auch fehlschlägt, wiederholen Sie die Anfrage nach zwei Sekunden. Wenn auch diese Anfrage fehlschlägt, versuchen Sie es nach vier Sekunden noch einmal. So können Sie jede nachfolgende Anfrage effektiv verteilen, indem Sie einfach den Zeitraum zwischen ihnen verdoppeln.

3D-Kacheln

Fehler vom Google-Server sind möglicherweise nicht offensichtlich, da Sie über einen Renderer auf fotorealistische Kacheln zugreifen, der für die Verarbeitung von Serverfehlern verantwortlich ist.

Fehler beim Kachel-Renderer

Beispielsweise schlägt der CesiumJS-Renderer in der Regel bei Serverfehlern stumm fehl, was zu Abstürzen, leeren Bildschirmen oder dem Nichtladen bestimmter Kacheln führen kann.

Die Methode, mit der Sie Serverfehler beheben, hängt vom verwendeten Renderer ab. Bei browserbasierten Renderern wie CesiumJS können Sie den Netzwerkverkehr mit Tools prüfen, die in den meisten Browsern integriert sind. Sie können beispielsweise die Chrome-Entwicklertools verwenden.

Häufige Fehler

In der folgenden Liste finden Sie Details zu den häufigsten Fehlern, die auftreten können.

400: Ungültiges Argument

Ungültige API-Schlüssel, Abfrageparameter, Kachel-/Kachelsatz-IDs oder ein abgelaufenes Sitzungstoken.

403: Berechtigung verweigert

Es fehlt ein API-Schlüssel, eine SSL-Verbindung oder Ihr API-Schlüssel wurde nicht der Zulassungsliste für 3D-Kacheln hinzugefügt. Wenden Sie sich mit Ihrer Projekt-ID an den Google-Support, um auf die Zulassungsliste für die 3D-Kacheln-Funktion der Map Tiles API gesetzt zu werden.

429: Zu viele Anfragen

Ihr Kontingent ist aufgebraucht. Wenden Sie sich an den Google-Support, um Ihr Kontingent zu erhöhen.