• Help
• Journey Planner
• How it works
• OSM
• Developers
• API
• Photomap
• Photo licensing

CycleStreets API (v2)

• Details for:

  * Introduction * Overview & how to specify the API key Cycle routing - plan new journey Cycle routing - retrieve Cycle routing - plan leisure (circular) route Journeys of user Isochrones - show Nearest point Batch routes matrix - create job Batch routes matrix - control job Batch routes matrix - job data Batch routes matrix - delete job Geocoder Photomap locations Photomap location Photomap categories Add photo Update photo Like photo Photo of the day Photomap tags Points of Interest (POIs) Points of Interest (POIs) - types Collisions data Collision report Collisions metadata Traffic counts data Popup cycleways - locations being implemented Popup cycleways - suggested LTNs: Modal filters LTNs: Streets LTN statistics Infrastructure locations Infrastructure location Infrastructure schema GPS tracks - add List galleries Retrieve a specified gallery Create a gallery Update a gallery User authenticate User create Map downloads Status API testing - multiple API testing - run one API testing - list of tests Add feedback API V1 documentation (deprecated)
• API overview
• Obtain API key
• Usage policy
• Uptime policy

Map downloads

This API call gives a list of map download files in Mapsforge format.

These are for use as offline map packs in the CycleStreets Android app.

Example

https://api.cyclestreets.net/v2/mapdownloads.list

Result:

{
    "type": "FeatureCollection",
    "features": [
        {
            "type": "Feature",
            "properties": {
                "id": "alberta",
                "name": "Alberta",
                "parent": "canada",
                "size": "145MB",
                "lastModified": "2020-04-20",
                "url: "https://example.com/mapsforge/v5/north-america/canada/alberta.map"
            },
            "geometry": {
                "type": "Point",
                "coordinates": [
                    -115.00305,
                    54.49753
                ]
            }
        },
        {
            "type": "Feature",
            "properties": {
                "id": "algeria",
                "name": "Algeria",
                "parent": "africa",
                "size": "146MB",
                "lastModified": "2020-05-29",
                "url: "https://example.com/mapsforge/v5/africa/algeria.map"
            },
            "geometry": {
                "type": "Point",
                "coordinates": [
                    1.66554,
                    28.35079
                ]
            }
        },
        ...
    }
}

Request parameters - required

None.

Request parameters - optional

fullgeometries (1|0), default 0

Whether to return full geometries, which is a much larger download size. By default, the centroid is given only.

Response

JSON object as above.

Error response

JSON object containing an error key and a text string.

Example error (text string will vary):

{
    "error": "The value of the supplied fullgeometries was not a numeric boolean (1 or 0)."
}