Cycle routing API

  • Details for:
  • Obtain API key
  • Usage policy
  • Uptime policy

An XML/JSON interface to the routing engine (and other CycleStreets components) is available. It is already being used in a range of mobile apps and websites and we are keen to encourage wide usage.

Apply for an API key for use in your mobile/website application.

Formats (XML/JSON): The examples below all show .xml which will return XML. For JSON output, change this file extension to .json, or, for JSON-P, use .json?callback=method&….

RESTful calls: in almost all cases, arguments are all passed via the query string directly from the URL as a standard GET request. (Only the few calls which include a password must be POSTed.)

API keys: An API key is required for all calls.

http://www.../api/journey.xml?key=registeredapikey&plan=quietest&…

API usage policy: Please read our API usage policy, which attempts to ensure reasonable use. We aim to be flexible where possible; if you have any concerns about provisions please contact us as we are keen not to put off potential users.

Uptime: Please see our Server reliability and uptime policy.

Compression: Support for mod_deflate is enabled on the server, so the response should be being delivered compressed. Ensure your client library is set to send the appropriate Accept-encoding header.

Schema: We hope to publish a formal XML Schema in due course.

Journey planner

Cycle routing

Cycle routing

Our journey planner API gives fastest/quietest/balanced cycle journeys in the UK, knows Sustrans routes, avoids hills, and supports waypoints.

Feedback

Feedback

The Feedback API enables users to send feedback on planned cycle journeys, helping us continually provide better routes.

Nearest point

Nearest point

The nearest point API returns the nearest point to a given longitude/latitude. (Not normally needed for journey planning.)

Leisure (circular) routing

Leisure (circular) routing

Our leisure routing API will suggest circular leisure routes based on a specified distance or time, often via points of interest.

Geocoding

Geocoder

Geocoder

With the geocoder API you can get suggested best-location matches for streets, towns and cities, places, postcodes, and stations.

Points of interest

Points of Interest (POIs)

Points of Interest (POIs)

The Points of Interest (POIs) API provides locations of places of interest, both utility and practical locations.

Collisions data

Collisions data

The collisions data API provides locations and details of every reported road traffic collision in the UK since 2005.

Photomap

Photos

Photos

The photos API provides a data interface to our Photomap, enabling you to retrieve photos of cycling-related infrastructure.

Photomap categories

Photomap categories

The Photomap categories API enables clients to retrieve the list of photomap categories.

Photo

Photo

The Photo API lets you retrieve an individual photo in the Photomap.

Add photo

Add photo

With the Add photo API you can add a photo to the Photomap.

User accounts

User validate

User validate

The User validate API validates CycleStreets user account credentials.

User create

User create

The User create API enables the creation of a new CycleStreets user account.

System status

Status

Status

The Status API provides an overview of details about the journey planner API, such as the maximum journey length and countries covered.

We welcome your feedback, especially to report bugs or give us route feedback.

My comments relate to: *






Your comments: *
URL of page: * http://www.cyclestreets.net/api/
How did you find out about CycleStreets?:
Your name:
Our ref:

* Items marked with an asterisk [*] are required fields and must be fully completed.