Library for fetching weather information from Finnish Meteorological Institute (FMI)
Project description
Finnish Meteorological Institute Weather
Library for fetching weather information from Finnish Meteorological Institute (FMI).
Originally build for personal use because I wanted to create a FMI integration for Home Assistant.
Library is not yet available in PyPi.
How to use
Working example can be found in example.py.
Get the weather by place name
Weather station depends on FMI service.
import fmi_weather_client
weather = fmi_weather_client.weather_by_place_name("Mäkkylä, Espoo")
If place name is not known or weather data is not available, the following exception is thrown:
fmi_weather_client.errors.NoWeatherDataError
Get the weather by coordinates
Weather stations is the closest one
import fmi_weather_client
weather = fmi_weather_client.weather_by_coordinates(63.361604, 27.392607)
If there are no stations within 50 km, the following exception is thrown:
fmi_weather_client.errors.NoWeatherDataError
Weather data
Available weather information depends on the weather station. Currently supported fields:
- Station name
- Station latitude
- Station longitude
- Measurement time
- Temperature (°C)
- Humidity (%)
- Wind speed (m/s)
- Wind gust (m/s)
- Maximum gust wind in the past 10 minutes
- Wind direction (°)
- Dew point (°C)
- Precipitation amount (mm)
- Amount of rain in the past hour
- Precipitation intensity (mm/h)
- Pressure (hPa)
- Visibility (m)
- Cloud coverage
- Cloud coverage is indicated as 1/8 sky.
- 0.0 means no clouds
- 4.0 means half cloudy
- 8.0 means overcast
Observation data contains two fields: value
and unit
. You can also just print the measurement object to get a string
representation:
print('Temperature: %s' % weather.temperature)
# Output: Temperature: 1.4 °C
Development
Setup
Create and activate a virtual environment
$ python -m venv venv
$ source venv/bin/activate
Install required packages
$ python -m pip install -r requirements.txt
$ python -m pip install -r requirements-dev.txt
When you stop working, deactivate virtual environment
$ deactivate
Run tests
$ pytest
Run code quality tools
$ flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics --exclude venv
$ flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --exclude venv
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for fmi_weather_client-0.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 536a3854f257c1594d7b3a98e69c2e2614147e07d945286cebb3ad639b58e5b0 |
|
MD5 | b0fc7a4255e8e37ae643a1b9ea57d28f |
|
BLAKE2b-256 | dfcebb8df1aca3fef84f864edf6c62e7e606cb58ed3ed64691048f58c96d5d18 |