• 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

Retrieve a specified gallery

The Galleries Get API retrieves a single Photo Gallery containing cycling-related infrastructure which has been submitted by a user.

Each Gallery has metadata attached to it, such as a title, a description, list of locations and more.

Note that each location has a license (e.g. Creative Commons, Public Domain, No reproduction permitted, etc.) as specified by the contributor. You are required to respect the specified license. Also, CycleStreets naturally has a database right in the collective dataset.

Example

Example which returns the data of a user-created Photo Gallery

https://api.cyclestreets.net/v2/galleries.show?id=300

Result:

{
    "id": 300,
    "title": "Cambridge Station Cycle Parking",
    "description": "Photos of the new and improved cycling parking.",
    "photos": [
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        9
    ],
    "datetime": 1437336779
}

Request parameters - required

id int

The gallery ID.

Request parameters - optional

datetime int

Time (Unix timestamp) of last update of the gallery.
This can be given as friendly, friendlydate, sqldatetime or unixtime
If this parameter is not supplied, the default output will be in unixtime format, as shown in the example above.

Response

GeoJSON object containing one Gallery

See example above.

Error response

JSON object containing an error key and a text string.

Example error (text string will vary):

{
    "error": "Invalid gallery ID recieved."
}