The Freemap API

---

Introduction

Freemap aims to provide a wide range of free data for countryside users, including path annotations (such as points of difficulty, blockages and interesting views). The Freemap API now allows you to use this data from other websites and applications, so if you are developing any sort of countryside website or standalone application, you can now use the Freemap API to access and even alter the Freemap data!

Documentation

Markers

The URL for markers is as follows:

http://www.free-map.org.uk/freemap/api/markers.php

The URL expects an action parameter which should be one of add,delete, edit and get, e.g:

http://www.free-map.org.uk/freemap/api/markers.php?action=add

Each of the four actions expects further query string parameters, detailed below; failure to provide all parameters will result in a 400 Bad Request.

Adding a marker (action=add)

The add action expects four further parameters:

• lat - the latitude of the marker;
• lon - the longitude of the marker;
• type - the type of the marker, currently hazard (e.g. a path blockage), directions (path directions, to help people work out the correct way to go) or info (an interesting place, e.g. a viewpoint or historical site)
• description - a description, e.g. a description of the hazard or the path directions)

The add call will return the numerical ID of the marker in the response body, or a 400 Bad Request error code if one or more of the required parameters were missing.

Retrieving markers (action=get)

The get action takes one further parameter: bbox. This is the bounding box of the area to retrieve markers from taking the standard format: west,south,east,north. Markers are returned in GeoRSS format.

Editing a marker (action=edit)

The edit action takes an id parameter containing the marker ID (as returned by add, above) and one or both of the type and description parameters (see above) and changes them appropriately for the specified marker. It will return 404 Not Found if the ID is invalid.

Deleting a marker (action=delete)

The delete action takes an id parameter containing the marker ID (as returned by add, above) and deletes the specified marker. Again it returns 404 Not Found if the ID is invalid.