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 this week

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

Primary Tools

Isochrone

  • 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

Endpoints:

  • Isochrone Core (/time-map/fast) - the highest performance option

  • Isochrone Custom (/time-map) - more configurable parameters

Use cases:

  1. Real estate investment analysis

  2. Retail store catchment areas

  3. Public services accessibility

Travel Time Matrix

  • 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

Endpoints:

  • Travel Time Matrix Core (/time-filter/fast) - the highest performance option

  • Travel Time Matrix Custom (/time-filter) - more configurable parameters

Use cases:

  1. Commute time search on property portals and job boards

  2. Route optimisation

  3. Shift matching and temporary staffing solutions
    ​


H3 / Geohash

  • Generate catchment areas in reachable H3 cells or Geohashes, at different resolution levels

  • Return the Average / Max / Min travel time to each reachable cell

  • It looks like an isochrone but includes all of the travel times within the catchment area in one go

Endpoints:

  • H3 Core (/h3/fast) - the highest performance H3 endpoint

  • H3 Custom (/h3) - more configurable H3 parameters

  • Geohash Core (/geohash/fast) - the highest performance geohash option

  • Geohash Custom (/geohash) - more configurable geohash parameters

Use cases:

  1. Territory mapping

  2. Generating heat maps

  3. Building search indexes


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

Endpoint: /routes

Use cases:

  1. Transport network analysis

  2. Employee commute visualisation

  3. Infrastructure planning
    ​

Multiple-Routes_Singapore

Ancillary Tools

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

Endpoint: /distance-map

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

  • 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

Use cases:

  1. Consumer search

  2. Reverse IP address lookup

  3. Points of interest

Reverse Geocoding

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

  • Return multiple matches or simply the best match for each

Use cases:

  1. Address identifiation

  2. Data aggregation

  3. Location tagging

Map Tiles

  • Add base maps to a project using raster tiles

map_tile

Travel Time Matrix Postcodes / Sectors / Districts (UK only)

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

  • Compatible with driving and public transport modes

Endpoints:

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?