Diese Seite wurde von der Cloud Translation API übersetzt.

Fehlerbehebung

Fehler

Im Fall eines Fehlers wird ein Fehlertext im Standardformat zurückgegeben und der HTTP-Statuscode auf den Fehlerstatus gesetzt.

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

code: Das 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"
  }
}

Im Folgenden finden Sie mögliche Fehler:

Code	Status	die Botschaft und	Fehlerbehebung
400	`INVALID_ARGUMENT`	Der angegebene Schlüssel ist ungültig.	Ihr API-Schlüssel ist ungültig oder nicht in der Anfrage enthalten. Prüfen Sie, ob Sie den gesamten Schlüssel eingeschlossen und die API für diesen Schlüssel aktiviert haben.
400	`INVALID_ARGUMENT`	Der Parameter „\"path\"“ enthält einen ungültigen Wert: ⏎	Deine Anfrage enthielt ungültige Argumente. Die häufigsten Ursachen für diesen Fehler sind: Es ist ein Problem mit Ihrem `path`-Parameter aufgetreten. Sie benötigen mindestens 1 und höchstens 100 Punkte. Jeder Punkt sollte ein Zahlenpaar sein, das durch ein Komma getrennt ist. Beispiel: `48.409114,-123.369158`. Punkte müssen durch ein Rohr getrennt werden: „\|“. Deine Anforderung enthielt eine ungültige `placeId`. Deine Anfrage enthielt sowohl `placeId` als auch `path`. Für jede Anfrage kann nur einer dieser Parameter angegeben werden. Dieser Fehler wird nicht zurückgegeben, wenn ein `placeId` für eine Straße übergeben wird, die nicht mehr existiert, oder für einen Ort, der keine Straße ist.
403	`PERMISSION_DENIED`	Die nicht registrierte Anfrage wurde blockiert. Registrieren Sie sich über die Google Developers Console.	Die Anfrage wurde aus mindestens einem der folgenden Gründe abgelehnt: Der API-Schlüssel fehlt oder ist ungültig. Die Abrechnung wurde für Ihr Konto nicht aktiviert. Das von Ihnen festgelegte Frequency Capping wurde überschritten. Die angegebene Zahlungsmethode ist nicht mehr gültig, z. B. ist eine Kreditkarte abgelaufen. Damit Sie Google Maps Platform-Produkte nutzen können, muss die Abrechnung für Ihr Konto aktiviert sein. Außerdem müssen alle Anfragen einen gültigen API-Schlüssel enthalten. So beheben Sie das Problem: API-Schlüssel anfordern Aktivieren Sie die Abrechnung in Ihrem Konto. Passe das Nutzungslimit an, um bei Bedarf dein Tageslimit zu erhöhen.
404	`NOT_FOUND`	Für diesen Dienst ist HTTPS erforderlich.	Achten Sie darauf, dass Anfragen an `https://roads.googleapis.com/` und nicht an `http://roads.googleapis.com/` gesendet werden.
429	`RESOURCE_EXHAUSTED`	Die Anfrage wurde gedrosselt, da die Projektanfragelimits erreicht wurden.	Sie haben das Anfragelimit überschritten, das Sie in der Google Cloud Platform Console konfiguriert haben. Dieses Limit wird in der Regel als Anfragen pro Tag, Anfragen pro 100 Sekunden und Anfragen pro 100 Sekunden und Nutzer festgelegt. Dieses Limit sollte so konfiguriert werden, dass eine einzelne oder kleine Gruppe von Nutzern nicht Ihr Tageskontingent aufbraucht, aber gleichzeitig allen Nutzern angemessenen Zugriff gewährt wird. Informationen zum Konfigurieren dieser Limits finden Sie unter API-Nutzung deckeln.

Exponentielle Backoffs

Wenn Anfragen fehlschlagen, sollten Sie Anfragen mit exponentiellem Backoff wiederholen. Wenn beispielsweise eine Anfrage einmal fehlschlägt, den Vorgang nach einer Sekunde wiederholen, noch einmal, nach zwei Sekunden, dann nach vier Sekunden, und so weiter. So wird sichergestellt, dass fehlerhafte Anfragen oder umfassende Fehler die Google-Server nicht überlasten, da viele Clients Anfragen sehr schnell wiederholen.

FAQs zur Fehlerbehebung

Probleme bei der Implementierung

Bei welcher Häufigkeit soll ich meinen Fahrzeugstandort abrufen?: Im Anschluss an alle 1–10 Sekunden werden qualitativ hochwertige Ergebnisse geliefert.
Ist die Anzahl der Punkte, die ich pro Abfrage senden kann, begrenzt?: Ja, für eine Abfrage sind maximal 100 Punkte möglich.
Wie genau sollte ich meine Längen- und Breitengradangaben speichern?: Damit die ausgerichteten Pfade bei allen Zoomstufen den Straßen folgen – auch bei maximaler Zoomstufe – sollten Sie die ausgerichteten Paare aus Breiten- und Längengrad an einer Genauigkeit von 7 Dezimalstellen speichern.
Kann ich codierte Polylinien zum Anzeigen von ausgerichteten Pfaden verwenden?: Codierte Polylinien werden nur auf eine Genauigkeit von 5 Dezimalstellen angegeben, was zu einem Fehler von etwa 2 Metern führt. Codierte Polylinien sind daher nicht geeignet, wenn die ausgerichteten Pfade bei hohen Zoomstufen der Straße folgen sollen.

Häufige Probleme

Einige Punkte werden nicht ausgerichtet oder es gibt Lücken in solchen Pfaden. Wie kann ich das beheben?

Wenn Sie die Punkte in zeitlichen Intervallen erfassen, müssen Sie sie in kürzeren Intervallen (alle 1 bis 10 Sekunden) verwenden. Wenn ein längeres Intervall verwendet wird (z. B. 60 Sekunden), kann der Straßen-Algorithmus die Straßen, die zurückgelegt werden, möglicherweise nicht mit genug Genauigkeit ermitteln.
Wenn Sie manuell auf eine Karte klicken, um Punkte zu erstellen, ist es sehr einfach, Pfade mit wenigen Punkten zu erstellen oder Punkte zu kapseln, die der Algorithmus nicht gut verarbeitet. Der Ausrichtungsalgorithmus funktioniert am besten bei Punkten, die nahe beieinander sind. Probieren Sie die Demo „Roads an Roads“ aus oder testen Sie Ihre Pfade mit dem Roads-Prüftool.

Warum sind die verlaufenden Pfade beim Zoomen schroff oder leicht schroff?

Werden die Genauigkeit der als Ausrichtung verwendeten Paare aus Breiten- und Längengrad abgeschnitten, bevor sie angezeigt werden? Das Speichern von ausgerichteten Paaren aus Breiten- und Längengrad mit einer Genauigkeit von weniger als sieben Dezimalstellen führt zu Genauigkeitsfehlern, wenn der eingerahmte Pfad auf der Karte angezeigt wird.
Verwenden Sie codierte Polylinien? Für codierte Polylinien werden Breiten-/Längengradpaare auf fünf Dezimalstellen gekürzt. Das führt zu einem Fehler von mehreren Metern. Das führt zu schroffen oder leicht verlaufenden Linien bei hoher Zoomstufe.

Wenn keiner der oben genannten Punkte zutrifft, wurden die Kartenkacheln möglicherweise vor Kurzem aktualisiert und sind daher nicht mehr mit dem Straßenindex identisch, der für das Andocken verwendet wird. Wenn nur wenige Abfragen betroffen sind, ist dies wahrscheinlich der Grund. Da Google Maps regelmäßig aktualisiert wird, kann das gelegentlich vorkommen. Das kann öfter passieren, wenn Sie sich regelmäßig alte Pfade auf einer Karte ansehen (z. B. Pfade, die vor einigen Wochen markiert wurden). Für eine optimale Darstellung sollten Sie alte Pfade noch einmal kurz vor der Darstellung auf einer Karte einrasten, um die Inkonsistenzen zwischen den Kartenkacheln und dem für die Andocken verwendeten Straßenindex zu minimieren.

Woran könnte das liegen, wenn die Geschwindigkeit für X falsch eingestellt ist?

Die Geschwindigkeitsbegrenzungen stammen aus verschiedenen Quellen, deren Genauigkeit und Abdeckung variieren. Wenn Sie ein Muster finden, z. B. Geschwindigkeitsbegrenzungen für einen bestimmten Straßentyp oder in einem bestimmten Bereich, die regelmäßig falsch sind, teilen Sie uns das bitte mit:

Öffnen Sie Google Maps auf Ihrem Computer ODER die Google Maps App für Android.
Öffnen Sie das Menü auf der linken Seite.
Wähle Feedback geben aus. Hinweis: Du wirst möglicherweise aufgefordert, dich anzumelden.
Wählen Sie Karte bearbeiten aus.
Wählen Sie das zu bearbeitende Straßensegment aus.
Wählen Sie Weiter aus.
Geben Sie im Feld „Sonstiges“ an, dass die Höchstgeschwindigkeit für diese Straße falsch ist.
Wählen Sie Senden aus.

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

Warum schneidet mein gerahmter Pfad die Ecken ab, anstatt der Straße zu folgen?

Gehen Sie so vor, um dieses Problem zu beheben:

Der interpolate-Parameter muss auf true festgelegt sein.
Prüfen Sie, ob Ihre ursprünglichen Datenpunkte in genügend Intervallen (alle 1–10 Sekunden) abgetastet werden.

Warum werden bei einer Straße ohne Änderungen der Höchstgeschwindigkeit viele Straßensegmente zurückgegeben?

Wenn der Parameter interpolate auf true gesetzt ist, gibt die Straßen-Snapshot-Abfrage eine Polylinie zurück, die der Straße um Ecken, Kurven und Kreisverkehre folgt. Bei Straßenkurven werden mehrere Straßensegmente zurückgegeben, auch wenn sich die Höchstgeschwindigkeit nicht ändert. So wird eine Polylinie erstellt, die der Straßengeometrie eng folgt.