Three key features of the TravelTime API:

time filter api sort by time

Create a travel time shape

sort points of interest by time

Sort points of interest by travel time

a to b route

Get the A>B route

“We did the backend integration within 2 days.
We were seriously impressed by the ease, the speed
and the amazing support the iGeolise team gave us.”

Dev Team

OPENTABLE_2

TT-ICON-APISIGN UP
FOR AN API KEY

TimeFilter

TimeFilter – Explanation

TimeFilter enables the ranking and sorting of a list of lat / longs by time.

It can also return fare cost (for public transport) , and true distance  (for walking and driving). True distance is calculated by measuring the distance travelled from A to B using the route that will be taken, rather than just as the crow flies.

It’s able to do this for 1000s of points instantly. For example: ‘Show me all bars within 30 minutes of my origin using public transport’

TimeFilter can calculate times from one point of origin to many end locations as well as many points of origin to many locations.

The request is done by sending JSON and receiving JSON there is no browser support needed.

Field Explanations:

  • points
    • Inside here list of all of the points of origin with a unique ID and lat / long. It can be anything that has a lat / long
  • sources
    • This is the starting point and always requires a “start_time”. E.g. where the user is right now.
    • You can have multiple sources per search.
    • A “start_time” is always required.
  • destinations
    • Destinations are the reverse of a source. In a property search for example, a buyer is looking for a home within 30 minutes commute from their office. The destination would be the office to arrive at 9am and the “points” would be the houses
    • You can have multiple destinations per search.
    • An “arrival_time” is always required.
  • remove_wait_time
    • Setting this to false will remove the wait time for the first public transport vehicle

Each Request Requires:

  • properties
    • Time – returns the time in seconds
    • Distance – returns distance in metres
    • Fares – returns the cost of the trip (please see fare data example)
  • coords
    • lat / long
  • travel_time
    • The amount of time in seconds. Anything outside of this TravelTime will not be returned.

URL: http://api.traveltimeapp.com/v3/time_filter

 

 

 

Back To Top

TimeFilter – Request – With Fares

URL: http://api.traveltimeapp.com/v3/time_filter

Below is a request that asks for the time and fares for three points. You can add 1000s of points per request

{
  "app_id": "XXX",
  "app_key": "XXX",
  "points": {
    "one": [
      51.23622,
      -0.570409
    ],
    "two": [
      51.488616,
      -0.120714
    ],
    "three": [
      51.316774,
      -0.560035
    ]
  },
  "sources": {
  },
  "destinations": {
    "public_transport": {
      "coords": [
        51.505431,
        -0.023533
      ],
      "arrival_time": "2016-02-23T21:31:53+01:00",
      "travel_time": 7200,
      "mode": "public_transport",
      "properties": [
        "time",
        "fares"
      ]
    }
  },
  "remove_wait_time": false
}

 

Back To Top

TimeFilter – Response – With Fares

URL: http://api.traveltimeapp.com/v3/time_filter

This is the response that is given with fares for the three points above:

{
  "sources": {
  },
  "destinations": {
    "public_transport": {
      "points": {
        "one": {
          "time": 5035,
          "fares": [
            {
              "modes": [
                "rail_national",
                "rail_underground"
              ],
              "tickets": [
                {
                  "type": "week",
                  "price": 106.1,
                  "currency": "GBP"
                },
                {
                  "type": "month",
                  "price": 407.424,
                  "currency": "GBP"
                },
                {
                  "type": "year",
                  "price": 4244.0,
                  "currency": "GBP"
                }
              ]
            }
          ],
          "fares_total": [
            {
              "type": "week",
              "price": 106.1,
              "currency": "GBP"
            },
            {
              "type": "month",
              "price": 407.424,
              "currency": "GBP"
            },
            {
              "type": "year",
              "price": 4244.0,
              "currency": "GBP"
            }
          ]
        },
        "two": {
          "time": 2352,
          "fares": [
            {
              "modes": [
                "rail_underground"
              ],
              "tickets": [
                {
                  "type": "week",
                  "price": 32.1,
                  "currency": "GBP"
                },
                {
                  "type": "month",
                  "price": 123.3,
                  "currency": "GBP"
                },
                {
                  "type": "year",
                  "price": 1284.0,
                  "currency": "GBP"
                }
              ]
            }
          ],
          "fares_total": [
            {
              "type": "week",
              "price": 32.1,
              "currency": "GBP"
            },
            {
              "type": "month",
              "price": 123.3,
              "currency": "GBP"
            },
            {
              "type": "year",
              "price": 1284.0,
              "currency": "GBP"
            }
          ]
        },
        "three": {
          "time": 4073,
          "fares": [
            {
              "modes": [
                "rail_national",
                "rail_underground"
              ],
              "tickets": [
                {
                  "type": "week",
                  "price": 95.7,
                  "currency": "GBP"
                },
                {
                  "type": "month",
                  "price": 367.488,
                  "currency": "GBP"
                },
                {
                  "type": "year",
                  "price": 3828.0,
                  "currency": "GBP"
                }
              ]
            }
          ],
          "fares_total": [
            {
              "type": "week",
              "price": 95.7,
              "currency": "GBP"
            },
            {
              "type": "month",
              "price": 367.488,
              "currency": "GBP"
            },
            {
              "type": "year",
              "price": 3828.0,
              "currency": "GBP"
            }
          ]
        }
      },
      "accuracy": "exact"
    }
  }
}

Note that fares are broken down by rail_national and rail_underground.  fares_total will show you total fare by:

  • weekly cost
  • monthly cost
  • yearly cost

Back To Top

Overview

Countries

We are currently live in:

  • USA
  • Australia
  • UK
  • Switzerland
  • Thailand

You can use this request to understand if we have data in your specific area:

{"coords": [51.277915434, -0.028122314]}

URL: http://api.traveltimeapp.com/can_search

Back To Top

What this API Does

This RestFUL JSON API allows maps to be searchable by time. It relies on no browser support and can be integrated server side or inside any mapping API.

There are 3 main features:

  1. TimeMap – Create polygons by time
    1. Use this for display search or database search
    2. Search up to 10 origins
      1. Map origin intersections – this is the area of overlap for time map shapes
      2. Map unions of these origins – the total area of all time map shapes
    3. Forward search – e.g. where’s reachable in 30 minutes if I depart at 5pm?
    4. Backward search – e.g. where’s reachable if I need to arrive by 5pm and have 30 minutes to travel?
  2. TimeFilter – Rank and sort 1000s of lat / long destinations instantly
    1. Use to filter location-based search results
    2. Search up to 10 location origins at once
      1. e.g. house search – 10 people trying to find a place to live but work in different locations, where’s a commutable location for all?
    3. Forward and Backward search
  3. Routes – deliver routing information
    1. Simple directions available on any device
    2. A to B
    3. A to Many
    4. Forward and Backward search

This API is cross platform. It works on any mobile device. 

Notes

  • iGeolise do not hold any front end JS code. We can help but do not have libraries.
  • The majority of development time is spent on the front-end coding and design.
  • You can drop time filter and use a big distance search and send this subset to TimeFilter – TimeFilter will only return points inside the set TravelTime.
  • Our API is usually integrated within a client’s system. We support CORS but this would mean showing the API key in the front end code.
  • It works on any device or view because we send the results in formatted JSON.
  • No extra hosting required by you.
  • We can supply hosting details / an SLA on request.
  • The API is very fast, please ask for any help in performance testing.

 

Back To Top

Transportation Modes

Supported Modes

We support all modes of transport:

  • Walking
  • Cycling
  • Driving
  • Public Transport
    • All
    • Train
    • Bus
  • Driving & Train
    • This combines driving and public transport i.e. drive to station, park and continue by train

Back To Top

Modes as String (default)

We accept modes in 2 ways – as a string or as a hash.

For simple requests use a string such as:

mode: "public_transport"

Supported Modes:

  • “public_transport”
  • “driving”
  • “walking”
  • “cycling”
  • “driving+train”
  • “waking_train”
  • “walking_bus”

Back To Top

Modes as Hash (Advanced)

For more advanced searches,  send the mode as a hash.

For public transport modes:

{
  time-to-station-limit: null|Int,
  "pt-change-penalty": null|Int
}

For driving + train modes:

{
  "change-delay": null|Int,
  "driving-time-limit": null|Int,
  "walking-from-station-limit": null|Int,
  "pt-change-penalty": null|Int
}
  • time-to-station-limit
    • This is the maximum amount of time set to walk to the first public transport terminus.
  • pt-change-penality
    • This is the amount of time needed to change vehicle.
  • change-delay
    • This is the amount of time allocated to the change delay between driving and walking (given in seconds).
  • walking-from-station-limit
    • This is the amount of time needed to board a public transportation vehicle (in seconds).
  • drive-time-limit
    • This is the maximum amount of time spent driving.

 

Back To Top

TimeMap

TimeMap – Request – Simple

URL: http://api.traveltimeapp.com/v3/time_map

The TimeMap request is in 2 parts:

  1. Specify what you want
  2. Specify how you want it

An explanation of the points:

  • “format”:
    • This is the format you’d like the shape in:
      • “array”:
        • 3D array of lat / longs
      • “hash”:
        • Hash of coords
      • “wkt”:
        • Polygon or a cluster of polygons represented as Well Known Text format
        • It will create a POLYGON if only one cluster is present, or a MULTIPOLYGON if multiple clusters are present.
        • Points in polygons are oriented anti-clockwise and represented by “long lat” pairs.
      • “wkt-no-holes”:
        • Same as wkt – but with no holes
      • “bounding-boxes-no-holes”:
        • A shape representation using a collection of bounding boxes.
  • “targets”:
    • These are the locations you’re searching from. It’s possible to have up to 10 at one time. For example:
      These are defined by start_time or arrival_time:

      • “start_time” – leaving from that lat / long (find a bar within 30 mins)
      • “arrival_time” – arrive at that lat / long (get to office by 9am)
  • “shapes”:
    • Define what type of shape if preferred. Choose from:
    • “smooth”
      • This smoothes the shape
    • “simplify”
      • This simplifies the shape
      • The system will return the minimal amount of points while still maintaining the shape
    • “max_points”
      • Define the number of points the polygon should have
  • “intersections”:
    • Define which targets should intersect
  • “unions”:
    • Define which targets should create a union

 

A 1 hour search by public transport:

{
   "app_id":"XXX",
   "app_key":"XXX",
   "format":"array",
   "smooth":false,
   "targets":{
      "target1":{
         "start_time":"2015-09-20T12:00:00.000+0000",
         "coords":[51.50, -0.11],
         "travel_time":3600,
         "mode": "public_transport"
      },
   },
   "shapes":{
      "target1": {
        "max_points": 0
      }
   },
   "intersections":{},
   "unions":{}
}

 

Back To Top

TimeMap – Request – Unions

URL: http://api.traveltimeapp.com/v3/time_map

Below is  a sample request in JSON, asking for the union between 2 shapes that are both 1 hour by public transport.

Please note you can ask for both intersections and unions in the same request.

{
   "app_id":"XXX",
   "app_key":"XXX",
   "format":"array",
   "smooth":false,
   "targets":{
      "target1":{
         "start_time":"2015-09-20T12:00:00.000+0000",
         "coords":[51.50, -0.11],
         "travel_time":3600,
         "mode": "public_transport"
      },
      "target2":{
         "start_time":"2015-09-20T12:00:00.000+0000",
         "coords":[51.40, -0.08],
         "travel_time":3600,
         "mode": "public_transport"
      }
   },
   "shapes":{},
   "intersections":{},
   "unions":{ 
      "union1": {
        "max_points": 0, 
        "targets": ["target1", "target2"]
      }
   }
}

 

Back To Top

TimeMap – Request – Intersections

URL: http://api.traveltimeapp.com/v3/time_map

Below is a sample request in JSON that asks for the intersection between 2 shapes, both 1 hour by public transport.

Please note you can ask for both intersections and unions in the same request.

{
   "app_id":"XXX",
   "app_key":"XXX",
   "format":"array",
   "smooth":false,
   "targets":{
      "target1":{
         "start_time":"2015-09-20T12:00:00.000+0000",
         "coords":[51.50, -0.11],
         "travel_time":3600,
         "mode": "public_transport"
      },
      "target2":{
         "start_time":"2015-09-20T12:00:00.000+0000",
         "coords":[51.40, -0.08],
         "travel_time":3600,
         "mode": "public_transport"
      }
   },
   "shapes":{},
   "intersections":{
      "intersection1": {
        "max_points": 0,
        "targets": ["target1", "target2"]
      }
   },
   "unions":{}
}

 

Back To Top

TimeMap – Explanation

TimeMap returns a polygon of a reachable area by time. This is also known as an isochrone. It will produce a polygon for all modes of transport, driving, walking, cycling, public transport (plus a breakdown of public transport modes) and driving and train.

TimeMap can be used for 2 things:

  1. Visual Display 
  2. Database search (i.e. find all bars / properties within the reachable area)

There are many options to get a shape returned. Here is an example is included polygon that shows all points within 45mins, using Public Transport at 2:50pm:

public_transport_isochrone

 

 

 

Back To Top

TimeMap – Intersection – Explanation

TimeMap is processed completely from the TravelTime Platform API. It does not need any front end mapping API to collate it, only to draw it. The same shape can be used inside a database.

The intersections are processed inside our network and returned in JSON.

An intersection will return the intersecting areas of more than one shape, like the centre of a Venn diagram.

2 Isochrones being returned. 45 mins public transport Woolwich London 45 mins public transport & Clapham Junction London

Two isochrones being returned. 45 mins, using public transport from Woolwich, London as well as 45 mins, using public transport from Clapham Junction, London

 

Showing the Intersection with other shapes

The intersection with other shapes

Showing only the intersecting areas.

The intersection alone. 

Upto 10 Shapes as at a time

Intersect up to 10 shapes as at a time

Intersection of 10 shapes

The intersection of 10 shapes

Back To Top

TimeMap – Unions – Explanation

TimeMap is processed completely from the TravelTime Platform API. It does not need any front end mapping API to collate it, only draw it. The same shape can be used inside a database.

A union is the combination of more than one shape.

2-isochrones

Two isochrones being returned. 45 mins using public transport from Woolwich, London and 45 mins using public transport from Clapham Junction, London

 

One shape of the union of the shapes above returned as one shape

The union of both isochrones returned as one shape

Back To Top

Routes

Routes – Response

Below is the routes response

{
  "destination": {
    "departure": "2016-02-26T15:02:49.000Z",
    "arrival": "2016-02-26T15:40:05.000Z",
    "time": 2236,
    "distance": 988,
    "num_trips": 3,
    "parts": [
      {
        "mode": "walk",
        "coords": [
          [
            51.53774259999999,
            -0.09113630000001649
          ]
        ],
        "directions": "Start your journey 8 meters south",
        "distance": 8,
        "time": 6,
        "direction": "south",
        "id": 0
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.5376622,
            -0.0911353
          ],
          [
            51.5375599,
            -0.0913747
          ]
        ],
        "directions": "Walk 20 meters along Canonbury Yard",
        "distance": 20,
        "time": 14,
        "road": "Canonbury Yard",
        "id": 1
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.5375599,
            -0.0913747
          ],
          [
            51.5376179,
            -0.0914398
          ],
          [
            51.5377386,
            -0.0915793
          ],
          [
            51.5379745,
            -0.0918353
          ],
          [
            51.5385675,
            -0.0924833
          ],
          [
            51.5387037,
            -0.0926596
          ],
          [
            51.5388163,
            -0.092835
          ],
          [
            51.5391748,
            -0.0934282
          ],
          [
            51.5397173,
            -0.0943345
          ],
          [
            51.5397423,
            -0.0943762
          ],
          [
            51.5397969,
            -0.0944682
          ],
          [
            51.5398836,
            -0.0946089
          ],
          [
            51.5399126,
            -0.0946561
          ],
          [
            51.5404716,
            -0.095564
          ],
          [
            51.5405364,
            -0.0956795
          ],
          [
            51.5405657,
            -0.0957316
          ],
          [
            51.5406232,
            -0.0958341
          ]
        ],
        "directions": "Turn right onto New North Road (A1200) and walk 455 meters",
        "distance": 455,
        "time": 419,
        "road": "New North Road (A1200)",
        "turn": "right",
        "id": 2
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.5406232,
            -0.0958341
          ],
          [
            51.5407023,
            -0.0959852
          ],
          [
            51.540726,
            -0.0960306
          ]
        ],
        "directions": "Continue onto Canonbury Road (A1200) for 17 meters",
        "distance": 17,
        "time": 33,
        "road": "Canonbury Road (A1200)",
        "turn": "straight",
        "id": 3
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.540726,
            -0.0960306
          ],
          [
            51.5407813586,
            -0.0961955384
          ],
          [
            51.5407106347,
            -0.0962705965
          ]
        ],
        "directions": "Enter 'Essex Road Rail Station' through 'Entrance 1'",
        "distance": 21,
        "time": 139,
        "id": 4
      },
      {
        "mode": "rail_national",
        "coords": [
          [
            51.5407106347,
            -0.0962705965
          ],
          [
            51.5461826185,
            -0.1037584334
          ]
        ],
        "directions": "Take a train (Moorgate Rail Station - Stevenage Rail Station (of Govia Thameslink Railway (Great Northern)) line) from 'Essex Road Rail Station' (leaves at 15:13) to 'Highbury & Islington Rail Station' (arrives at 15:15) (1 stops)",
        "distance": 0,
        "time": 120,
        "line": "Moorgate Rail Station - Stevenage Rail Station (of Govia Thameslink Railway (Great Northern))",
        "departure_station": "Essex Road Rail Station",
        "arrival_station": "Highbury & Islington Rail Station",
        "depart_time": "15:13",
        "arrive_time": "15:15",
        "num_stops": 1,
        "id": 5
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.5461826185,
            -0.1037584334
          ],
          [
            51.5460927513,
            -0.1037621703
          ]
        ],
        "directions": "Change stop",
        "distance": 9,
        "time": 300,
        "id": 6
      },
      {
        "mode": "rail_overground",
        "coords": [
          [
            51.5460927513,
            -0.1037621703
          ],
          [
            51.5430462019,
            -0.1167243492
          ],
          [
            51.5417962114,
            -0.1386966283
          ]
        ],
        "directions": "Take a train (Stratford (London) Rail Station - Clapham Junction Rail Station (of London Overground) line) from 'Highbury & Islington Rail Station' (leaves at 15:20) to 'Camden Road Rail Station' (arrives at 15:25) (2 stops)",
        "distance": 0,
        "time": 300,
        "line": "Stratford (London) Rail Station - Clapham Junction Rail Station (of London Overground)",
        "departure_station": "Highbury & Islington Rail Station",
        "arrival_station": "Camden Road Rail Station",
        "depart_time": "15:20",
        "arrive_time": "15:25",
        "num_stops": 2,
        "id": 7
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.5417962114,
            -0.1386966283
          ],
          [
            51.5416957546,
            -0.1385997778
          ],
          [
            51.54163,
            -0.1385283
          ]
        ],
        "directions": "Exit 'Camden Road Rail Station' through 'Entrance 1'",
        "distance": 21,
        "time": 133,
        "id": 8
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.54163,
            -0.1385283
          ],
          [
            51.5415825,
            -0.1385712
          ],
          [
            51.5411586,
            -0.1389811
          ]
        ],
        "directions": "Walk 60 meters along Camden Road (A503)",
        "distance": 60,
        "time": 53,
        "road": "Camden Road (A503)",
        "id": 9
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.5411586,
            -0.1389811
          ],
          [
            51.5412518977,
            -0.1389640032
          ]
        ],
        "directions": "Go to 'Camden Road Station, Stop G'",
        "distance": 10,
        "time": 113,
        "id": 10
      },
      {
        "mode": "bus",
        "coords": [
          [
            51.5412518977,
            -0.1389640032
          ],
          [
            51.5431748312,
            -0.1371693306
          ],
          [
            51.5442748364,
            -0.135653329
          ],
          [
            51.5455324578,
            -0.1338711965
          ],
          [
            51.5467471822,
            -0.1322205289
          ],
          [
            51.5494579284,
            -0.1285179374
          ]
        ],
        "directions": "Take a bus (29) from 'Camden Road Station' (leaves at 15:29) to 'Brecknock Road' (arrives at 15:35) (5 stops)",
        "distance": 0,
        "time": 318,
        "line": "29",
        "departure_station": "Camden Road Station",
        "arrival_station": "Brecknock Road",
        "depart_time": "15:29",
        "arrive_time": "15:35",
        "num_stops": 5,
        "id": 11
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.5494579284,
            -0.1285179374
          ],
          [
            51.5497161,
            -0.1288021
          ]
        ],
        "directions": "",
        "distance": 34,
        "time": 50,
        "id": 12
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.5497161,
            -0.1288021
          ],
          [
            51.5497655,
            -0.1289121
          ],
          [
            51.5499781,
            -0.1286776
          ]
        ],
        "directions": "Walk 38 meters",
        "distance": 38,
        "time": 27,
        "id": 13
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.5499781,
            -0.1286776
          ],
          [
            51.5501192,
            -0.1289442
          ],
          [
            51.5503194,
            -0.1292124
          ],
          [
            51.5505995,
            -0.1294317
          ],
          [
            51.5510693,
            -0.1294585
          ],
          [
            51.5512016,
            -0.12937
          ]
        ],
        "directions": "Turn left onto Hilldrop Crescent and walk 155 meters",
        "distance": 155,
        "time": 111,
        "road": "Hilldrop Crescent",
        "turn": "left",
        "id": 14
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.5512016,
            -0.12937
          ],
          [
            51.5511262,
            -0.1284535
          ],
          [
            51.5514211,
            -0.128058
          ]
        ],
        "directions": "Turn right onto Moelwyn Hughes Court and walk 106 meters",
        "distance": 106,
        "time": 76,
        "road": "Moelwyn Hughes Court",
        "turn": "right",
        "id": 15
      },
      {
        "mode": "walk",
        "coords": [
          [
            51.551192052046325,
            -0.1284027099609375
          ]
        ],
        "directions": "Your destination is 34 meters southwest",
        "distance": 34,
        "time": 24,
        "direction": "southwest",
        "id": 16
      }
    ],
    "fares": [],
    "fares_total": []
  }
}

 

Back To Top

Routes – Request

URL: http://api.traveltimeapp.com/v3/routes

To get a route from A to B

{
  "app_id": XXX,
  "app_key: XXX,
  "target": {
    "coords": [
      51.53774259999999,
      -0.09113630000001649
    ],
    "travel_time": 7200,
    "mode": {
      "mode": "public_transport",
      "time-to-station-limit": 1800,
      "pt-change-penalty": 0,
      "routing-mode": "single-route"
    },
    "start_time": "2016-02-26T15:00:09.377Z",
    "include_fares": false
  },
  "points": {
    "destination": [
      51.551192052046325,
      -0.1284027099609375
    ]
  },
  "format": "json"
}

 

Back To Top

Routes – Explanation

Routes allows you to draw or read a human readable route from A to B or A to many

It operates much the same as TimeFilter in that it has a target and a list of given points. However it returns the actual route not just time, fares and distance.

Single Route

singleMultiple Routes from A to Many

multi-routes

Example Readable Output

list

Back To Top

Postcodes

Postcodes – Explanation

We offer postcode services in the UK only.

We offer:

  • Geocode
    • Postcode to Lat/Long
  • PostCodeTimes
    • All postcode units within a given travel time (e.g. find all postcodes within 30 minutes drive)
  • PostCodeSectorTimes
    • All postcode sectors with an average time within a given travel time
  • PostCodeDistrictTimes
    • All postcode districts with average time within a given travel time
  • PostCodeSectorPercent
    • The percentage coverage of a sector of reachable sectors within a travel time
  • PostCodeDistrictPercent
    • The percentage coverage of a sector of reachable sectors within a travel time

Back To Top

Postcodes – Geocode – Request

To geocode a list of postcodes:

{
    "postcodes": ["sw11 1pj", "gu2 7yg"]
}

 

 

 

Back To Top

Postcodes – Requests

All postcode requests accept the same JSON request format:

{
  "travel_time": 3600,
  "start_time": "2016-02-23T21:31:53+01:00",
  "origin": 51.23622,-0.570409,
  "mode": "public_transport"
}

To get different results based on your requirements please change the URL.

All requests are returned within the given travel_time

Base URL: http://api.traveltimeapp.com

  1. /postcodes/post_code_times
    1. Returns a list of all postcode units from a “start_time”
  2. /postcodes/post_code_times/inverse
    1. Returns a list of all postcode units from an”arrival_time”
  3. /postcodes/post_code_sector_times
    1. Returns a list of all postcode sectors with an average travel time from a “start_time”
  4. /postcodes/post_code_sector_times/inverse
    1. Returns a list of all postcode sectors with an average travel time from an “arrival_time”
  5. /postcodes/post_code_district_times
    1. Returns a list of all postcode districts with an average travel time from an “start_time”
  6. /postcodes/post_code_district_times/inverse
    1. Returns a list of all postcode districts with an average travel time from an “arrival_time”
  7. /postcodes/post_code_sector_percent
    1. Returns a list of the % coverage of each postcode sector from a “start_time”
  8. /postcodes/post_code_sector_percent/inverse
    1. Returns a list of the % coverage of each postcode sector from an “arrival_time”
  9. /postcodes/post_code_district_percent
    1. Returns a list of the % coverage of each postcode district from a “start_time”
  10. /postcodes/post_code_district_percent/inverse
    1. Returns a list of the % coverage of each postcode district from a “arrival_time”

Back To Top

Common Parameters

Date & Time

Every request requires a date and time in ISO format e.g.

2012-11-26T18:14:52.892+02:00

 

Back To Top

Coords

All of our requests require a lat / long. This is the format:

[51.277915434, -0.028122314]

 

Back To Top

Modes as String (default)

We accept modes in 2 ways – as a string or as a hash.

For simple requests use a string such as:

mode: "public_transport"

Supported Modes:

  • “public_transport”
  • “driving”
  • “walking”
  • “cycling”
  • “driving+train”
  • “waking_train”
  • “walking_bus”

Back To Top

Modes as Hash (Advanced)

For more advanced searches,  send the mode as a hash.

For public transport modes:

{
  time-to-station-limit: null|Int,
  "pt-change-penalty": null|Int
}

For driving + train modes:

{
  "change-delay": null|Int,
  "driving-time-limit": null|Int,
  "walking-from-station-limit": null|Int,
  "pt-change-penalty": null|Int
}
  • time-to-station-limit
    • This is the maximum amount of time set to walk to the first public transport terminus.
  • pt-change-penality
    • This is the amount of time needed to change vehicle.
  • change-delay
    • This is the amount of time allocated to the change delay between driving and walking (given in seconds).
  • walking-from-station-limit
    • This is the amount of time needed to board a public transportation vehicle (in seconds).
  • drive-time-limit
    • This is the maximum amount of time spent driving.

 

Back To Top

Example Implementations

Standard Process / SwimLane

  1. Use TimeMap to find a relevant polygon area – either through an intersection, a shape or a union
  2. Use this polygon to create a geospatial search in the database. Find all lat / longs that fall inside the area.
  3. Save this sub set of lat / longs or records.
  4. Send these lat / longs to TimeFilter to get the times to each point.
  5. Results are shown.

Back To Top

Full Documentation