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: 2 months 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 (over 10 years ago)
Default Branch: master
Last Pushed: 2024-02-28T12:31:54.000Z (4 months ago)
Last Synced: 2024-04-14T02:29:31.571Z (3 months ago)
Topics: citizenscience, iot, opensensemap, platform, sensor
Language: HTML
Homepage: https://opensensemap.org
Size: 13.1 MB
Stars: 95
Watchers: 11
Forks: 51
Open Issues: 53
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- License: LICENSE

Lists

open-sustainable-technology - openSenseMap - Wikipedia for environmental data in order to awaken and promote education, environmental and climate protection. (Natural Resources / Air Quality)

README

        ![openSenseMap](https://raw.githubusercontent.com/sensebox/resources/master/images/openSenseMap_github.png)

[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg)](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.

[![Deploy to Netlify](https://www.netlify.com/img/deploy/button.svg)](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/