Wichtige Konzepte

Um eine Isochrone zu generieren, geben Sie der API einen Ausgangspunkt, eine Mobilitätsform wie Auto, Fahrrad oder Fußweg und ein Zeitlimit an. Sie können auch die Routingeinstellungen und das visuelle Erscheinungsbild des resultierenden Polygons anpassen.

Zeithorizont

Die primäre Einschränkung, die Sie dem Dienst zur Verfügung stellen, ist travel_duration. Dadurch wird der Zeithorizont für die Berechnung definiert.

• Maximale Dauer:Die API unterstützt eine maximale Reisezeit von 3.600 Sekunden (1 Stunde) für den Modus DRIVE und 7.200 Sekunden (2 Stunden) für die Modi WALK und BICYCLE.
• Leistung:Die Berechnungszeit skaliert mit der angeforderten Dauer und der ausgewählten Mobilitätsform. Eine Isochrone für eine Stunde Autofahrt deckt ein deutlich größeres geografisches Gebiet und Straßennetz ab als eine Isochrone für eine Stunde Fußweg. Dies führt zu einer höheren Latenz für die Anfrage für die Autofahrt.
• Formatierung: Da die API google.protobuf.Duration verwendet, muss die Dauer als String formatiert werden, der mit „s“ endet (z. B. "3600s"), und nicht als Ganzzahl.

Ausgangspunkte und Straßenanpassung

Sie haben zwei Möglichkeiten, den Ausgangspunkt für die Isochrone anzugeben:

• Koordinaten:Ein Paar aus Breiten- und Längengrad (location).
• Orts-IDs:Eine eindeutige ID für einen bestimmten Ort in Google Maps (place). Wenn Sie eine Orts-ID angeben, verwendet der Dienst den Mittelpunkt dieses Orts als Ausgangspunkt. Die API erwartet das Format des Ressourcennamens, z. B. places/ChIJ.... Weitere Informationen zu Orts-IDs finden Sie unter Orts-IDs.

Unabhängig von der Eingabemethode berechnet die API keine Reisezeiten vom genauen physischen Punkt aus, wenn sich dieser Punkt nicht auf einer Straße befindet, z. B. in einem Park oder Gebäude. Um diese Situation zu berücksichtigen, verwendet der Dienst die Straßenanpassung. Die Straßenanpassung bietet folgende Funktionen:

• Intelligente Anpassung:Der Dienst versucht, Ihren Ausgangspunkt an das nächste befahrbare Straßensegment anzupassen.
• Modusabhängigkeit:Die Anpassungslogik berücksichtigt Ihren travel_mode. Wenn Sie DRIVE anfordern, ignoriert die API Fußwege und sucht nach der nächsten befahrbaren Straße. Wenn Sie WALK anfordern, priorisiert die API Fußwege und Bürgersteige.
• Fehlerfälle:Wenn die API innerhalb von etwa 100 Metern von Ihrem Ausgangspunkt kein geeignetes Straßensegment findet, gibt sie den Fehler 404 NOT_FOUND zurück. Das bedeutet in der Regel, dass der Punkt zu weit vom Straßennetz entfernt ist oder sich in einem Gebiet befindet, in dem die Kartendaten die angeforderte Mobilitätsform nicht unterstützen.

Reiserichtung (eingehend vs. ausgehend)

Mit dem Parameter travelDirection können Sie sowohl die eingehende als auch die ausgehende Erreichbarkeit berechnen:

• FROM (ausgehend) : Berechnet das Gebiet, das vom Ausgangspunkt aus innerhalb des angegebenen Zeitlimits erreichbar ist. Dies ist für Anwendungsfälle wie Lieferzonen oder Serviceabdeckung geeignet.
• TO (eingehend) : Berechnet das Gebiet, von dem aus Sie innerhalb des angegebenen Zeitlimits zum Ausgangspunkt reisen können. Dies ist geeignet, um Einzugsgebiete zu bestimmen, z. B. von wo aus Mitarbeiter zu einem zentralen Büro pendeln können.

Verkehrsberücksichtigung

Mit dem Parameter routing_preference können Sie festlegen, wie Verkehrsdaten das generierte Polygon beeinflussen:

• TRAFFIC_UNAWARE (Standard) : Verwendet Geschwindigkeitsbegrenzungen und die Straßenhierarchie, um das Isochronenpolygon zu generieren. Dadurch entsteht eine deterministische Form, die nicht von der Tageszeit abhängt. Dieser Parameter ist ideal für allgemeine Analysen oder die Planung von Basisszenarien.
• TRAFFIC_AWARE:Berechnet Isochronen anhand der aktuellen oder prognostizierten Verkehrsbedingungen zum Zeitpunkt der Anfrage. Dadurch verkleinert sich das erreichbare Gebiet bei Stau und vergrößert sich außerhalb der Stoßzeiten. Hinweis:Das verkehrsabhängige Routing wird nur unterstützt, wenn travelMode auf DRIVE gesetzt ist.

Hinweis: Verkehrsabhängige Isochronen sind latenzempfindlicher als verkehrsunabhängige Isochronen.

Glättung und Genauigkeit

Mit den Parametern polygon_fidelity und enable_smoothing können Sie das Erscheinungsbild und die Genauigkeit der Ausgabepolygone anpassen. Diese Optionen sind zwar unabhängig, arbeiten aber zusammen, um die endgültige Form zu bestimmen.

• polygon_fidelity:Steuert die Größe der zugrunde liegenden Rasterzellen, die zur Berechnung des erreichbaren Gebiets verwendet werden.

  • LOW:Verwendet größere Rasterzellen. Am besten geeignet, um große Flächen ohne Lücken abzudecken, was zu einer verallgemeinerten Form führt.
  • MEDIUM:Ausgewogene Genauigkeit.
  • HIGH:Verwendet kleinere Rasterzellen. Führt zu einer genaueren Anpassung an das Straßennetz, kann aber zu leeren Bereichen oder Lücken führen, wenn das Straßennetz dünn ist.
  • POLYGON_FIDELITY_UNSPECIFIED:Wenn nicht angegeben, wählt der Dienst die Genauigkeit dynamisch basierend auf der angeforderten Reisedauer aus.

    

    Hohe, mittlere und niedrige Polygongenauigkeit

• enable_smoothing:Steuert, ob die scharfen Kanten der durch die Genauigkeit definierten Rasterzellen abgerundet werden.

  • false (Roh) : Die Standardeinstellung. Gibt die genaue geometrische Berechnung zurück. Die Kanten erscheinen gezackt oder gestuft. Am besten geeignet für die analytische Genauigkeit, z. B. strenge Punkt-in-Polygon-Tests. Geringere Latenz als bei geglätteten Polygonen.
  • true (Geglättet) : Wendet einen Nachbearbeitungsalgorithmus an, um die Ecken abzurunden. Am besten geeignet für die visuelle Darstellung auf Karten.

    

    Isochrone mit und ohne Glättung