Um eine Isochrone zu generieren, geben Sie der API einen Ursprung, eine Mobilitätsform wie „Mit dem Auto“, „Mit dem Fahrrad“ oder „Zu Fuß“ sowie ein Zeitlimit an. Sie können auch die Routing-Einstellungen und die Darstellung des resultierenden Polygons anpassen.
Zeithorizont
Die primäre Einschränkung, die Sie für den Dienst angeben, ist der travel_duration. Damit wird der Zeithorizont für die Berechnung definiert.
- Maximale Dauer:Die API unterstützt eine maximale Fahrzeit von 3.600 Sekunden (1 Stunde) für den Modus
DRIVEund 7.200 Sekunden (2 Stunden) für die ModiWALKundBICYCLE. - Leistung:Die Berechnungszeit skaliert mit der angeforderten Dauer und dem ausgewählten Transportmittel. 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.
Ausgangspunkte und Road Snapping
Sie haben zwei Möglichkeiten, den Startpunkt für die Isochrone anzugeben:
- Koordinaten:Ein Paar aus Breiten- und Längengrad (
location). - Orts-IDs:Eine eindeutige Kennzeichnung für einen bestimmten Ort in Google Maps (
place). Wenn Sie eine Orts-ID angeben, wird der Schwerpunkt dieses Orts als Ausgangspunkt verwendet. 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 Fahrzeiten ab dem genauen physischen Punkt, wenn sich dieser Punkt nicht auf einer Straße befindet, z. B. in einem Park oder einem Gebäude. Um diese Situation zu bewältigen, verwendet der Dienst das Anpassen an Straßen. Das Anpassen an Straßen hat folgende Funktionen:
- Smart Snapping:Der Dienst versucht, den Startpunkt an das nächste befahrbare Straßensegment anzupassen.
- Modusberücksichtigung:Bei der Snapping-Logik wird
travel_modeberücksichtigt. Wenn SieDRIVEanfordern, ignoriert die API nur für Fußgänger vorgesehene Wege und sucht nach der nächstgelegenen befahrbaren Straße. Wenn SieWALKanfordern, priorisiert die API Fußwege und Bürgersteige. - Fehlerfälle:Wenn die API innerhalb von etwa 100 Metern von Ihrem Startpunkt kein geeignetes Straßenabschnitt finden kann, gibt sie den Fehler
404 NOT_FOUNDzurü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 den angeforderten Fortbewegungsmodus nicht unterstützen.
Verkehrslage
Mit dem Parameter routing_preference können Sie festlegen, wie sich Verkehrsdaten auf das generierte Polygon auswirken:
TRAFFIC_UNAWARE(Standard): Verwendet Tempolimits und die Straßenhierarchie, um das Isochronenpolygon zu generieren. Dadurch wird eine deterministische Form erzeugt, 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 von Live- oder prognostizierten Verkehrsbedingungen zum Zeitpunkt der Anfrage. Dadurch wird das erreichbare Gebiet bei Staus verkleinert und in verkehrsarmen Zeiten vergrößert.
Glättung und Wiedergabetreue
Mit den Parametern polygon_fidelity und enable_smoothing können Sie die Darstellung und Genauigkeit der Ausgabepolygone anpassen. Diese Optionen sind zwar unabhängig voneinander, aber sie bestimmen gemeinsam die endgültige Form.
polygon_fidelity:Steuert die Größe der zugrunde liegenden Rasterzellen, die zur Berechnung des erreichbaren Bereichs verwendet werden.LOW:Hier werden größere Rasterzellen verwendet. Am besten geeignet, um große Flächen ohne Lücken abzudecken, was zu einer verallgemeinerten Form führt.MEDIUM:Ausgewogene Präzision.HIGH:Hier werden kleinere Rasterzellen verwendet. Führt zu einer besseren Anpassung an das Straßennetz, kann aber zu leeren Bereichen oder Lücken führen, wenn das Straßennetz spärlich ist.POLYGON_FIDELITY_UNSPECIFIED:Wenn nichts angegeben ist, wählt der Dienst die Genauigkeit dynamisch anhand der angeforderten Reisedauer aus.
Hohe, mittlere und niedrige Polygontreue
enable_smoothing:Legt fest, ob die scharfen Kanten der Rasterzellen, die durch die Wiedergabetreue definiert werden, abgerundet werden.false(Rohdaten): Standardeinstellung. Gibt die genaue geometrische Berechnung zurück. Kanten sehen gezackt oder stufenförmig aus. Am besten für analytische Genauigkeit geeignet, z. B. für strenge Point-in-Polygon-Tests. Geringere Latenz als bei geglätteten Daten.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