Report on air quality sensors in Africa using APIs of open data projects.
This project exists because I went to a workshop in South Africa where air quality sensors were put together. These sensors contribute air quality measurement data to the luftdaten.info project. This data and those of other countries is made available through their APIs. This projects makes it easy to see the measurements of the South African (ZA) sensors.
This was later expanded to include the Open Africa site's data too for several African countries.
- Jekyll - To build the static site. No Jekyll templating or themes are used though.
- Bootstrap - To add styling to the tables (from tutorial), the navbar (from tutorial) and to the page overall.
- JQuery - To handle fetching JSON data.
- Mustache JS - To create tables easily using a template and dynamic data. These templates have to be escaped using the Jekyll
rawtag.
- Clone the project from the original or a fork. For example:
$ git clone git@github.com:MichaelCurrin/open-air.git
- Install Jekyll globally.
- Start the server.
$ cd <PATH_TO_REPO> $ jekyll serve
- Open this URL in the browser.
- Use this repo or a fork on Github Pages.
- Go to Settings.
- Go to Github Pages section.
- Enable website using
masterbranch. The page will reload. - Navigate to the section again and use the URL you see.
- This project could be expanded to allow a user choice of country using a droplist for Luftdaten page.
- Add count of rows at the top of a sensor page.
- Add sort to tables.
- Add filter to tables. Such as by pin type or location or value range.
- Freeze top row of table.
- Fix navbar to the top of the screen.
Feel free to fork this project and submit a PR with improvements. Or use this as a template for your own data project, with a link back this this repo.