Cycle routing API

• Details for:

  Introduction Cycle routing Feedback Nearest point Leisure (circular) routing Geocoder Points of Interest (POIs) Collisions data Photos Photomap categories Photo Add photo User validate User create Status
• Obtain API key
• Usage policy
• Uptime policy

Geocoder

This is mainly a wrapper to OSM's Nominatim. However, we add other logic (e.g. bounding box, name near) and data (postcodes, station codes), so please use our geocoder interface rather than Nominatim directly, for consistency.

Please ensure you comply with the Nominatim Usage Policy. Normal bona-fide use should be perfectly compliant.

Example: Thoday Street

http://cambridge.cyclestreets.net/api/geocoder.xml?key=registeredapikey&w=0.113937&s=52.201937&e=0.121963&n=52.208669&zoom=16&street=thoday%20street

returns a list of results, including the name, latitude, longitude and where it is 'near'.

key string

Your registered API key

street string

The search string, e.g. for a name/street/place/postcode, URL-encoded (e.g. 'thoday%20street')

n float (optional, but strongly recommended)

The latitude at the top (north) of the bounding box (visible area).

e float (optional, but strongly recommended)

The longitude at the right (east) of the bounding box (visible area).

s float (optional, but strongly recommended)

The latitude at the bottom (south) of the bounding box (visible area).

w float (optional, but strongly recommended)

The longitude at the left (west) of the bounding box (visible area).

zoom int (optional)

Current map zoom level.

If the boundaries are supplied, then the geocoder will tend to prefer results in this part and near surrounding parts of the country when the zoom is 12 or higher (this logic may change in future to be zoom-agnostic if the bounding box is sent).

Sending z= will be treated as zoom= . z= is now deprecated and will be disabled in due course.