Fehlerbehebung

Fehler

Bei einem Fehler wird ein Fehlerantwort-Textkörper im Standardformat zurückgegeben und der HTTP-Statuscode wird auf einen Fehlerstatus gesetzt.

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

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

Wird beispielsweise ein ungültiger placeId-Parameter gesendet, 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, wird nach einer Sekunde ein neuer Versuch unternommen. Schlägt dieser erneut fehl, wird nach zwei Sekunden, dann nach vier Sekunden usw. ein neuer Versuch unternommen. So wird verhindert, dass fehlerhafte Anfragen oder großflächige Fehler die Google-Server überlasten, da viele Clients sehr schnell versuchen, Anfragen noch einmal zu senden.

Häufig gestellte Fragen zur Fehlerbehebung

Probleme bei der Implementierung

Mit welcher Häufigkeit sollte ich den Standort meines Fahrzeugs erfassen?

Für qualitativ hochwertige Ergebnisse beim Anpassen an Straßen werden alle 1–10 Sekunden empfohlen.

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

Ja, eine Suchanfrage kann maximal 100 Punkte haben.

Welchen Genauigkeitsgrad sollte ich für die Speicherung meiner gesnapten Breiten-/Längengradpaare verwenden?

Damit angehängte Pfade auch bei maximaler Zoomstufe den Straßen folgen, sollten Sie die Breiten- und Längengrade mit sieben Dezimalstellen speichern.

Kann ich codierte Polylinien verwenden, um aneinandergefügte Pfade anzuzeigen?

Codierte Polylinien werden nur mit einer Genauigkeit von fünf Dezimalstellen angegeben, was zu einem Fehler von etwa 2 Metern führt. Codierte Polylinien eignen sich daher nicht, wenn Sie möchten, dass Ihre angepinnten Pfade bei hoher Zoomstufe der Straße folgen.

Häufige Probleme

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

• Wenn Sie Ihre Punkte in bestimmten Zeitabständen erfassen, sollten Sie kürzere Intervalle (alle 1–10 Sekunden) verwenden. Wenn ein längeres Intervall verwendet wird (z. B. 60 Sekunden), kann der Algorithmus zum Anpinnen an Straßen möglicherweise nicht mit ausreichender Genauigkeit die zurückgelegten Straßen ermitteln.
• Wenn Sie manuell auf eine Karte klicken, um Punkte zu erstellen, ist es sehr einfach, Pfade mit wenigen oder wenigen Punkten zu erstellen, die vom Snap-Algorithmus nicht gut verarbeitet werden. Der Ausrichtungsalgorithmus funktioniert am besten bei Punkten, die nah beieinander liegen. Sehen Sie sich die Demo „An Straßen anpinnen“ an oder verwenden Sie den Prüfer für Straßen, um Ihre Pfade zu testen.

Warum sind meine angepinnten Pfade beim Heranzoomen gezackt oder leicht von der Straße abweichend?

• Wird die Genauigkeit der ausgerichteten Breiten-/Längengradpaare vor der Anzeige abgeschnitten? Wenn Sie gesnappte Breiten-/Längengrad-Paare mit einer Genauigkeit von weniger als sieben Nachkommastellen speichern, kommt es zu Genauigkeitsfehlern, wenn der gesnappte Pfad auf der Karte angezeigt wird.
• Verwenden Sie codierte Polylinien? Codierte Polylinien schneiden Breiten-/Längengradpaare auf 5 Dezimalstellen ab, was zu einem Fehler von mehreren Metern führt. Dies führt dazu, dass Linien bei hohen Zoomstufen zerklüftet oder leicht von der Straße entfernt sind.

Wenn keiner der oben genannten Punkte zutrifft, wurden die Kartenkacheln möglicherweise vor Kurzem aktualisiert, sodass sie nicht mehr mit dem für das Snapping verwendeten Straßenindex synchronisiert sind. Wenn nur wenige Ihrer Suchanfragen betroffen sind, ist dies wahrscheinlich die Ursache. Da Google Maps regelmäßig aktualisiert wird, kann dies gelegentlich vorkommen. Das Risiko ist höher, wenn Sie sich regelmäßig alte Pfade auf einer Karte ansehen, z. B. Pfade, die vor mehreren Wochen aufgenommen wurden. Für eine optimale Visualisierung sollten Sie alte Pfade kurz vor der Darstellung auf einer Karte neu anpinnen, um Inkonsistenzen zwischen den Kartenkacheln und dem für das Anpinnen verwendeten Straßenindex zu minimieren.

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

Geschwindigkeitsbeschränkungen stammen aus verschiedenen Quellen, die sich in Genauigkeit und Abdeckung unterscheiden. Wenn Sie ein Muster feststellen, z. B. dass Geschwindigkeitsbeschränkungen für einen bestimmten Straßentyp oder in einem bestimmten Gebiet immer falsch sind, gehen Sie so vor, um uns dies mitzuteilen:

1. Öffnen Sie Google Maps auf Ihrem Computer ODER die Google Maps App für Android.
2. Öffne 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 den Straßenabschnitt aus, den 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.

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

Warum macht mein angeklickter 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–10 Sekunden) abgetastet werden.

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

Wenn der Parameter interpolate auf true gesetzt ist, gibt die Abfrage für die Straßenausrichtung eine Polylinie zurück, die der Straße um Ecken, Kurven und Kreisverkehre folgt. Wenn sich die Straße krümmt, werden mehrere Straßenabschnitte zurückgegeben, auch wenn sich die zulässige Höchstgeschwindigkeit nicht ändert. So wird eine Polylinie erstellt, die der Straßengeometrie genau folgt.