Fehlerbehebung

Fehler

Im Falle eines Fehlers wird ein Fehlerantworttext im Standardformat zurückgegeben und der HTTP-Statuscode wird auf einen Fehlerstatus gesetzt.

Die Antwort enthält ein Objekt mit einem einzelnen error-Objekt mit den folgenden Schlüsseln:

• code: Dies entspricht dem HTTP-Status der Antwort.
• message: Eine kurze Beschreibung des Fehlers.
• status: Ein Statuscode, der die Art des Fehlers angibt.

Wenn Sie beispielsweise einen ungültigen placeId-Parameter senden, wird der folgende Fehler zurückgegeben:

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

Zu den möglichen Fehlern zählen:

Exponentielle Backoffs

Wenn Anfragen fehlschlagen, sollten Sie sie mit exponentiellem Backoff wiederholen. Wenn eine Anfrage beispielsweise einmal fehlschlägt, wiederholen Sie sie nach einer Sekunde. Wenn sie noch einmal fehlschlägt, wiederholen Sie sie nach zwei Sekunden, dann nach vier Sekunden usw. So wird verhindert, dass Google-Server durch fehlerhafte Anfragen oder großflächige Fehler überlastet werden, da viele Clients versuchen, Anfragen sehr schnell noch einmal zu senden.

Häufig gestellte Fragen zur Fehlerbehebung

Probleme bei der Implementierung

Wie häufig sollte ich den Standort meines Fahrzeugs erfassen?

Für hochwertige Ergebnisse wird ein Intervall von 1 bis 10 Sekunden empfohlen.

Gibt es ein Limit für die Anzahl der Punkte, die ich pro Anfrage senden kann?

Ja, eine Anfrage kann maximal 100 Punkte enthalten.

Welchen Genauigkeitsgrad sollte ich zum Speichern meiner gerundeten Breiten-/Längengradpaare verwenden?

Damit angepasste Pfade auf allen Zoomstufen, auch bei maximaler Zoomstufe, den Straßen folgen, sollten Sie die angepassten Breiten-/Längengradpaare mit einer Genauigkeit von 7 Dezimalstellen speichern.

Kann ich codierte Polylinien verwenden, um angepasste Pfade darzustellen?

Codierte Polylinien werden nur mit einer Genauigkeit von 5 Dezimalstellen angegeben, was zu einem Fehler von etwa 2 Metern führt. Codierte Polylinien sind daher nicht geeignet, wenn die angepassten Pfade bei hohen Zoomstufen der Straße folgen sollen.

Häufige Probleme

Einige Punkte werden nicht angedockt oder es gibt Lücken in angedockten Pfaden. Wie kann ich das korrigieren?

• Wenn Sie Ihre Punkte in regelmäßigen Zeitabständen erfassen, sollten Sie kürzere Intervalle (alle 1 bis 10 Sekunden) verwenden. Wenn ein längeres Intervall verwendet wird (z. B. 60 Sekunden), kann der Algorithmus zum Anpassen an die Straße möglicherweise nicht mit ausreichender Genauigkeit ermitteln, auf welchen Straßen gefahren wurde.
• Wenn Sie manuell auf eine Karte klicken, um Punkte zu erstellen, können Sie ganz einfach Pfade mit wenigen oder spärlichen Punkten erstellen, die vom Snapping-Algorithmus nicht gut verarbeitet werden. Der Algorithmus zum Andocken funktioniert am besten für Punkte, die nah beieinander liegen. Testen Sie Ihre Pfade mit der Demo „An Straßen ausrichten“ oder mit dem Straßen-Inspector.

Warum sind meine gerasterten Pfade zackig oder weichen beim Zoomen leicht von der Straße ab?

• Wird die Genauigkeit der angepassten Breiten-/Längengradpaare vor der Anzeige gekürzt? Wenn Sie angepasste Breiten-/Längengradpaare mit einer Genauigkeit von weniger als 7 Dezimalstellen speichern, führt das zu Ungenauigkeiten, wenn der angepasste Pfad auf der Karte angezeigt wird.
• Verwenden Sie codierte Polylinien? Bei codierten Polylinien werden Breiten-/Längengradpaare auf 5 Dezimalstellen gekürzt. Dadurch entsteht ein Fehler von mehreren Metern, was dazu führt, dass Linien bei hohen Zoomstufen zackig oder leicht von der Straße abweichend dargestellt werden.

Wenn keiner der oben genannten Fälle zutrifft, wurden die Kartenkacheln möglicherweise vor Kurzem aktualisiert, sodass sie nicht mehr mit dem Straßenindex synchron sind, der für das Andocken verwendet wird. Wenn nur wenige Ihrer Anfragen betroffen sind, ist dies wahrscheinlich die Ursache. Da Google Maps regelmäßig aktualisiert wird, kann dies gelegentlich vorkommen. Es kann häufiger passieren, wenn Sie sich regelmäßig alte Pfade auf einer Karte ansehen, z. B. Pfade, die vor einigen Wochen aufgezeichnet wurden. Für eine optimale Visualisierung sollten Sie alte Pfade kurz vor der Darstellung auf einer Karte neu ausrichten, um die Inkonsistenzen zwischen den Kartenkacheln und dem für die Ausrichtung verwendeten Straßenindex zu minimieren.

Was kann dazu führen, dass das Tempolimit für Straße X falsch angezeigt wird?

Geschwindigkeitsbegrenzungen stammen aus verschiedenen Quellen, die sich in Bezug auf Genauigkeit und Abdeckung unterscheiden. Wenn Sie ein Muster erkennen, z. B. wenn Geschwindigkeitsbegrenzungen für einen bestimmten Straßentyp oder in einem bestimmten Gebiet immer wieder falsch sind, gehen Sie bitte so vor, um uns dies mitzuteilen:

1. Öffnen Sie Google Maps auf Ihrem Computer ODER die Google Maps App für Android.
2. Öffnen Sie das Menü auf der linken Seite.
3. Wähle Feedback senden aus. Hinweis: Möglicherweise werden Sie aufgefordert, sich anzumelden.
4. Wählen Sie Karte bearbeiten aus.
5. Wählen Sie das Straßenabschnitt aus, das Sie bearbeiten möchten.
6. Wählen Sie Weiter aus.
7. Geben Sie im Feld „Sonstiges“ an, dass das Tempolimit für diese Straße falsch ist.
8. Wählen Sie Senden aus.

Sie können hier auch andere Probleme melden, z. B. wenn die Straße den falschen Namen hat, falsch eingezeichnet ist oder gesperrt oder privat ist.

Warum nimmt der gerundete Pfad Abkürzungen, anstatt der Straße zu folgen?

Prüfen Sie Folgendes, um das Problem zu beheben:

• Der Parameter interpolate muss auf true festgelegt sein.
• Prüfen Sie, ob Ihre ursprünglichen Datenpunkte in ausreichend kurzen Intervallen (alle 1 bis 10 Sekunden) erfasst werden.

Warum werden im angepassten Pfad für eine Straße ohne Änderungen der Geschwindigkeitsbegrenzung viele Straßenabschnitte zurückgegeben?

Wenn der Parameter interpolate auf true festgelegt ist, gibt die Anfrage zum Ausrichten an Straßen eine Polylinie zurück, die der Straße um Ecken, Kurven und Kreisverkehre folgt. Wenn die Straße kurvenreich ist, werden mehrere Straßenabschnitte zurückgegeben, auch wenn sich die zulässige Höchstgeschwindigkeit nicht ändert. So wird eine Polylinie erstellt, die der Straßenführung genau folgt.