/v4/time-map
Visualise where's reachable within a travel time catchment area.
Access URL: https://api.traveltimeapp.com/v4/time-map
Supports two HTTP request types:
- GET - for simple requests using basic parameters only
- POST - for more complex requests using advanced parameters
A POST request should be used for any of the following use cases:
- Using advanced parameters not available in the GET request
- Creating multiple isochrones with one request
- Calculating the Union or Intersection of multiple isochrones
The access URL is the same as the GET request format, but the differences are:
- Authentication is included in the request Headers
- Parameters are included in the request Body
array[object]
Searches based on departure time. Leave departure location at no earlier than given time. You can define a maximum of 10
searches.
string
Used to identify each search in the results array. Must be unique among all searches.
object
Coordinates of the departure location.
float
Latitude.
float
Longitude.
date in extended ISO-8601 format
Leave departure location at no earlier than given time. In ISO 8601 format. For example:
2024-12-05T07:00:00Z
(representing UTC)
2024-12-05T07:00:00-05:00
(representing New York on Standard Time: UTC-05:00)
integer
Maximum journey time (in seconds). Maximum value is 14400
(4 hours) as standard. To discuss increasing this, please contact sales@traveltime.com.
Transportation mode and related parameters. type
is a mandatory field, but all other fields are optional and default values are used if not specified.
cycling
, driving
, driving+train
(only in Great Britain), public_transport
, walking
, coach
, bus
, train
, ferry
, driving+ferry
, cycling+ferry
or cycling+public_transport
(only in Netherlands).
Note - a driving+train
search is for driving then train (i.e driving to a station and continuing by train). The maximum drive time can be configured using the driving_time_to_station
parameter
array[string] | optional
Additional road types to included when executing search.
Only affects driving
and driving+ferry
transportation modes.
Possible values:
track
- unpaved roads that only allow very slow driving speed or even require an off-road capable vehicle.restricted
- roads that are not publicly accessible and may require a special permit. By default all of these roads are excluded from the search.
integer | optional
Maximum time (in seconds) allowed for walking at the start and end of a public transport journey. i.e:
- the maximum walking time from the origin to the first stop/station, and
- the maximum walking time from the final stop/station to the destination
These limits are independent and not cumulative. They only apply to the first and last walking legs of the journey - all walking times between public transport legs are limited to 600s (10 minutes) each.
The default value is 900
.
Cannot be higher than travel_time
.
Used in public_transport
, coach
, bus
, train
, driving+train
and cycling+public_transport
transportation modes.
integer | optional
Time in seconds needed to board public transportation vehicle.
Default is 0
.
Cannot be higher than travel_time
.
Used in public_transport
, coach
, bus
, train
, driving+train
and cycling+public_transport
transportation modes.
integer | optional
Maximum time (in seconds) allowed for driving from the origin to the train station.
Default value is 1800
.
Cannot be higher than travel_time
.
Used only in driving+train
transportation mode.
integer | optional
Maximum time (in seconds) allowed for cycling (including any ferry transfers) from the origin to the first stop/station.
Default value is 900
.
Cannot be higher than travel_time
.
Used only in cycling+public_transport
transportation mode.
integer | optional
Time in seconds required to park a car or a bicycle.
Default value is 300
.
Cannot be higher than travel_time
.
Used in driving+train
and cycling+public_transport
transportation modes.
integer | optional
Time in seconds required to board a ferry.
Default value is 0
.
Cannot be higher than travel_time
.
Used in ferry
, driving+ferry
, cycling+ferry
and cycling+public_transport
transportation modes. For public_transport
mode, pt_change_delay
is used instead.
boolean | optional
If set to true
, the crossing of country borders is disabled. Only available with the driving
transportation mode, and is enabled by default (false
).
object | optional
Upper limit for the number of changes between public transit legs in a journey.
Used in public_transport
, coach
, bus
, train
, driving+train
and cycling+public_transport
transportation modes. For other modes the max_changes
parameter is ignored.
Enable transit leg change limit?
Maximum number of changes between transit legs in a journey. Must be at least 0
.
object | optional
When enabled, range adds a departure window to the departure time, and a combined shape of all possible journeys departing within the window is returned.
Disabled by default.
Used in public_transport
, coach
, bus
, train
and driving+train
transportation modes. For other modes range search parameters are ignored.
boolean
Enable range search?
integer
The width of the range window (in seconds).
The window is applied 'forwards' from the departure time. For example, with a departure_time
of 9am and a range
width of 1 hour, all journeys departing between 9am and 10am will be included.
Maximum value is 43200
(12 hours).
array[string] | optional
Properties to be returned about the shapes.
Possible values: is_only_walking
.
When selected, the is_only_walking
parameter will return a value of True if a journey only involves walking (e.g for a public transport search in an area with no public transport available).
object | optional
Specifies level of detail of returned shape.
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.
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 withsimple
scale type. Returned shape will be the least detailed with thelowest
setting, and the most detailed with thehighest
setting.Available options when using integer are between
-20
and2
. Used withsimple_numeric
scale type. The lower the number, the less detailed the returned shape will be. Values from-2
to2
are equivalent to the lowest to highest values of the simple scale type.
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
.
object | optional
Specifies polygon filter of a single shape.
At most this amount of largest polygons will be returned in a single shape. Must be greater than 0.
boolean | optional
Enable to remove holes from returned polygons.
Note that this will likely result in loss in accuracy.
string | optional
approximate_time_filter
(default) - the shape matches time-filter results as much as possibleroad_buffering
- the shape looks as if traversed roads of the search have been painted over with a wide brush
boolean | optional
true
(default) - returned shape will not cover large nearby water bodiesfalse
- returned shape may cover nearby water bodies like large lakes, wide rivers and seas
object | optional
Adjusts the process of looking up the nearest roads from the departure / arrival points.
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).
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).
array[object]
Searches based on arrival time. Arrive at destination location at no later than given time. You can define a maximum of 10
searches.
string
Used to identify each search in the results array. Must be unique among all searches.
object
Coordinates of the arrival location.
float
Latitude.
float
Longitude.
date in extended ISO-8601 format
Be at arrival location at no later than given time. In ISO 8601 format. For example:
2024-12-05T07:00:00Z
(representing UTC)
2024-12-05T07:00:00-05:00
(representing New York on Standard Time: UTC-05:00)
integer
Maximum journey time (in seconds). Maximum value is 14400
(4 hours) as standard. To discuss increasing this, please contact sales@traveltime.com.
Transportation mode and related parameters. type
is a mandatory field, but all other fields are optional and default values are used if not specified.
cycling
, driving
, driving+train
(only in Great Britain), public_transport
, walking
, coach
, bus
, train
, ferry
, driving+ferry
, cycling+ferry
or cycling+public_transport
(only in Netherlands).
Note - a driving+train
search is for driving then train (i.e driving to a station and continuing by train). The maximum drive time can be configured using the driving_time_to_station
parameter
array[string] | optional
Additional road types to included when executing search.
Only affects driving
and driving+ferry
transportation modes.
Possible values:
track
- unpaved roads that only allow very slow driving speed or even require an off-road capable vehicle.restricted
- roads that are not publicly accessible and may require a special permit. By default all of these roads are excluded from the search.
integer | optional
Maximum time (in seconds) allowed for walking at the start and end of a public transport journey. i.e:
- the maximum walking time from the origin to the first stop/station, and
- the maximum walking time from the final stop/station to the destination
These limits are independent and not cumulative. They only apply to the first and last walking legs of the journey - all walking times between public transport legs are limited to 600s (10 minutes) each.
The default value is 900
.
Cannot be higher than travel_time
.
Used in public_transport
, coach
, bus
, train
, driving+train
and cycling+public_transport
transportation modes.
integer | optional
Time in seconds needed to board public transportation vehicle.
Default is 0
.
Cannot be higher than travel_time
.
Used in public_transport
, coach
, bus
, train
, driving+train
and cycling+public_transport
transportation modes.
integer | optional
Maximum time (in seconds) allowed for driving from the origin to the train station.
Default value is 1800
.
Cannot be higher than travel_time
.
Used only in driving+train
transportation mode.
integer | optional
Maximum time (in seconds) allowed for cycling (including any ferry transfers) from the origin to the first stop/station.
Default value is 900
.
Cannot be higher than travel_time
.
Used only in cycling+public_transport
transportation mode.
integer | optional
Time in seconds required to park a car or a bicycle.
Default value is 300
.
Cannot be higher than travel_time
.
Used in driving+train
and cycling+public_transport
transportation modes.
boolean | optional
If set to true
, the crossing of country borders is disabled. Only available with the driving
transportation mode, and is enabled by default (false
).
integer | optional
Time in seconds required to board a ferry.
Default value is 0
.
Cannot be higher than travel_time
.
Used in ferry
, driving+ferry
, cycling+ferry
and cycling+public_transport
transportation modes. For public_transport
mode, pt_change_delay
is used instead.
object | optional
Upper limit for the number of changes between public transit legs in a journey.
Used in public_transport
, coach
, bus
, train
, driving+train
and cycling+public_transport
transportation modes. For other modes the max_changes
parameter is ignored.
Enable transit leg change limit?
Maximum number of changes between transit legs in a journey. Must be at least 0
.
object | optional
When enabled, range
adds an arrival window to the arrival time, and a combined shape of all possible journeys arriving within the window is returned.
Disabled by default.
Used in public_transport
, coach
, bus
, train
and driving+train
transportation modes. For other modes range search parameters are ignored.
boolean
Enable range search?
integer
The width of the range window (in seconds).
The window is applied 'backwards' from the arrival time. For example, with an arrival_time
of 9am and a range
width of 1 hour, all journeys arriving between 8am and 9am will be included.
Maximum value is 43200
(12 hours).
array[string] | optional
Properties to be returned about the shapes.
Possible values: is_only_walking
.
When selected, the is_only_walking
parameter will return a value of True if a journey only involves walking (e.g for a public transport search in an area with no public transport available).
object | optional
Specifies level of detail of returned shape.
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.
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 withsimple
scale type. Returned shape will be the least detailed with thelowest
setting, and the most detailed with thehighest
setting.Available options when using integer are between
-20
and2
. Used withsimple_numeric
scale type. The lower the number, the less detailed the returned shape will be. Values from-2
to2
are equivalent to the lowest to highest values of the simple scale type.
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
.
object | optional
Specifies polygon filter of a single shape.
integer
At most this amount of largest polygons will be returned in a single shape. Must be greater than 0.
boolean | optional
Enable to remove holes from returned polygons.
Note that this will likely result in loss in accuracy.
string | optional
approximate_time_filter
(default) - the shape matches time-filter results as much as possibleroad_buffering
- the shape looks as if traversed roads of the search have been painted over with a wide brush
boolean | optional
true
(default) - returned shape will not cover large nearby water bodiesfalse
- returned shape may cover nearby water bodies like large lakes, wide rivers and seas
object | optional
Adjusts the process of looking up the nearest roads from the departure / arrival points.
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).
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).
array[object]
Define the unions of shapes that are the results of previously defined departure or arrival searches. You can define a maximum of 10
unions per request.
array[string]
A list of the search ids referring to the shapes to be used for calculating the union.
array[object]
Define the intersections of shapes that are the results of previously defined departure or arrival searches. You can define a maximum of 10
intersections per request.
string
Used to identify each search in the results array. Must be unique among all searches.
array[string]
A list of the search ids referring to the shapes to be used for calculating the intersection.
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.google-earth.kml+xml
application/vnd.bounding-boxes+json
- This format does not include holes
array[object]
The results array which is sorted lexicographically by the id
attribute.
object
Properties array. Only the properties included in the request are returned.
boolean | optional
Indicates if the returned shape contains only walking
instead of a requested mode like bus
, public_transport
, etc.
FeatureCollection
array[Feature]
Contains collection of features.
object
Feature properties.
string
array[object]
The kml array containing objects of xml namespace and placemark.
array[object]
The results array which is sorted lexicographically by the id
attribute.
A string containing the shape in Well-known text (WKT)
object
Properties array. Only the properties included in the request are returned.
boolean | optional
Indicates if the returned shape contains only walking
instead of a requested mode like bus
, public_transport
, etc.
array[object]
The results array which is sorted lexicographically by the id
attribute.
array[object]
object
Latitude of lower left point of the box.
Latitude of upper right point of the box.
Longitude of lower left point of the box.
Longitude of upper right point of the box.
array[object]
Latitude of lower left point of the box.
Latitude of upper right point of the box.
Longitude of lower left point of the box.
Longitude of upper right point of the box.
object
Properties array. Only the properties included in the request are returned.
boolean | optional
Indicates if the returned shape contains only walking
instead of a requested mode like bus
, public_transport
, etc.
Loading
A GET request is the simplest way to generate an isochrone. A single isochrone can be generated by specifying the query parameters in the URL.
string
Mode of transport used.
Available options: walking
, public_transport
, driving
, cycling
.
integer
Maximum journey time (in seconds).
Maximum value is 14400 (4 hours).
float
Latitude of the search location.
float
Longitude of the search location.
date in extended ISO-8601 format | optional
If specified, this time will be used as the time of departure from the search location. One of departure_time
or arrival_time
must be specified.
date in extended ISO-8601 format | optional
If specified, this time will be used the time of arrival at the search location. One of arrival_time
or departure_time
must be specified.
string
Used for authenticating the request. Visit our developer portal to access your credentials or generate new ones.
string
Used for authenticating the request. Visit our developer portal to access your credentials or generate new ones.
Successful requests will return an HTTP 200 response.
Response schema - application/json
array[object]
The results array which is sorted lexicographically by the id
attribute.
object
Properties array. Only the properties included in the request are returned.
boolean | optional
Indicates if the returned shape contains only walking
instead of a requested mode like bus
, public_transport
, etc.
Example request
https://api.traveltimeapp.com/v4/time-map?type=public_transport&travel_time=3600&lat=41.12332&lng=-0.12422&arrival_time=2024-12-05T08:00:00Z&app_id=YOUR_APP_ID&api_key=YOUR_APP_KEY
Please note that to send the GET request you will need to replace the YOUR_APP_ID
and YOUR_APP_KEY
values with your own credentials.