OpenSenseMap-API
This is the back-end for OpenSenseMap.
OpenSenseMap is part of the SenseBox project. To get more information about OpenSenseBox and SenseBox visit the before mentioned links or have a look at this video.
The API has been built as part of my bachelor thesis at the ifgi (Institute for Geoinformatics, WWU Münster).
Technologies
Install dependencies (Ubuntu)
It is assumed that you have installed node.js (developed using 0.10.26)
Install MongoDB according to the manual and create the following database schema:
Database "OSeM-api"
- Collections
- Box
- Measurement
- Sensor
- User
Run for Development & Production
Edit your configuration in config/index.js:
| Variable name | Explanation |
|---|---|
exports.targetFolder |
The folder where a generated Arduino sketch for each box will be saved upon registration, should be in your htdocs |
exports.imageFolder |
The folder where banner images for boxes are stored, should be in your htdocs |
exports.dbuser |
MongoDB database user, leave empty if not configured |
exports.dbuserpass |
MongoDB database password, leave empty if not configured |
After that, run the following command to install dependencies:
npm install
Then start the API process, press CTRL+C to stop:
node app.js
Create the JSDoc pages
To create the documentation you need apidocjs and run:
apidoc -e node_modules/
To push a new Version to gh-pages run:
git subtree push --prefix doc/ origin gh-pages
License
MIT - Matthias Pfeil 2015