Developer Resources

Open Source

This project is the first of its kind for the Isle of Man, and we've released the source code for both the website and mobile app under the GPL v3 license.

You can get the source from GitHub.

If you'd like to contribute patches or add additional functionality to either the web or mobile app, just fork the project on GitHub and send us a pull request and we can merge the changes back.

The database is available under the Open Data Commons Attribution License.

Accessing the Database/API

Anything that can talk HTTP can access the database and query its data. CouchDB is a document-oriented datastore which operates entirely via HTTP, so accessing and querying data is as simple as making a GET request:

Using cURL you can access the database with:

curl -X GET http://redrobot.iriscouch.com/openelm/

You can retrieve all reviewed records (limited to first 5):

curl -X GET http://redrobot.iriscouch.com/openelm/_design/record/_view/reviewed?limit=5

Retrieve a specific record:

curl -X GET http://redrobot.iriscouch.com/openelm/89a860070961ea5ce303c86a04ea7a23

Get a record's photo (do this in your browser):

Perform geospatial queries:

curl -X GET http://redrobot.iriscouch.com/openelm/_design/geo/_spatial/pointsOnly?bbox=54.11064096067739,-4.677257921875025,54.23122316732083,-4.347668078125025

You can also view the database using a convenient interface at:

To create a local copy of the live database:

            
#create a local CouchDB database
curl -X PUT http://127.0.0.1:5984/openelm

#Replicate the live database to your local machine
curl -X POST -H "Content-Type: application/json" http://127.0.0.1:5984/_replicate -d '{"source":"http://redrobot.iriscouch.com/openelm","target":"http://127.0.0.1:5984/openelm"}'

If you interested in using the dataset in a project, you should read the CouchDB – Definitive Guide and what CouchDB can offer.

About the Developers

Open Elm Project was built and designed by Red Robot Studios.

Red Robot Studios is an Island-based web and mobile software development company who love making great things!

Proudly Built Using: