Skip to content

Travel Time (Isochrone & Surface) API

Contact Info

  • Entur, Norway

Changelog

  • 2022-05-09 Initial implementation

Documentation

The API produces a snapshot of travel time form a single place to places around it. The results can be fetched either as a set of isochrones or a raster map. Please note that as a sandbox feature this functionality is UNSUPPORTED and neither maintained nor well-understood by most current OTP developers, and may not be accurate or reliable. Travel time analytics work that began within OTP has moved years ago to other projects, where it actively continues. See the Analysis page for further details.

Configuration

The feature must be enabled in otp-config.json as follows:

// otp-config.json
{
    "otpFeatures" : {
        "SandboxAPITravelTime" : true
    }
}

API parameters

  • location Origin of the search, can be either latitude,longitude or a stop id
  • time Departure time as a ISO-8601 time and date (example 2023-04-24T15:40:12+02:00). The default value is the current time.
  • cutoff The maximum travel duration as a ISO-8601 duration. The PT can be dropped to simplify the value. This parameter can be given multiple times to include multiple isochrones in a single request. The default value is one hour.
  • modes A list of travel modes. WALK is not implemented, use WALK, TRANSIT instead.
  • arriveBy Set to false when searching from the location and true when searching to the location

Isochrone API

/otp/traveltime/isochrone

Results is the travel time boundaries at the cutoff travel time.

Travel time surface API

/otp/traveltime/surface

The travel time as a GeoTIFF raster file. The file has a single 32-bit int band, which contains the travel time in seconds.

Example Request

http://localhost:8080/otp/traveltime/isochrone?batch=true&location=52.499959,13.388803&time=2023-04-12T10:19:03%2B02:00&modes=WALK,TRANSIT&arriveBy=false&cutoff=30M17S