Cycle routing API

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

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

Feedback

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

Nearest point

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

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

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)

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

Collisions data

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

Photomap

User accounts

User validate

The User validate API validates CycleStreets user account credentials.

User create

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

System status

Status

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

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

We welcome your feedback, especially to report bugs or give us route feedback.
My comments relate to: *	Route problem/feedback Other Journey Planner problem Photomap Report abuse Bug report Other, general feedback
Your comments: *
URL of page: *	http://croydon.cyclestreets.net/api/
How did you find out about CycleStreets?:
Your name:
Your e-mail address:
Our ref: