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 2 months ago

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?