Package google.maps.isochrones.v1

Index

IsochroneService

Service for calculating isochrones. An isochrone is an area of reachability from a given origin point within a specified travel time.

GenerateIsochrone

rpc GenerateIsochrone(GenerateIsochroneRequest) returns (GenerateIsochroneResponse)

Calculates and returns a single isochrone for a given set of parameters.

GenerateIsochroneRequest

A request to generate a single isochrone.

Fields
travel_duration

Duration

Required. The travel time for the isochrone calculation. The value must be positive and is capped at 7200 seconds (120 minutes). For DRIVE mode, the maximum allowed duration is 3600 seconds (60 minutes).
travel_mode

TravelMode

Required. The mode of transportation.
travel_direction

TravelDirection

Required. The direction of travel.
routing_preference

RoutingPreference

Optional. Specifies the preference for how to route. Defaults to TRAFFIC_UNAWARE.
enable_smoothing

bool

Optional. Specifies whether to smooth the edges of the resulting isochrone polygons.
polygon_fidelity

PolygonFidelity

Optional. Controls the precision of the generated polygon. Defaults to POLYGON_FIDELITY_UNSPECIFIED.
Union field origin. Required. The starting point for the isochrone calculation. origin can be only one of the following:
location

LatLng

The origin as a latitude/longitude coordinate.
place

string

The resource name of a place, in the places/{place_id} format.

PolygonFidelity

Controls the level of detail in the isochrone polygon.

Enums
POLYGON_FIDELITY_UNSPECIFIED No polygon fidelity specified. The server will use its default, which is based on the travel duration.
LOW Low precision. Good for covering large areas with fewer vertices.
MEDIUM Medium precision. A balance between detail and artifact size.
HIGH High precision. High fidelity edges, but may produce holes in the polygon where the road network density is low.

RoutingPreference

Determines how traffic conditions are incorporated into the calculation.

Enums
ROUTING_PREFERENCE_UNSPECIFIED No routing preference specified. The server will use its default, which is TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE The calculation will not take traffic conditions into consideration. The isochrone will be based on the road network and static travel times. This is suitable for planning purposes where traffic is not a factor.
TRAFFIC_AWARE The calculation will factor in live traffic conditions.

TravelDirection

Specifies the direction of travel for the isochrone calculation.

Enums
TRAVEL_DIRECTION_UNSPECIFIED No travel direction specified.
FROM Calculates the area reachable from the origin point. Example: "Where can I deliver to from my warehouse in 30 minutes?"
TO Calculates the area from which you can travel to the origin point. Example: "Where can my employees commute from to reach the office in 30 minutes?"

TravelMode

Defines the mode of transportation for isochrone calculation.

Enums
TRAVEL_MODE_UNSPECIFIED No travel mode specified.
DRIVE Travel by passenger car.
BICYCLE Travel by bicycle.
WALK Travel by walking.

GenerateIsochroneResponse

A response containing the generated isochrone data.

Fields
isochrone

Isochrone

Output only. The generated isochrone.

Isochrone

The result of an isochrone calculation, representing an area of reachability from an origin point within a specified travel time.

Fields
Union field geometry. The geometric representation of the isochrone. geometry can be only one of the following:
geo_json

Struct

The isochrone geometry in GeoJSON format, using the RFC 7946 format: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.