Fehlerbehebung

Fehler

Im Fehlerfall wird ein Antworttext 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, versuchen Sie es nach einer Sekunde noch einmal. Wenn sie wieder fehlschlägt, versuchen Sie es nach zwei Sekunden, dann nach vier Sekunden usw. So wird verhindert, dass fehlerhafte Anfragen oder weitverbreitete Fehler die Server von Google überlasten, da viele Clients versuchen, Anfragen sehr schnell noch einmal zu senden.

FAQs zur Fehlerbehebung

Probleme bei der Implementierung

Wie oft sollte ich den Standort meines Fahrzeugs erfassen?

Für hochwertige Ergebnisse beim Andocken an die Straße wird ein Intervall von 1 bis 10 Sekunden empfohlen.

Ist die Anzahl der Punkte, die ich pro Anfrage senden kann, begrenzt?

Ja, eine Anfrage kann maximal 100 Punkte haben.

Welchen Genauigkeitsgrad sollte ich zum Speichern meiner angepassten 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 darauf achten, dass die Intervalle kurz sind (1–10 Sekunden). Bei einem längeren Intervall (z. B. 60 Sekunden) kann der Algorithmus zum Anpassen an die Straße möglicherweise nicht genau genug ermitteln, auf welchen Straßen die Nutzer unterwegs waren.
• 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 der Snapping-Algorithmus nicht gut verarbeitet. 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 dem Straßen-Inspector.

Warum sind meine gerasterten Pfade gezackt 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 gerundete Breiten-/Längengradpaare mit einer Genauigkeit von weniger als 7 Dezimalstellen speichern, führt das zu Ungenauigkeiten, wenn der gerundete Pfad auf der Karte angezeigt wird.
• Verwenden Sie codierte Polylinien? Bei codierten Polylinien werden Breiten-/Längengradpaare auf 5 Dezimalstellen gekürzt, was zu einem Fehler von mehreren Metern führt. Bei hohen Zoomstufen sind die Linien daher zackig oder leicht von der Straße versetzt.

Wenn keines der beiden Szenarien 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 auftreten, wenn Sie sich regelmäßig alte Pfade auf einer Karte ansehen, z. B. Pfade, die vor einigen Wochen erfasst 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 könnte dazu führen, dass die Geschwindigkeitsbegrenzung 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 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, gesperrt oder privat ist.

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

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

• Achten Sie darauf, dass der Parameter interpolate auf true festgelegt ist.
• 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ßensegmente zurückgegeben?

Wenn der Parameter interpolate auf true festgelegt ist, gibt die Anfrage „Snap to Road“ eine Polylinie zurück, die der Straße um Ecken, Kurven und Kreisverkehre folgt. Wenn die Straße kurvenreich ist, werden mehrere Straßensegmente zurückgegeben, auch wenn sich das Tempolimit nicht ändert. So wird eine Polylinie erstellt, die der Straßenführung genau folgt.