Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/sensebox/openSenseMap
Platform for storing and exploring sensor data
https://github.com/sensebox/openSenseMap
citizenscience iot opensensemap platform sensor
Last synced: about 1 month ago
JSON representation
Platform for storing and exploring sensor data
- Host: GitHub
- URL: https://github.com/sensebox/openSenseMap
- Owner: sensebox
- License: mit
- Created: 2013-12-26T01:57:42.000Z (about 11 years ago)
- Default Branch: master
- Last Pushed: 2024-02-28T12:31:54.000Z (10 months ago)
- Last Synced: 2024-10-29T21:02:39.286Z (about 2 months ago)
- Topics: citizenscience, iot, opensensemap, platform, sensor
- Language: HTML
- Homepage: https://opensensemap.org
- Size: 13.1 MB
- Stars: 99
- Watchers: 11
- Forks: 51
- Open Issues: 53
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- open-sustainable-technology - openSenseMap - Wikipedia for environmental data in order to awaken and promote education, environmental and climate protection. (Natural Resources / Air Quality)
README
[](http://commitizen.github.io/cz-cli/)
This repository contains the code of the openSenseMap frontend running at [https://opensensemap.org](https://opensensemap.org). To get more information about openSenseMap and senseBox visit the before mentioned links or have a look at this [video](https://www.youtube.com/watch?v=I8ZeT6hzjKQ) or read the [openSenseMap](https://docs.sensebox.de/category/opensensemap/) chapter in our documentation. openSenseMap is part of the [senseBox] project.
Originally, this frontend has been built as part of the bachelor thesis of [@mpfeil](https://github.com/mpfeil) at the ifgi (Institute for Geoinformatics, WWU Münster) and is currently maintained by [@mpfeil](https://github.com/mpfeil).
The easiest way to get up and running with your own copy is clicking the Deploy to Netlify button below. It will clone the repository into your own account, and deploy the site to Netlify. It is going to ask for `Maptiles url` and `API endpoint`. Please use the default values listed under [configuration](#Configuration) or use your own.
[](https://app.netlify.com/start/deploy?repository=https://github.com/sensebox/openSenseMap)
## Configuration
You can configure the API endpoint and/or map tiles using the following environmental variables:
| ENV | Default value |
| --------- | ----------------- |
| OPENSENSEMAP_API_URL | https://api.testing.opensensemap.org |
| OPENSENSEMAP_CMS_URL | |
| OPENSENSEMAP_STYLE_URL | |
| OPENSENSEMAP_ACCESS_TOKEN | |
You can set them in your `terminal` or create a file called `.env` and set the values.
## Development
- Have [Node.js] v10, [grunt]() and [bower]() installed
- Check out a branch for your feature (`git checkout my-aweseome-feature`)
- Run `npm install` and `npx bower install`
- Run frontend in development mode (`npx grunt serve`)
- Commit your changes to your branch and push it to your fork
- Create a pull request against the `master` branch
See also: [CONTRIBUTING](.github/CONTRIBUTING.md)
## Release
To release a new version of the openSenseMap frontend do the following:
- Run `npm run release` on `master` branch
- Run `git push --follow-tags origin master`
- Create new release on [Github Release](https://github.com/sensebox/openSenseMap/releases)
## Related projects
### Services
- [openSenseMap Backend](https://github.com/sensebox/openSenseMap-API)
- [openSenseMap translations](https://github.com/sensebox/openSenseMap-i18n)
### Deployment
- [OSeM-compose](https://github.com/sensebox/OSeM-compose)
- [openSenseMap-infrastructure](https://github.com/sensebox/openSenseMap-infrastructure)
## Technologies
* [AngularJS]
## Organization
### Branches
- master (runs on testing server)
- Is used for production container build tags
## Docker
### openSenseMap including openSenseMap-API
For installing openSenseMap and openSenseMap-API with Docker check out our [oSeM-compose](https://github.com/sensebox/OSeM-compose) repository.
### openSenseMap
To build just openSenseMap you can run:
```docker build -t osem .```
Following ```build-args``` are availble:
| Build Arg | Default value |
| --------- | ----------------- |
| OPENSENSEMAP_API_URL | https://api.opensensemap.org |
| OPENSENSEMAP_CMS_URL | |
| OPENSENSEMAP_STYLE_URL | |
| OPENSENSEMAP_ACCESS_TOKE | |
## License
[MIT](LICENSE) - Matthias Pfeil 2015 - now
[AngularJS]:https://angularjs.org/
[Node.js]:http://nodejs.org/
[openSenseMap]:https://opensensemap.org/
[senseBox]:https://sensebox.de/