NOTICE: all v1 APIs (without /vX/ at the begining) calculates times from current time moment in UTC timezone.
Use v2 APIs if you want to provide your own start time (useful for public transport).
Read about CORS support at HTML5 Rocks.
Each request must have following keys in request json set: "app_id" and "app_key"
ISO formatted date, e.g. "2012-11-26T18:14:52.892+02:00"
Coordinates in the WGS 84 format, in degrees.
{"lat": Double, "lng": Double}
e.g. {"lat": 12.3, "lng": -3.22}
Coordinates in the WGS 84 format, in degrees.
[lat (Double), lng (Double)]
e.g. [12.3, -3.22]
Point with id value attached.
{"id": String, "lat": Double, "lng": Double}
Transportation mode that is used.
This parameter can be used in two ways.
"mode": "cycling", "cycling_ferry", "driving", "driving+train", "driving_ferry", "public_transport", "walking", "walking+coach", "walking_bus", "walking_ferry" or "walking_train"
"mode": {
"mode": "cycling", "cycling_ferry", "driving", "driving+train", "driving_ferry", "public_transport", "walking", "walking+coach", "walking_bus", "walking_ferry" or "walking_train",
... extra parameters may follow ...
}
!!! None of these parameters can be more than travel time !!!
Note: setting limits to a low value or penalties to a high value might result in routes not found.
{
# Time it takes to board or disembark a ferry with a car (in seconds).
# default: 0
"boarding-time": null|Int
}
{
# Change delay between driving and walking (in seconds).
# default: 300
"change-delay": null|Int,
# Maximum time spent driving (in seconds).
# default: 40% of travel time, but in range [1800, 3600]
"driving-time-limit": null|Int,
# Maximum time spent walking from last station to target location (in seconds)
# default: 40% of travel time, but in range [900, 2100]
"walking-from-station-limit": null|Int,
# Time needed to board public transportation vehicle (in seconds).
# default: 0
"pt-change-penalty": null|Int
}
Applies to the following transportation modes: "public_transport", "walking+coach", "walking_bus" or "walking_train"
{
# Maximum time (in seconds) of walking from source to a station/stop or from
# a station/stop to target. default: 40% of travel time, but in range [900, 2100]
time-to-station-limit: null|Int,
# Time needed to board public transportation vehicle (in seconds).
# default: 0
"pt-change-penalty": null|Int
}
String that describes type of the edge.
values: "bike", "boarding", "bus", "cable_car", "car", "coach", "ferry", "parking", "plane", "rail_dlr", "rail_national", "rail_overground", "rail_underground", "train" or "walk"
DEPRECATED
Will always be "exact" and can be safely ignored.
Double between 0 and 1 that represents percentage. E.g. 45.32% would be 0.4532 and 85.881% would be 0.85881
A cluster represents a closed shape.
[CoordsV2, CoordsV2, ...]
A cluster represents a closed shape and its holes.
{
# Outer bounding shell.
"shell": [CoordsV2, CoordsV2, ...],
# Array of holes within that shell. Can be empty.
"holes: [
[CoordsV2, CoordsV2, ...],
[CoordsV2, CoordsV2, ...],
...
]
}
Polygon or a cluster of polygons represented as Well Known Text format.
It can be either POLYGON if only one cluster is present or MULTIPOLYGON if multiple clusters are present.
Points in polygons are oriented anti-clockwise and represented by "lon lat" pairs.
http://en.wikipedia.org/wiki/Well-known_text
A shape representation using a collection of bounding boxes.
[
{
# The envelope (minimum and maximum coordinates) of a part of the shape
"envelope": Box
# A collection of bounding boxes specyfing this shape
"boxes": [Box, Box, ...]
},
...
The Box type:
Box: {
"min_lon": Float,
"max_lon": Float,
"min_lat": Float,
"max_lat": Float
}
Input for many postcode actions.
{
"travel_time": Int,
"start_time": DateTime,
"origin": CoordsV2,
"mode": TransportationMode
}
Input for many inverse postcode actions.
{
"travel_time": Int,
"arrival_time": DateTime,
"origin": CoordsV2,
"mode": TransportationMode
}
{
"type": String, # possible values: "single", "week", "month", "year"
"price": Double,
"currency": String # ISO 4217 currency code
}
{
"modes": [TransportationMode, TransportationMode, ...],
"tickets": [Ticket, Ticket, ...],
#part ids for the fare
"parts": [Int, Int, ...]
}
{
"modes": [TransportationMode, TransportationMode, ...],
"tickets": [Ticket, Ticket, ...]
}
[String, String, ...]
Specifies which data properties you want to know about the points. Valid values are:
"cycling", "cycling_ferry", "driving", "driving_ferry", "walking" or "walking_ferry". Other transportation modes will have a constant distance of -1.[String, String, ...]
Specifies which data properties you want to know about the points. Valid values are:
"cycling", "cycling_ferry", "driving", "driving_ferry", "walking" or "walking_ferry". Other transportation modes will have a constant distance of -1."driving+train", "public_transport", "walking+coach", "walking_bus" or "walking_train".A Hash with one or more properties that you requested. Examples:
{"time": Int, "distance": Int}
{"distance": Int}
{"distance_breakdown": {EdgeType: Int}}A Hash with one or more properties that you requested. Examples:
{"time": Int, "distance": Int}
{"distance": Int}
{"distance_breakdown": {EdgeType: Int}}
{"fares": [ModeFares (TimeFilter), ModeFares (TimeFilter), ...]}
{"fares_total": [Ticket, Ticket, ...]}Structure describing one part of the route.
{
"mode": EdgeType,
# Array of coordinates for this route part. Can be used to draw a polyline
# on a map.
"coords": [CoordsV2, CoordsV2, CoordsV2, ...],
"directions: String, # textual description in English of this route part
"distance": Int, # distance covered in metres for this route part
"time": Int, # time taken to travel through this route part in seconds
"id": Int
}
Structure describing route start and end.
{
"mode": EdgeType,
# Array of coordinates for this route part. Can be used to draw a polyline
# on a map.
"coords": [CoordsV2, CoordsV2, CoordsV2, ...],
"directions: String, # textual description in English of this route part
"distance": Int, # distance covered in metres for this route part
"time": Int, # time taken to travel through this route part in seconds
"direction": String, # Cardinal direction in English ("north", "northeast", "east", "southeast", ...)
"id": Int
}
Structure describing routing on public roads, i.e. walking or driving.
{
"mode": EdgeType,
# Array of coordinates for this route part. Can be used to draw a polyline
# on a map.
"coords": [CoordsV2, CoordsV2, CoordsV2, ...],
"directions: String, # textual description in English of this route part
"distance": Int, # distance covered in metres for this route part
"time": Int, # time taken to travel through this route part in seconds
"road": null|String, # name of the road
"turn": null|String, # turn direction in English ("straight", "slight_left", "slight_right", "left" or "right")
"id": Int
}
Structure describing routing using public transport, i.e. bus or train.
{
"mode": EdgeType,
# Array of coordinates for this route part. Can be used to draw a polyline
# on a map.
"coords": [CoordsV2, CoordsV2, CoordsV2, ...],
"directions: String, # textual description in English of this route part
"distance": Int, # distance covered in metres for this route part
"time": Int, # time taken to travel through this route part in seconds
"line": String, # Name of the public transport line (e.g. bus number)
"departure_station": String, # name of the departure station
"arrival_station": String, # name of the arrival station
"depart_time": String, # local time of departure in 'HH:mm' format
"arrive_time": String, # local time of arrival in 'HH:mm' format
"num_stops": Int, # number of stops to go on this route part
"id": Int
}
Structure describing route for a single target point.
{
"departure": DateTime, # departure time from the user origin point
"arrival": DateTime, # arrival time at the user destination point
"time": Int, # total travel time in seconds
"distance": Int, # total distance traveled in meters
"num_trips": Int, # total number of trips using public transport
# array of all the route parts that describe this route
"parts": [ BasicDescriptionPart | StartEndDescriptionPart | RoadDescriptionPart | PublicTransportDescriptionPart , BasicDescriptionPart | StartEndDescriptionPart | RoadDescriptionPart | PublicTransportDescriptionPart , ...],
#data included only if "include_fares": true
"fares": [ModeFares (Route), ModeFares (Route), ...],
#data included only if "include_fares": true
"fares_total": [Ticket, Ticket, ...]
}
Structure telling that a point cannot be routed due to an error.
{
"code": String, # One of the error codes.
"params": {String, ?}, # Error dependent parameters.
"details": String # Human-readable error description.
}
Following errors are defined:
This point couldn't be routed, because it was too close to the source/destination.
Params:
{
"p1": CoordsV2, # First point
"p2": CoordsV2 # Second point
}
Each request can fail with one of predefined error codes. In the event of failure following JSON response will be returned.
{"code": one of error codes, "details": human readable error description}
Defined error codes are listed below:
"json-error", HTTP status: Bad Request (400) - returned when body request cannot be parsed as valid JSON."bad-params", HTTP status: Bad Request (400) - returned when given parameters are not valid."bad-auth-params", HTTP status: Bad Request (400) - returned when auth params are missing or invalid."no-auth", HTTP status: Unauthorized (401) - returned when auth params are in correct format but are unknown to us."limit-reached", HTTP status: Too Many Requests (429) - returned when request limit for a time frame is reached."out-of-reach", HTTP status: OK (200) - returned when we have the data set, but there are no useful data around a given location."no-data", HTTP status: OK (200) - returned when we do not have any data in given location, also returned when requesting additional data (e.g. fares or postcodes) on location that does not support it."timed-out", HTTP status: Service Unavailable (503) - returned when one of our servers which might hold the requested data is down."metadata-missing", HTTP status: Internal Server Error (500) - returned when The metadata needed to finish the request is missing."internal-server-error", HTTP status: Internal Server Error (500) - returned when one of our servers which might hold the requested data has encountered an error and was unable to fulfill the request./has_data
{"coords": CoordsV2}
One of following:
out-of-reachno-data/has_data/has_data (CORS support)/time_filter
{
# Limits max. travel time from your origin to each of the given points.
# If travel time to a certain point exceeds this value such point will be
# omitted in the result set.
#
# In seconds.
"travel_time": Int,
"origin": CoordsV1,
# Points that wou need travel time calculated for.
"points": [PointWithId, PointWithId, ...],
"mode": TransportationMode
}
{
# ids are taken from PointWithId.
# Int represents time from our origin to that point in seconds.
"id1": Int, "id2": Int, ...
}
/time_filter/time_filter (CORS support)/v2/time_filterGiven origin point, max travel time and start time finds wanted properties for given set of destination points using given transportation modes.
{
"travel_time": Int,
"origin": CoordsV2,
"points": {"id1": CoordsV2, "id2": CoordsV2, ...},
"modes": [TransportationMode, TransportationMode, ...],
# Specifies when do we start our search.
"start_time": DateTime,
"properties": RequestProperties V2
}
{
# Each transportation mode you requested has a hash.
TransportationMode => {
"accuracy": Accuracy,
"times": {"id1": ResponseProperties V2, "id2": ResponseProperties V2, ...}
},
TransportationMode => {...},
...
}
/v2/time_filter/v2/time_filter (CORS support)/v3/time_filterGiven origin and destination points find out properties of connections between origin and destination points.
{
"points": {"p1": CoordsV2, "p2": CoordsV2, ...},
# We start our journey from each source and arrive at each point, returning
# requested properties.
"sources": {
"source1": {
"travel_time": Int,
"coords": CoordsV2,
"mode": TransportationMode,
"properties": RequestProperties V3,
"start_time": DateTime,
},
...
},
# We start our journey from each point and arrive at each destination,
# returning requested properties.
"destinations": {
"destination1": {
"travel_time": Int,
"coords": CoordsV2,
"mode": TransportationMode,
"properties": RequestProperties V3,
"arrival_time": DateTime,
},
...
},
# Relevant only for public transportation modes.
# If false (default) travel time to destinations (from sources) includes
# waiting time for the first vehicle at the origin point. If true waiting
# time is removed.
"remove_wait_time": null|Boolean
}
{
"accuracy": Accuracy,
# If point is outside travel time it is not included in here.
"points": {
"p1": ResponseProperties V3, "p2": ResponseProperties V3, ...
}
}
{
"sources": {
# Each point gets either a result set or one of the error code hashes.
"source1": Result | error `no-data` | error `out-of-reach` | error `timed-out` | error `bad-params`,
"source2": Result | error `no-data` | error `out-of-reach` | error `timed-out` | error `bad-params`,
...
},
"destinations": {
# Each point gets either a result set or one of the error code hashes.
"destination1": Result | error `no-data` | error `out-of-reach` | error `timed-out` | error `bad-params`,
"destination2": Result | error `no-data` | error `out-of-reach` | error `timed-out` | error `bad-params`,
...
}
}
/v3/time_filter/v3/time_filter (CORS support)/time_map
{
# Maximum number of seconds needed to reach each point in result area.
"travel_time": Int,
"origin": CoordsV1,
"mode": TransportationMode,
# Should the shape be smoothed?
"smooth": Boolean
}
Shapes with counter-clockwise orientation.
[Cluster, Cluster, ...] /time_map/time_map (CORS support)/v2/time_mapGiven origin point, max travel time and start time find areas to which you can arrive in that travel time using given transportation mode.
{
"start_time": DateTime,
# Maximum number of seconds needed to reach each point in result area.
"travel_time": Int,
"origin": CoordsV2,
"mode": TransportationMode,
# Should the shape be smoothed?
"smooth": Boolean,
# Optional parameter that switches shape simplification on (true, not specified - old behaviour) and
# off (false). In case this is true and max_points is not specified, shape is simplified so that
# it remains similar to the original shape.
"simplify": null|Boolean
# Optional parameter that allows you to specify maximum number of points in
# returned cluster. If more than one cluster is returned, points are divised
# proportionally between clusters.
"max_points": null|Int
}
{
"accuracy": Accuracy,
# Shapes with counter-clockwise orientation.
"shape": [Cluster, Cluster, ...]
}
/v2/time_map/v2/time_map (CORS support)/v2/time_map.wktSame as v2 of time map, but shape is returned as WKT string without holes.
/v2/time_map.wkt/v2/time_map.wkt (CORS support)/v3/time_mapGiven X origins find shapes of zones reachable within each corresponding travel time and intersections of those zones.
You are in your job and want to watch a sports game in a pub after work. Given that you have 30 minutes between your shift end and when match starts you need to find a suitable sports pub using public transport.
John, Tom and Bob want to meet for a chat in a pub. They all live in different places but want to meet in 30 minutes by using public transport.
You can use this method to obtain all zones in which they could meet.
You get a new job in London and are searching for a place to rent. You want to arrive to work at 9 AM in 15 minutes either by walking or by public transport.
Using this request you can set your new job as the destination and receive a time map of potential places for your new home.
You and your partner both get a new job in London. However this time you have two different destinations. One of you (A) has to be at work at 8:30 AM and can spare 30 minutes of driving, whilst another one (B) must be at work at 7 AM and wants to walk for 10 minutes max.
Using this request you can find time maps for persons A and B and intersection between them where your new home could be.
{
"format": "array", "hash", "wkt", "wkt-no-holes", "bounding-boxes-no-holes"
# Should the shapes be smoothed or not?
"smooth": Boolean,
"targets": {
"id1": {
"coords": CoordsV2,
# Specifies when do we want to either:
# - Start our journey from this point at given time.
# - Arrive at this point at given time.
"start_time" | "arrival_time": DateTime,
# Maximum number of seconds between target and edge of the zone.
"travel_time": Int,
"mode": TransportationMode
},
...
},
# Specify which individual targets you want to get.
"shapes": {
"id1": {"simplify": Simplify, "max_points": MaxPoints},
...
},
# Specify which intersections of areas you want to get.
"intersections": {
# Returns intersection between areas for origins id1 and id3 as inter1.
"inter1": {
"simplify": Simplify,
"max_points": MaxPoints,
"targets": ["id1", "id3"]
},
"inter2": {
"simplify": Simplify,
"max_points": MaxPoints,
"targets": ["id1", "id2", "id3"]
},
...
},
# Specify which unions of areas you want to get.
"unions": {
# Returns union of areas for origins id1 and id3 as union1.
"union1": {
"simplify": Simplify,
"max_points": MaxPoints,
"targets": ["id1", "id3"]
},
"union2": {
"simplify": Simplify,
"max_points": MaxPoints,
"targets": ["id1", "id2", "id3"]
},
...
}
}
Optional boolean parameter that switches simplification on or off.
If this parameter is not specified behaviour is solely decided by 'max_points' parameter.
If this is 'true' and 'max_points = 0' , shape is simplified so that it remains similar enough (and that is decided by internals of this service) to original shape.
If this is 'true' and 'max_points >= 4', shape is simplified so that it does not have more points than the given value.
This parameter is ignored for the BoundingBox format.
Maximum number of points in each polygon you want to get. If polygon has more polygons than this, its size is reduced using Ramer–Douglas–Peucker algorithm.
Specify Int (>= 4) or 0 for no limit.
This parameter is ignored for the BoundingBox format.
Hash containing requested shapes for origins, their intersections and unions.
{
"accuracy": Accuracy,
"shape": Shape
}
Depending on requested format Shape will be:
{
# Shape, intersection and union responses. If an error occurs while obtaining
# the response, it will be missing from this hash.
"results": {
# Target polygons have exterior ring in counter-clockwise orientation and
# holes in clockwise orientation.
"id1": Result,
"id2": Result,
# For intersections and unions errors will occur if at least one of the
# targets errors out.
# Polygons of intersections and unions have both exterior ring and holes
# in clockwise orientation.
"inter1": Result,
"inter2": Result,
"union1": Result,
"union2": Result,
...
},
# If any errors occur while obtaining data for targets, they will be listed
# here. Otherwise it is an empty hash.
"target-errors": {
"id1": error `no-data` | error `out-of-reach` | error `timed-out` | error `bad-params`,
"id2": error `no-data` | error `out-of-reach` | error `timed-out` | error `bad-params`,
...
}
}/v3/time_map/v3/time_map (CORS support)/v2/routesGiven origin point, max travel time and start time return routing information using transportation mode for set of destination points.
{
# Limits max. travel time from your origin to each of the given points. If
# travel time to a certain point exceeds this value such point will be
# omitted in the result set.
#
# In seconds.
"travel_time": Int,
"origin": CoordsV2,
# Points that you need travel time calculated for.
"points": {"id1": CoordsV2, "id2": CoordsV2, ...},
"mode": TransportationMode,
# When do we start our search?
"start_time": DateTime
}
{
"id1" -> [ BasicDescriptionPart | StartEndDescriptionPart | RoadDescriptionPart | PublicTransportDescriptionPart ,
BasicDescriptionPart | StartEndDescriptionPart | RoadDescriptionPart | PublicTransportDescriptionPart , ...],
"id2" -> [ BasicDescriptionPart | StartEndDescriptionPart | RoadDescriptionPart | PublicTransportDescriptionPart ,
BasicDescriptionPart | StartEndDescriptionPart | RoadDescriptionPart | PublicTransportDescriptionPart , ...],
...
}
An empty array [] will be returned for a point that has the same coordinates as the origin point.
/v2/routes/v2/routes (CORS support)/v3/routesGiven origin point and start time or destination point and arrival time, max travel time returns routing information using transportation mode for set of destination points.
{
"target": {
"coords": CoordsV2,
# Specifies when do we want to either:
# - Start our journey from this point at given time.
# - Arrive at this point at given time.
"start_time" | "arrival_time": DateTime,
# Maximum number of seconds between target and edge of the zone.
"travel_time": Int,
"mode": TransportationMode,
# Include fares in the response, default is false.
"include_fares": null|Boolean
}
# Points that you need route for.
"points": {"id1": CoordsV2, "id2": CoordsV2, ...},
}
{
"id1" -> RouteDescription | RoutingError,
"id2" -> RouteDescription | RoutingError,
...
}
/v3/routes/v3/routes (CORS support)/postcodes/geocodeGeocodes UK postcodes into coordinates.
{
# comma separated postcode list which we want geocoded
"q": "postcode1,postcode2,postcode3"
}
[OptCoords, OptCoords, ...]
Each postcode gets its own entry in the array.
null if postcode could not be geocoded./postcodes/geocode/postcodes/geocode (CORS support)/v2/postcodes/geocodeSame as v1, except that input is changed into:
{
"postcodes": ["postcode1", "postcode2", ...]
}
/v2/postcodes/geocode/v2/postcodes/geocode (CORS support)/postcodes/post_code_timesAll postcodes reachable from origin point in given travel time.
Each postcode is mapped to time in seconds needed to travel from origin to that postcode.
{postcode (String): time (Int), ...}
/postcodes/post_code_times/postcodes/post_code_times (CORS support)/postcodes/post_code_times/inverseAll postcodes from which we can reach destination point in given travel time.
Each postcode is mapped to time in seconds needed to travel from source to that wanted destination.
{postcode (String): time (Int), ...}
/postcodes/post_code_times/inverse/postcodes/post_code_times/inverse (CORS support)/postcodes/post_code_sector_timesAll reachable sectors in given travel time. Each sector is mapped to averaged time in seconds needed to travel from origin to all known postcodes in that sector.
{sector (String): time (Int), ...}
/postcodes/post_code_sector_times/postcodes/post_code_sector_times (CORS support)/postcodes/post_code_sector_times/inverseAll sectors from which we can reach destination point in given travel time.
Each sector is mapped to averaged time in seconds needed to travel from all known postcodes in that sector to your wanted destination.
{sector (String): time (Int), ...}
/postcodes/post_code_sector_times/inverse/postcodes/post_code_sector_times/inverse (CORS support)/postcodes/post_code_district_timesAll reachable districts in given travel time. Each district is mapped to averaged time in seconds needed to travel from origin to all known postcodes in that district.
{district (String): time (Int), ...}
/postcodes/post_code_district_times/postcodes/post_code_district_times (CORS support)/postcodes/post_code_district_times/inverseAll districts from which we can reach destination point in given travel time.
Each district is mapped to averaged time in seconds needed to travel from all known postcodes in that district to your wanted destination.
{district (String): time (Int), ...}
/postcodes/post_code_district_times/inverse/postcodes/post_code_district_times/inverse (CORS support)/postcodes/post_code_sector_percentAll reachable sectors in given travel time. Each sector is mapped to percentage of postcodes reachable from origin within given travel time in that sector.
{sector (String): coverage (Percentage), ...}
/postcodes/post_code_sector_percent/postcodes/post_code_sector_percent (CORS support)/postcodes/post_code_sector_percent/inverseAll sectors from which we can reach destination point in given travel time.
Each sector is mapped to percentage of postcodes which can reach destination within given travel time in that sector.
{sector (String): coverage (Percentage), ...}
/postcodes/post_code_sector_percent/inverse/postcodes/post_code_sector_percent/inverse (CORS support)/postcodes/post_code_district_percentAll reachable districts in given travel time. Each district is mapped to percentage of postcodes reachable from origin within given travel time in that district.
{district (String): coverage (Percentage), ...}
/postcodes/post_code_district_percent/postcodes/post_code_district_percent (CORS support)/postcodes/post_code_district_percent/inverseAll districts from which we can reach destination point in given travel time.
Each district is mapped to percentage of postcodes which can reach destination within given travel time in that district.
{district (String): coverage (Percentage), ...}
/postcodes/post_code_district_percent/inverse/postcodes/post_code_district_percent/inverse (CORS support)/postcodes/post_code_time_mapA shape of all postcode sectors that have at least one postcode reachable from origin point in given time.
{
# Shapes with clockwise orientation.
shape: [Cluster, Cluster, ...]
}
/postcodes/post_code_time_map/postcodes/post_code_time_map (CORS support)/postcodes/post_code_time_map/inverseA shape of all postcode sectors that have at least one postcode from which you can reach destination point in given time.
{
# Shapes with clockwise orientation.
shape: [Cluster, Cluster, ...]
}
/postcodes/post_code_time_map/inverse/postcodes/post_code_time_map/inverse (CORS support)/map_infoInfo about maps currently available on API.
This request doesn't take input parameters.
{
"map-name1" (String) : {
"from": DateTime,
"to": DateTime
}
"map-name2" (String): { ...
}
/map_info/map_info (CORS support)/bounding_boxGiven X origins find bounding boxes of shapes of zones reachable within each corresponding travel time.
{
"targets": {
"id1": {
"coords": CoordsV2,
# Specifies when do we want to either:
# - Start our journey from this point at given time.
# - Arrive at this point at given time.
"start_time" | "arrival_time": DateTime,
# Maximum number of seconds between target and edge of the zone.
"travel_time": Int,
"mode": TransportationMode
},
...
},
}
A Result is a array of Polygons
Polygon: {
"envelope": Box
"boxes": [Box, Box, ...]
}
The Box type:
Box: {
"min_lon": Float,
"max_lon": Float,
"min_lat": Float,
"max_lat": Float
}
{
# Bounding bo responses. If an error occurs while obtaining the response, it will be missing from this hash.
"results": {
"id1": Result,
"id2": Result,
...
},
# If any errors occur while obtaining data for targets, they will be listed
# here. Otherwise it is an empty hash.
"target-errors": {
"id1": error `no-data` | error `out-of-reach` | error `timed-out` | error `bad-params`
"id2": error `no-data` | error `out-of-reach` | error `timed-out` | error `bad-params`
...
}
}
/bounding_box/bounding_box (CORS support)We support (and recommend to use) lz4 compression. Compression results in significantly reduced request size. lz4 is available for most of the popular programming languages. Get it at: https://code.google.com/p/lz4
To use compression:
For those seeking maximum performance, we provide Protocol Buffers (Protobuf) endpoint. Compared to Json it gives reduced parsing/composing time and significantly reduced request size.
Read more: https://bitbucket.org/igeolise/protobuf-traveltime-api