Best Practices für die Isochrones API

Glättung und Genauigkeit

Mit den Parametern polygon_fidelity und enable_smoothing können Sie das Aussehen und die Genauigkeit der Ausgabepolygone anpassen. Diese Optionen sind zwar unabhängig voneinander, aber sie bestimmen gemeinsam die endgültige Form.

• polygon_fidelity:Auflösung Steuert die Größe der zugrunde liegenden Rasterzellen (S2-Zellen), die zur Berechnung des erreichbaren Bereichs verwendet werden.
  • LOW: Verwendet größere Rasterzellen. Am besten geeignet, um große Bereiche ohne Lücken abzudecken, was zu einer verallgemeinerten Form führt.
  • MEDIUM: Ausgewogene Genauigkeit
  • HIGH: Verwendet kleinere Rasterzellen. Führt zu einer engeren Anpassung an das Straßennetz, kann aber leere Bereiche oder „Löcher“ erzeugen, wenn das Straßennetz dünn ist.
  • Standard:Wenn nicht angegeben, wählt der Dienst die Genauigkeit dynamisch basierend auf der angeforderten Reisedauer aus.

Tipp: Löcher in Polygonen reduzieren
Da bei Isochronen die Erreichbarkeit anhand des tatsächlichen Straßennetzes berechnet wird, können Bereiche mit wenigen Straßen, z. B. große Parks, nicht kartografierte Privatbereiche oder Industriegebiete, als unzugängliche "Löcher" innerhalb des generierten Polygons erscheinen. Wenn für Ihren Anwendungsfall ein durchgehender, verallgemeinerter Abdeckungsbereich ohne diese Lücken erforderlich ist, legen Sie polygon_fidelity explizit auf MEDIUM oder LOW fest.

• enable_smoothing:Ästhetik Steuert, ob die scharfen Kanten der durch die Genauigkeit definierten Rasterzellen abgerundet werden.
  • false (Roh) : Gibt die genaue geometrische Berechnung zurück. Die Kanten sind zackig oder stufenförmig und spiegeln die Rasterzellen wider. Am besten für die analytische Genauigkeit geeignet, z. B. für strenge Punkt-in-Polygon-Tests.
  • true (Geglättet) : Wendet einen Nachbearbeitungsalgorithmus an, um die Ecken abzurunden. Am besten für die visuelle Darstellung auf Karten geeignet.

Interaktion:Die Genauigkeit legt die Ausgangsdetailstufe fest, auf die sich der Glättungs algorithmus auswirkt.

• Hohe Genauigkeit + Glättung:Erzeugt eine detaillierte, organisch aussehende Form, die den Straßenenden genau folgt.
• Geringe Genauigkeit + Glättung:Erzeugt eine breite, verallgemeinerte „Blob“-Form.

Nutzlastgröße und Rendering

Große Isochronen können Tausende von Koordinaten enthalten und die Nutzlasten können zwischen 300 und 500 Kilobyte groß sein.

• Bandbreite:Die Größe der JSON-Antwort ist für Anfragen mit maximaler Dauer von Bedeutung.
• Rendering:Das Rendering extrem detaillierter Polygone wirkt sich auf die Leistung aus. Sie können den Parameter enable_smoothing oder clientseitige Vereinfachungsbibliotheken verwenden, um die Anzahl der Eckpunkte für die Anzeige zu reduzieren.

Fehlerbehandlung

Implementieren Sie eine Wiederholungslogik mit exponentiellem Backoff für 5xx-Serverfehler. Wiederholen Sie 4xx-Clientfehler jedoch nicht, ohne die Parameter zu ändern:

• INVALID_ARGUMENT (400): Prüfen Sie, ob die Dauer positiv ist und das Limit für den ausgewählten Modus nicht überschreitet. Das Limit beträgt maximal 3.600 Sekunden für DRIVE oder 7.200 Sekunden für andere Modi.
• NOT_FOUND (404): Der Ausgangspunkt konnte nicht an eine Straße ausgerichtet werden. Verschieben Sie die Koordinate näher an eine bekannte Straße oder prüfen Sie, ob die Region unterstützt wird.