Fehlerbehebung

Nachdem Sie eine Anfrage gestellt haben, erhalten Sie möglicherweise eine Antwort, die Fehler enthält Details.

2D-Kacheln und Street View-Bilder

In der folgenden Liste sind die Fehler aufgeführt, die bei der Verwendung von 2D auftreten können. Kacheln und Street View-Bilder.

Fehler beim Auflisten

In der folgenden Liste sind die Fehler aufgeführt, die bei der Verwendung des Map Tiles API

required

In Ihrer Anfrage fehlt ein URL-Parameter. Beachten Sie, dass in der Fehlermeldung welcher Parameter fehlt.

notFound, invalid

x, y oder z-Werte liegen außerhalb des zulässigen Bereichs.

• Bei normalen Kartenkacheln richtet sich die maximale Zoomstufe nach dem Kartenkachel und in den angeforderten Kartenoptionen.

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

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

• Bei Street View-Kacheln muss die Zoomstufe zwischen 0 und 5 liegen.

• Bei Street View-Kacheln entsprechen die x- und y-Koordinaten für normale Kartenkacheln bis Stufe 5. An diesem Punkt wird das Maximum Werte sind 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 gültig für zwei Wochen nach der Erstellung. Hinweis: Dies kann sich ohne vorherige Ankündigung. Wenn Sie diesen Fehler erhalten, müssen Sie eine neue Sitzung abrufen enthalten, wie in Sitzungstokens verwenden.

badRequest

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

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

• Sie haben ein styles-Array für einen anderen Kartentyp eingefügt.

• Sie haben einen Breiten-/Längenwert und eine Panorama-ID in den Street View-Metadaten gesendet.

quotaExceeded, rateLimitExceeded

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

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 Folgendes tun: Wiederholen Sie Ihre Anfrage so, dass fehlerhafte Anfragen oder groß angelegte Fehler auftreten. die Goodle-Server nicht überfluten, da viele Clients versuchen, Abfolge zu lösen. Das bedeutet, dass Sie exponentieller Backoff wenn Sie Ihre Anfragen wiederholen. Der exponentielle Backoff zwingt Sie dazu, Anfragen rechtzeitig gesendet werden, damit der Server Zeit für die Wiederherstellung hat.

Wenn beispielsweise eine Anfrage fehlschlägt, wiederholen Sie den Vorgang nach einer Sekunde. Aber wenn das schlägt ebenfalls fehl. Wiederholen Sie die Anfrage nach zwei Sekunden. Wenn das schlägt ebenfalls fehl. Versuchen Sie es dann nach vier Sekunden noch einmal. So sorgen Sie dafür, durch Verdoppeln der Zeitspanne zwischen ihnen verdoppeln.

3D-Kacheln

Fehler vom Google-Server sind für Sie möglicherweise nicht offensichtlich, weil Sie fotorealistische Kacheln über einen Renderer, der für die Verarbeitung Serverfehler.

Fehler im Kachel-Renderer

Zum Beispiel schlägt der CesiumJS-Renderer normalerweise ohne Meldung fehl, wenn Serverfehler z. B. Abstürze, leere Bildschirme, Kacheln werden nicht geladen.

Welche Technik Sie zum Beheben von Serverfehlern verwenden, hängt davon ab, den Sie verwenden. Für browserbasierte Renderer wie CesiumJS können Sie prüfen, den Netzwerkverkehr mit den in den meisten Browsern integrierten Tools. So können Sie zum Beispiel nutzen Chrome-Entwicklertools:

Häufige Fehler

Die folgende Liste enthält Details zu den häufigsten Fehlern, die möglicherweise begegnen können.

400: Ungültiges Argument

Ungültige API-Schlüssel, Abfrageparameter, Kachel-/Kachelsatz-IDs oder eine abgelaufene Sitzung Token.

403: Berechtigung verweigert

Fehlender API-Schlüssel, keine SSL-Verbindung oder Ihr API-Schlüssel wurde nicht hinzugefügt zu Zulassungsliste für 3D-Kacheln. Google kontaktieren Support durch Ihre Projekt-ID, um hinzugefügt zu werden auf die Zulassungsliste für die 3D-Kacheln-Funktion der Map Tiles API setzen.

429: Zu viele Anfragen

Ihr Kontingent ist aufgebraucht. Kontakt den Google-Support, um Ihr Kontingent zu erhöhen.