Skip to main content

Overview of the API endpoints

An introduction to what each of the TravelTime API endpoints does, and some example use cases for each.

Updated over a year ago

The endpoints of the TravelTime API are split into 5 core tools, and then a range of ancillary tools.


Core Tools

Isochrones (/time-map)

  • Create 'isochrones' showing the reachable catchment area in a given travel time (also known as trade areas)

  • Return individual isochrones, or unions of multiple isochrones, or intersections of multiple isochrones

  • Compatible with all methods of transport, including public transport

Use cases:

  1. Real estate investment analysis

  2. Retail store catchment areas

  3. Public services accessibility

What the API endpoints do.png


Isochrones Fast (/time-map/fast)

  • A high performance version of the standard Isochrones endpoint

  • Response times up to 10x faster than the regular Time Map endpoint

  • Has fewer configurable parameters (e.g a specific departure/arrival time can't be chosen, but instead a midweek morning arrival time is alway used)

Use cases:

  1. Consumer-facing sites where isochrones need to be displayed with no impact on page loading times

  2. Creation of large volumes of isochrones for analytics purposes - e.g around every postcode or LSOA

Time Map (Fast) is currently available in 32 countries (a full list can be found here)

Travel Time Matrix (/time-filter)

  • Create origin-destination matrices of the journey times, distances, or public transport fares between 1000's of points in one go

  • Calculate a matrix of up to 10 x 2,000 in a single API call

  • Set a maximum travel time cut-off to automatically label points as reachable or unreachable

  • Compatible with all methods of transport, including public transport

Use cases:

  1. Office relocation commute analysis

  2. Customer market segmentation

  3. SLA management
    ​

Large-Matrix


Travel Time Matrix Fast (/time-filter/fast)

  • A stripped down, incredibly fast version of the standard Time Filter endpoint

  • Calculate a matrix of up to 10 x 100,000 in a single API call

  • Response times up to 10x faster than the regular Time Filter endpoint

  • Has fewer configurable parameters (e.g a specific departure/arrival time can't be chosen, but instead a midweek morning arrival time is alway used)

  • Available through a JSON endpoint or a Protocol Buffers endpoint

Use cases:

  1. Consumer-facing sites where large volumes of data need to be searched / sorted / filtered by travel time with optimum performance - for example, here

  2. Creation of large origin-destination matrices such as between all postcodes or LSOAs

Time Filter (Fast) is currently available in 32 countries (a full list can be found here)


Routes (/routes)

  • Create A to B routes including turn-by-turn directions

  • Visualise the response on a map, or as a set of door-to-door instructions

  • Compatible with all methods of transport, including public transport

Use cases:

  1. Transport network analysis

  2. Employee commute visualisation

  3. Infrastructure planning
    ​

Multiple-Routes_Singapore

Ancillary Tools

Distance Map (/distance-map)

  • Create 'isodistances' showing the reachable catchment area for a set distance travelled along the transport network

  • Chose a mode of transport (driving/walking/cycling) to determine which roads and paths can/can't be travelled along as part of the maximum journey distance

Use cases:

  1. Modelling EV vehicle range areas

  2. Modelling reachable areas based on cost, where the driving cost is linked to the distance driven

Geocoding (/geocoding/search)

  • Convert addresses (e.g postcodes) into lat-long coordinates

  • These coordinates can then be used to display the addresses on a map, or as inputs for one of the other TravelTime API endpoints

  • Limit results to a single country if required

Reverse Geocoding (/geocoding/reverse)

  • Convert lat-long coordinates into readable addresses (i.e street addresses)

  • Return multiple matches or simply the best match for each

Map Tiles

  • Add base maps to a project using raster tiles

map_tile

Travel Time Matrix Postcodes / Sectors / Districts

  • Find reachable postcodes, postcode sectors, and postcode districts based on travel time from an origin or destination

  • Compatible with driving and public transport modes

  • Use cases:

    • Targeted marketing mailshots

    • Logistics planning

    • Public services provisioning

Map Info

  • Receive information about currently supported countries

  • Includes the dates for the available window of public transport data for each country

Supported Locations

  • Based on lat-long coordinates, find out whether a location is currently supported

  • For locations that are supported, the id of the map which contains that location is also returned

Did this answer your question?