Method: isochrones.generate

Berechnet und gibt eine einzelne Isochrone für eine bestimmte Reihe von Parametern zurück.

HTTP-Anfrage

POST https://isochrones.googleapis.com/v1/isochrones:generate

Die URL verwendet die Syntax der gRPC-Transcodierung.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "travelDuration": string,
  "travelMode": enum (TravelMode),
  "travelDirection": enum (TravelDirection),
  "routingPreference": enum (RoutingPreference),
  "enableSmoothing": boolean,
  "polygonFidelity": enum (PolygonFidelity),

  // Union field origin can be only one of the following:
  "location": {
    object (LatLng)
  },
  "place": string
  // End of list of possible types for union field origin.
}
Felder
travelDuration

string (Duration format)

Erforderlich. Die Reisezeit für die Isochronenberechnung. Der Wert muss positiv sein und ist auf 7.200 Sekunden (120 Minuten) begrenzt. Für den Modus DRIVE beträgt die maximal zulässige Dauer 3.600 Sekunden (60 Minuten).

Die Dauer in Sekunden mit bis zu neun Nachkommastellen und am Ende mit „s“. Beispiel: "3.5s".
travelMode

enum (TravelMode)

Erforderlich. Das Verkehrsmittel.
travelDirection

enum (TravelDirection)

Erforderlich. Die Richtung der Reise.
routingPreference

enum (RoutingPreference)

Optional. Gibt die Einstellung für die Routenplanung an. Die Standardeinstellung ist TRAFFIC_UNAWARE.
enableSmoothing

boolean

Optional. Gibt an, ob die Kanten der resultierenden Isochronenpolygone geglättet werden sollen.
polygonFidelity

enum (PolygonFidelity)

Optional. Steuert die Genauigkeit des generierten Polygons. Die Standardeinstellung ist POLYGON_FIDELITY_UNSPECIFIED.
Union-Feld origin. Erforderlich. Der Startpunkt für die Isochronenberechnung. Für origin ist nur einer der folgenden Werte zulässig:
location

object (LatLng)

Der Ursprung als Breiten-/Längengrad-Koordinate.
place

string

Der Ressourcenname eines Orts im Format places/{place_id}.

Antworttext

Eine Antwort mit den generierten Isochronendaten.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "isochrone": {
    object (Isochrone)
  }
}
Felder
isochrone

object (Isochrone)

Nur Ausgabe. Die generierte Isochrone.

LatLng

Ein Objekt, das ein Paar aus Breiten- und Längengrad darstellt. Es wird als Paar aus Werten vom Typ „Double“ (Breiten- und Längengrad) ausgedrückt. Sofern nicht anders angegeben, muss dieses Objekt dem WGS84-Standard entsprechen. Die Werte müssen innerhalb normalisierter Bereiche liegen.

JSON-Darstellung 
{
  "latitude": number,
  "longitude": number
}
Felder
latitude

number

Der Breitengrad in Grad. Er muss im Bereich [-90,0, +90,0] liegen.
longitude

number

Der Längengrad in Grad. Er muss im Bereich [-180,0, +180,0] liegen.

TravelMode

Definiert das Verkehrsmittel für die Isochronenberechnung.

Enums
TRAVEL_MODE_UNSPECIFIED Kein Verkehrsmittel angegeben.
DRIVE Reise mit dem Pkw.
BICYCLE Reise mit dem Fahrrad.
WALK Reise zu Fuß.

TravelDirection

Gibt die Richtung der Reise für die Isochronenberechnung an.

Enums
TRAVEL_DIRECTION_UNSPECIFIED Keine Richtung der Reise angegeben.
FROM Berechnet den Bereich, der vom Ausgangspunkt aus erreichbar ist. Beispiel: „Wo kann ich von meinem Lager aus in 30 Minuten hinliefern?“
TO Berechnet den Bereich, von dem aus Sie zum Ausgangspunkt reisen können. Beispiel: „Wo können meine Mitarbeiter wohnen, um das Büro in 30 Minuten zu erreichen?“

RoutingPreference

Bestimmt, wie die Verkehrslage in die Berechnung einbezogen wird.

Enums
ROUTING_PREFERENCE_UNSPECIFIED Keine Routeneinstellung angegeben. Der Server verwendet die Standardeinstellung TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE Bei der Berechnung wird die Verkehrslage nicht berücksichtigt. Die Isochrone basiert auf dem Straßennetz und statischen Reisezeiten. Diese Einstellung eignet sich für Planungszwecke, bei denen der Verkehr keine Rolle spielt.
TRAFFIC_AWARE Bei der Berechnung werden die aktuellen Verkehrsbedingungen berücksichtigt.

PolygonFidelity

Steuert die Detailgenauigkeit des Isochronenpolygons.

Enums
POLYGON_FIDELITY_UNSPECIFIED Keine Polygongenauigkeit angegeben. Der Server verwendet die Standardeinstellung, die auf der Reisezeit basiert.
LOW Geringe Genauigkeit. Gut für große Bereiche mit weniger Eckpunkten.
MEDIUM Mittlere Genauigkeit. Ein ausgewogenes Verhältnis zwischen Detailgenauigkeit und Artefaktgröße.
HIGH Hohe Genauigkeit. Kanten mit hoher Genauigkeit, aber es können Löcher im Polygon entstehen, wenn die Dichte des Straßennetzes gering ist.

Isochrone

Das Ergebnis einer Isochronenberechnung, die einen Bereich darstellt, der von einem Ausgangspunkt aus innerhalb einer bestimmten Reisezeit erreichbar ist.

JSON-Darstellung 
{

  // Union field geometry can be only one of the following:
  "geoJson": {
    object
  }
  // End of list of possible types for union field geometry.
}
Felder
Union-Feld geometry. Die geometrische Darstellung der Isochrone. Für geometry ist nur einer der folgenden Werte zulässig:
geoJson

object (Struct format)

Die Isochronengeometrie im GeoJSON-Format gemäß RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.