Seien Sie im Dezember beim nächsten Google Maps Platform Developer Community Day in San Francisco dabei. Jetzt bewerben

Google verwendet KI-Technologie, um Inhalte in Ihre bevorzugte Sprache zu übersetzen. KI-Übersetzungen können Fehler enthalten.

Fehlerbehebung

Entwickler im Europäischen Wirtschaftsraum (EWR)

Nachdem Sie eine Anfrage gestellt 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.

Fehler beim Auflisten

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

Die Werte für x, y oder z liegen außerhalb des gültigen Bereichs.

Bei regulären 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 regulären Karten-Tiles muss die Y-Koordinate im Bereich [0, (2^(zoom-1))-1] liegen.
Für Street View-Kacheln muss der Zoom zwischen null und fünf liegen.
Bei Street View-Kacheln sind die x- und y-Koordinatenbereiche bis zur Zoomstufe 5 mit denen normaler Kartenkacheln identisch. An diesem Punkt sind die Höchstwerte imageHeight oder imagewidth geteilt durch tileHeight oder tileWidth.

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 Kunden im EWR.

expired

Ihr session-Token ist abgelaufen. Ein Sitzungstoken ist ab dem Erstellungszeitpunkt zwei Wochen lang gültig. Beachten Sie, dass sich dies ohne vorherige Ankündigung ändern kann. Wenn Sie diesen Fehler erhalten, müssen Sie ein neues Sitzungstoken anfordern, wie unter Sitzungstokens verwenden beschrieben.

badRequest

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

Sie haben einen Kartentyp terrain angegeben, ohne eine roadmap-Ebene einzufügen.
Sie haben ein styles-Array für einen Kartentyp angegeben, der nicht „roadmap“ ist.
Sie haben in einer Street View-Metadatenanfrage einen Breiten-/Längengradwert 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 bei der Wiederholung Ihrer Anfragen einen exponentiellen Backoff verwenden müssen. Der exponentielle Backoff zwingt Sie, Ihre Anfragen zeitlich zu verteilen, damit der Server Zeit hat, sich zu erholen.

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

3D-Kacheln

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

Fehler beim Kachel-Renderer

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

Die Methode, die Sie zum Beheben von Serverfehlern verwenden, hängt vom jeweiligen Renderer ab. Bei browserbasierten Renderern wie CesiumJS können Sie den Netzwerkverkehr mit Tools prüfen, die in die meisten Browser integriert sind. Sie können beispielsweise die Chrome-Entwicklertools verwenden.

Häufige Fehler

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

400: Ungültiges Argument: Ungültige API-Schlüssel, Suchparameter, Kachel-/Tileset-IDs oder ein abgelaufenes Sitzungstoken.
400: Ungültiger Wert: Achten Sie darauf, dass der createSessionToken-Anfragetyp mit dem mapType-Anfragetyp im nachfolgenden Tile-Endpunkt übereinstimmt. Beispiel: Ein streetview-Sitzungstoken kann nicht verwendet werden, um eine roadmap-Kachel anzufordern.

403: Permission denied