Wichtige Konzepte

Um eine Isochrone zu generieren, geben Sie der API einen Ausgangspunkt, eine Mobilitätsform wie Auto, Zweirad, Fahrrad oder zu Fuß 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 die Modi DRIVE und TWO_WHEELER 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 einstündige Isochrone für Autofahrten deckt ein deutlich größeres geografisches Gebiet und Straßennetz ab als eine einstündige Isochrone für Fußgänger. Dies führt zu einer höheren Latenz für die Anfrage für Autofahrten.
  • Formatierung: Da die API google.protobuf.Duration verwendet, muss die Dauer als String formatiert werden, der mit einem „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 einem 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.
  • Modusbewusstsein:Die Anpassungslogik berücksichtigt Ihre travel_mode. Wenn Sie DRIVE oder TWO_WHEELER 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 der maximalen Anpassungsentfernung von Ihrem Ausgangspunkt kein geeignetes Straßensegment findet (ca. 150–200 Meter, je nach Mobilitätsform: 200 Meter für DRIVE und TWO_WHEELER, 180 Meter für BICYCLE und 150 Meter für WALK), gibt die API einen 404 NOT_FOUND-Fehler 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.

Verkehrsdaten berücksichtigen

Mit dem Parameter routing_preference können Sie steuern, wie sich Verkehrsdaten auf das generierte Polygon auswirken:

  • 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 eignet sich 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 travel_mode auf DRIVE oder TWO_WHEELER gesetzt ist.

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 Polygontreue
      Hohe, mittlere und niedrige Polygongenauigkeit

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

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