tecdottir

This is a project to get measurements from tecson meteo stations.

The City of Zurich has two such stations:

• Tiefenbrunnen
• Mythenquai

The data is available as CSV from Open Data Zurich.

tecdottir is an API based on this data.

Showcases

Projects based on this API are shown.

• Zürichhorn: map of Zürichhorn with temperature and wind by Markus Steiger

(if you want on the list, create an issue or PR to add your project)

Development

We use swagger to document the API. Please install the CLI tool to edit the swagger file:

npm install -g swagger

(you might need root privileges to do so)

After installing the CLI tool, you can start editing:

swagger project edit

To start the server use:

swagger project start

Tests

To run the tests, use the following command:

npm test

Local database

For local developlment you might want to use a local database in a docker container

docker run --rm -P -p 127.0.0.1:5432:5432 -e POSTGRES_PASSWORD="1234" --name pg postgres:alpine

Or use the provided script:

start_local_database.sh # start in it's own shell

Then you can set DATABASE_URL in .env to postgresql://postgres:1234@localhost:5432/postgres

Once the db is there, import the data:

setup_local_database.sh

Create a new release

1. Update the version number in package.json and api/swagger/swagger.yaml
2. Update the CHANGELOG.md
3. Push code to GitHub
4. Create a new release on GitHub
5. Wait for the GitHub Action to deploy the app to heroku