/v4/distance-map
Visualise where's reachable within a travel distance catchment area.
Access URL: https://api.traveltimeapp.com/v4/distance-map
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:
2023-10-02T12:00:00Z
(representing UTC)
2023-10-02T12:00:00-05:00
(representing New York on Standard Time: UTC-05:00)
Maximum journey distance (in meters). Maximum value is 800000
(800km) as standard. Minimum value is 75
meters. Although travel distance is limited, computations are still performed by considering fastest journeys (minimizing travel time). 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.
driving
, walking
, cycling
, driving+ferry,
, cycling+ferry
, ferry
.
integer | optional
Time in seconds required to board a ferry.
Default value is 0
.
Cannot be higher than 1h
.
Used in driving
, walking
, cycling
, driving+ferry
, cycling+ferry
and ferry
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
).
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
.
boolean | optional
Enable to return only one shape from the search results. The returned shape will be approximately the biggest one among search results.
Note that this will likely result in loss in accuracy.
boolean | optional
Enable to remove holes from returned polygons.
Note that this will likely result in loss in accuracy.
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:
2023-10-02T12:00:00Z
(representing UTC)
2023-10-02T12:00:00-05:00
(representing New York on Standard Time: UTC-05:00)
integer
Maximum journey distance (in meters). Maximum value is 800000
(800km) as standard. Minimum value is 75
meters. Although travel distance is limited, computations are still performed by considering fastest journeys (minimizing travel time). 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.
driving
, walking
, cycling
, driving+ferry,
, cycling+ferry
, ferry
.
integer | optional
Time in seconds required to board a ferry.
Default value is 0
.
Cannot be higher than 1h
.
Used in driving
, walking
, cycling
, driving+ferry
, cycling+ferry
and ferry
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
).
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
.
boolean | optional
Enable to return only one shape from the search results. The returned shape will be approximately the biggest one among search results.
Note that this will likely result in loss in accuracy.
boolean | optional
Enable to remove holes from returned polygons.
Note that this will likely result in loss in accuracy.
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/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.
FeatureCollection
array[Feature]
Contains collection of features.
object
Feature properties.
string
object
Contains 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.
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.
Loading
Loading
Example Request
Loading
Response body
Loading