Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Fehlerbehebung

Entwickler im Europäischen Wirtschaftsraum (EWR)

Nachdem Sie eine Anfrage gesendet haben, erhalten Sie möglicherweise eine Antwort mit Fehlerdetails.

2D-Kacheln und Street View-Bilder

In der folgenden Liste sind die Fehler aufgeführt, 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

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

notFound, invalid

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

Bei regulären Kartenkacheln hängt die maximale Zoomstufe von der jeweiligen Kartenkachel und den angeforderten Kartenoptionen ab.
Bei regulären Kartenkacheln muss die x-Koordinate im Bereich [0, (2^Zoom) – 1] liegen.
Bei regulären Kartenkacheln muss die y-Koordinate im Bereich [0, (2^(Zoom – 1)) – 1] liegen.
Bei Street View-Kacheln muss die Zoomstufe zwischen 0 und 5 liegen (einschließlich).
Bei Street View-Kacheln sind die Bereiche für die x- und y-Koordinaten bis zur Zoomstufe 5 mit denen für reguläre Kartenkacheln identisch. An diesem Punkt werden die Maximalwerte durch imageHeight oder imagewidth geteilt durch tileHeight oder tileWidth bestimmt.

forbidden:

Mögliche Ursachen:

In der Anfrage fehlt ein gültiger API-Schlüssel.
Nachricht: Your request cannot be served. Please ensure the parameters and request type are valid for your account and region.

2D-Satellitenkacheln sind in Projekten, die mit einem Rechnungskonto mit einer Adresse im Europäischen Wirtschaftsraum (EWR) verknüpft sind, nicht verfügbar. Weitere Informationen finden Sie unter Anpassungen der Map Tiles API für EWR Kunden.

expired

Ihr session-Token ist abgelaufen. Ein Sitzungstoken ist ab dem Zeitpunkt seiner Erstellung zwei Wochen lang gültig. Diese Gültigkeitsdauer kann sich ohne Vorankündigung ändern. Wenn dieser Fehler auftritt, müssen Sie ein neues Sitzung token abrufen, wie unter Sitzungstokens verwenden beschrieben.

badRequest

Ihre Anfrage war fehlerhaft. Einige häufige Ursachen sind:

Sie haben einen terrain-Kartentyp angegeben, ohne eine roadmap-Ebene einzufügen.
Sie haben ein styles-Array für einen Kartentyp ohne Straßenkarte eingefügt.
Sie haben in einer Street View-Metadatenanfrage einen Wert für den Breiten-/Längengrad sowie eine Panorama-ID gesendet.

quotaExceeded, rateLimitExceeded

Ihre Anwendung hat das zulässige Kontingent oder die zulässige Anzahl von Anfragen 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 Ausfälle die Google-Server nicht überlasten. Viele Clients versuchen, Anfragen in schneller Folge zu wiederholen. Das bedeutet, dass Sie den exponentiellen Backoff verwenden müssen, wenn Sie Anfragen wiederholen. Der exponentielle Backoff zwingt Sie, Ihre Anfragen zeitlich zu verteilen, damit sich der Server erholen kann.

Wenn eine Anfrage fehlschlägt, versuchen Sie es nach einer Sekunde noch einmal. Wenn auch dieser Versuch fehlschlägt, wiederholen Sie die Anfrage nach zwei Sekunden. Wenn auch diese Anfrage fehlschlägt, versuchen Sie es nach vier Sekunden noch einmal. So verteilen Sie jede nachfolgende Anfrage, indem Sie die Zeit zwischen den Anfragen einfach verdoppeln.

3D-Kacheln

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

Fehler beim Kachel-Renderer

Der CesiumJS-Renderer schlägt beispielsweise in der Regel ohne Fehlermeldung fehl, wenn Serverfehler auftreten. Dies kann zu Abstürzen, leeren Bildschirmen oder dazu führen, dass bestimmte Kacheln nicht geladen werden.

Die Methode, mit der Sie Serverfehler beheben, hängt vom jeweiligen Renderer ab. Bei browserbasierten Renderern wie CesiumJS können Sie den Netzwerkverkehr mit den in den meisten Browsern integrierten Tools untersuchen. 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.
400: Ungültiger Wert: Achten Sie darauf, dass der Kartentyp, mit dem die createSessionToken-Anfrage gestellt wurde, mit dem mapType übereinstimmt, der im nachfolgenden Kachel-Endpunkt verwendet wird. Ein streetview-Sitzungstoken kann beispielsweise nicht verwendet werden, um eine roadmap-Kachel anzufordern.

403: Berechtigung verweigert