NETATMO WEATHER SERVER

This project is a little NodeJS server exposing public weather datas through a rest api

How to start

Installation

Two options are available.

1. Use the docker image (recommended)

docker run -p 3000:3000 GHN_PORT=3000 --name netatmo-weather-server -d rtrompier/netatmo-weather-server:latest

2. Use the npm package

$ sudo npm install -g netatmo-weather-server

Or update to latest version when already installed:

$ sudo npm update -g netatmo-weather-server

How to start (for NPM only)

$ netatmo-weather-server

You can pass the parameters through the node api. Execute this command to show all available parameters, or see Parameters section :

$ netatmo-weather-server --help

Parameters

You can pass the following params by environment variables :

• NWS_VERBOSE Run with verbose mode
• NWS_PORT Http server port
• NWS_LATITUDE Latitude to search nearby
• NWS_LONGITUDE Longitude to search nearby
• NWS_DISTANCE Distance to search nearby (in KM)

How to use

A REST Api is available to get weathers data.

1. You juste have to execute a web request GET http://YOUR_SERVER_IP:3000/weather
2. You will receive a response with the following values :

| Parameter | Description | | --- | --- | | temperature | The average of the temperature values from all stations around your position | | humidity | The average of the humidity values from all stations around your position | | pressure | The average of the pressure values from all stations around your position | | rain_60min | Quantity of rain during the last 60 min (in mm) | | rain_24h | Quantity of rain during the last 24 hours (in mm) | | rain_live | Is currently rainning (1 : yes, 0 : false) | | rain_timeutc | Last time raining (timestamp) | | wind_strength | Wind strength | | wind_angle | Wind angle | | gust_strength | Gust strength | | gust_angle | Gust angle | | wind_timeutc | Wind timestamp |