/v4/time-map/fast

Isochrones (Fast)

A very fast version of Isochrone API. However, the request parameters are much more limited. Supported countries list available here.

Currently supports only POST requests

Request Body

arrival_searches

object

Searches based on arrival time. Arrive at a destination or multiple destinations at no later than given time.

Hide child attributes

arrival_searches.many_to_one

array[object]

This returns the reachable area for journeys arriving at the chosen arrival location. You can define a maximum of 10 searches.

Hide child attributes

arrival_searches.many_to_one.id

string

Used to identify each search in the results array. Must be unique among all searches.

arrival_searches.many_to_one.coords

object

Coordinates of the arrival location.

Show child attributes

arrival_searches.many_to_one.coords.lat

float

Latitude.

arrival_searches.many_to_one.coords.lng

float

Longitude.

arrival_searches.many_to_one.transportation

object

Show child attributes

arrival_searches.many_to_one.transportation.type

string

Possible values: public_transport, walking+ferry, cycling+ferry, driving+ferry, driving+public_transport.

Note - a driving+public_transport search is for driving then public transport (i.e driving to a stop/station and continuing by public transport). The driving leg of the journey is limited to maximum 30 minutes."

arrival_searches.many_to_one.arrival_time_period

string

Possible values: weekday_morning

arrival_searches.many_to_one.travel_time

integer

Maximum journey time (in seconds).
Maximum value is 10800 (3 hours) as standard. To discuss increasing this, please contact hello@traveltime.com.

arrival_searches.many_to_one.level_of_detail

object | optional

Specifies level of detail of returned shape.

Show child attributes

arrival_searches.many_to_one.level_of_detail.scale_type

string

simple - level of detail is specified using a simple enumeration.
simple_numeric - level of detail is specified using integer numbers. This scale is an extension of simple scale.
coarse_grid - level of detail is specified as a number, used to simplify the generated shape to a set grid density.

Exact availability depends on the licence plan.

arrival_searches.many_to_one.level_of_detail.level

string | integer | optional

Can either be a string or an integer depending on scale_type used.

Available options when using string: lowest, low, medium, high, highest. Used with simple scale type. Returned shape will be the least detailed with the lowest setting, and the most detailed with the highest setting.
Available options when using integer are between -20 and 2. Used with simple_numeric scale type. The lower the number, the less detailed the returned shape will be. Values from -2 to 2 are equivalent to the lowest to highest values of the simple scale type.

arrival_searches.many_to_one.level_of_detail.square_size

integer | optional

Used with the coarse_grid scale type.
Specifies the side length (in metres) of the squares used to construct the shape. The larger the value, the less detailed the returned shape will be.
Minimum value is 600.

arrival_searches.many_to_one.polygons_filter

object | optional

Specifies polygon filter of a single shape.

Show child attributes

arrival_searches.many_to_one.polygons_filter.limit

integer

At most this amount of largest polygons will be returned in a single shape. Must be greater than 0.

arrival_searches.many_to_one.no_holes

boolean | optional

Enable to remove holes from returned polygons.
Note that this will likely result in loss in accuracy.

arrival_searches.many_to_one.render_mode

string | optional

approximate_time_filter (default) - the shape matches time-filter results as much as possible
road_buffering - the shape looks as if traversed roads of the search have been painted over with a wide brush

arrival_searches.many_to_one.snapping

object | optional

Adjusts the process of looking up the nearest roads from the departure / arrival points.

Show child attributes

arrival_searches.many_to_one.snapping.penalty

string | optional

enabled (default) - walking time and distance from the departure location to the nearest road and from the nearest road to the arrival location are added to the total travel time and distance of a journey.
disabled - these walking times and distances are not added to the total reported values (i.e the journey effectively starts and ends at the nearest points on the road network).

arrival_searches.many_to_one.snapping.accept_roads

string | optional

both_drivable_and_walkable (default) - journey can only start or end on roads that are accessible by both: cars and pedestrians. This effectively means journeys can not start / end on motorways.
any_drivable - journey can start or end on any road accessible by a car (including motorways).

arrival_searches.one_to_many

array[object]

This returns the reachable area for journeys departing from the chosen departure location. You can define a maximum of 10 searches.

Show child attributes

arrival_searches.one_to_many.id

string

Used to identify each search in the results array. Must be unique among all searches.

arrival_searches.one_to_many.coords

object

Coordinates of the departure location.

Show child attributes

arrival_searches.one_to_many.coords.lat

float

Latitude.

arrival_searches.one_to_many.coords.lng

float

Longitude.

arrival_searches.one_to_many.transportation

object

Show child attributes

arrival_searches.one_to_many.transportation.type

string

Possible values: public_transport, walking+ferry, cycling+ferry, driving+ferry, driving+public_transport.

arrival_searches.one_to_many.arrival_time_period

string

Possible values: weekday_morning

arrival_searches.one_to_many.travel_time

integer

Maximum journey time (in seconds).
Maximum value is 10800 (3 hours) as standard. To discuss increasing this, please contact hello@traveltime.com.

arrival_searches.one_to_many.level_of_detail

object | optional

Specifies level of detail of returned shape.

Show child attributes

arrival_searches.one_to_many.level_of_detail.scale_type

string

simple - level of detail is specified using a simple enumeration.
simple_numeric - level of detail is specified using integer numbers. This scale is an extension of simple scale.
coarse_grid - level of detail is specified as a number, used to simplify the generated shape to a set grid density.

Exact availability depends on the licence plan.

arrival_searches.one_to_many.level_of_detail.level

string | integer | optional

Can either be a string or an integer depending on scale_type used.

Available options when using string: lowest, low, medium, high, highest. Used with simple scale type. Returned shape will be the least detailed with the lowest setting, and the most detailed with the highest setting.
Available options when using integer are between -20 and 2. Used with simple_numeric scale type. The lower the number, the less detailed the returned shape will be. Values from -2 to 2 are equivalent to the lowest to highest values of the simple scale type.

arrival_searches.one_to_many.level_of_detail.square_size

integer | optional

arrival_searches.one_to_many.polygons_filter

object | optional

Specifies polygon filter of a single shape.

Show child attributes

arrival_searches.one_to_many.polygons_filter.limit

integer

At most this amount of largest polygons will be returned in a single shape. Must be greater than 0.

arrival_searches.one_to_many.no_holes

boolean | optional

Enable to remove holes from returned polygons.
Note that this will likely result in loss in accuracy.

arrival_searches.one_to_many.render_mode

string | optional

approximate_time_filter (default) - the shape matches time-filter results as much as possible
road_buffering - the shape looks as if traversed roads of the search have been painted over with a wide brush

arrival_searches.one_to_many.snapping

object | optional

Adjusts the process of looking up the nearest roads from the departure / arrival points.

Show child attributes

arrival_searches.one_to_many.snapping.penalty

string | optional

enabled (default) - walking time and distance from the departure location to the nearest road and from the nearest road to the arrival location are added to the total travel time and distance of a journey.
disabled - these walking times and distances are not added to the total reported values (i.e the journey effectively starts and ends at the nearest points on the road network).

arrival_searches.one_to_many.snapping.accept_roads

string | optional

both_drivable_and_walkable (default) - journey can only start or end on roads that are accessible by both: cars and pedestrians. This effectively means journeys can not start / end on motorways.
any_drivable - journey can start or end on any road accessible by a car (including motorways).

Response Body

We support multiple response formats, the format can be set using the Accept header. Supported formats:

application/json - This is the default if no format was specified.
application/vnd.wkt+json
application/vnd.wkt-no-holes+json
application/geo+json
application/vnd.bounding-boxes+json - This format does not include holes

When `output_format` is `application/json`

results

array[object]

The results array which is sorted lexicographically by the id attribute.

Hide child attributes

results.search_id

string

results.shapes

array[object]

Show child attributes

results.shapes.shell

array[object]

Show child attributes

results.shapes.shell.lat

float

Latitude.

results.shapes.shell.lng

float

Longitude.

results.shapes.holes

array[array[object]]

Show child attributes

results.shapes.holes.lat

float

Latitude.

results.shapes.holes.lng

float

Longitude.

results.properties

object

Properties array. Only the properties included in the request are returned.

Show child attributes

results.properties.is_only_walking

boolean | optional

Indicates if the returned shape contains only walking instead of a requested mode like bus, public_transport, etc.

When `output_format` is `application/geo+json`

type

FeatureCollection

features

array[Feature]

Contains collection of features.

Hide child attributes

features.type

Feature

features.geometry

object

Contains MultiPolygon.

Show child attributes

features.geometry.type

MultiPolygon

features.geometry.coordinates

array[object]

Coordinates of polygons.

features.properties

object

Feature properties.

Show child attributes

features.properties.search_id

string

When `output_format` is `application/vnd.wkt+json or application/vnd.wkt-no-holes+json`

results

array[object]

The results array which is sorted lexicographically by the id attribute.

Hide child attributes

results.search_id

string

results.shape

string

A string containing the shape in Well-known text (WKT)

results.properties

object

Properties array. Only the properties included in the request are returned.

Show child attributes

results.properties.is_only_walking

boolean | optional

Indicates if the returned shape contains only walking instead of a requested mode like bus, public_transport, etc.

When `output_format` is `application/vnd.bounding-boxes+json`

results

array[object]

The results array which is sorted lexicographically by the id attribute.

Hide child attributes

results.search_id

string

results.bounding_boxes

array[object]

Show child attributes

results.bounding_boxes.envelope

object

Show child attributes

results.bounding_boxes.envelope.min_lat

float

Latitude of lower left point of the box.

results.bounding_boxes.envelope.max_lat

float

Latitude of upper right point of the box.

results.bounding_boxes.envelope.min_lng

float

Longitude of lower left point of the box.

results.bounding_boxes.envelope.max_lng

float

Longitude of upper right point of the box.

results.bounding_boxes.boxes

array[object]

Show child attributes

results.bounding_boxes.boxes.min_lat

float

Latitude of lower left point of the box.

results.bounding_boxes.boxes.max_lat

float

Latitude of upper right point of the box.

results.bounding_boxes.boxes.min_lng

float

Longitude of lower left point of the box.

results.bounding_boxes.boxes.max_lng

float

Longitude of upper right point of the box.

results.properties

object

Properties array. Only the properties included in the request are returned.

Show child attributes

results.properties.is_only_walking

boolean | optional

Indicates if the returned shape contains only walking instead of a requested mode like bus, public_transport, etc.

Request

Loading

Response Body

Loading

Example Request

Loading

Response body

Loading

Isochrones (Fast)

Request Body

Response Body

When output_format is application/json

When output_format is application/geo+json

When output_format is application/vnd.wkt+json or application/vnd.wkt-no-holes+json

When output_format is application/vnd.bounding-boxes+json

Request

Response Body

When `output_format` is `application/json`

When `output_format` is `application/geo+json`

When `output_format` is `application/vnd.wkt+json or application/vnd.wkt-no-holes+json`

When `output_format` is `application/vnd.bounding-boxes+json`