https://github.com/kipe/fmi
FMI weather observation and forecast fetcher
https://github.com/kipe/fmi
Last synced: 9 months ago
JSON representation
FMI weather observation and forecast fetcher
- Host: GitHub
- URL: https://github.com/kipe/fmi
- Owner: kipe
- License: mit
- Created: 2015-08-26T06:14:35.000Z (almost 11 years ago)
- Default Branch: master
- Last Pushed: 2022-11-15T15:49:05.000Z (over 3 years ago)
- Last Synced: 2024-08-09T08:28:40.244Z (almost 2 years ago)
- Language: Python
- Size: 2.56 MB
- Stars: 7
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
FMI weather observation and forecast fetcher
============================================
This library provides easy to use methods for fetching both observations and
forecast data from [Finnish Meteorological Institute (FMI)](https://en.ilmatieteenlaitos.fi/open-data).
Currently just a quick hack, as I needed this for a project.
Installation
-----
```
pip install fmi_weather
```
Usage
-----
The library usage is fairly simple:
```
from fmi import FMI
f = FMI(place='Lappeenranta')
# f.observations() returns a list of Observation -objects for the last X hours.
print(f.observations())
```
Another way to set the API key and place is by setting them in environment variables FMI_PLACE.
After setting the environment variables, you can use the library without "any" initialization:
```
from fmi import FMI
f = FMI()
# f.forecast() returns a list of Forecast -objects
print(f.forecast())
```
### New in 1.1.0
`place` or `coordinates` are not longer required,
but they are respected if present.
This allows the usage of `fmisid` and `wmo` for definition of location,
allowing better transparency on what location is used.
You can list view a list of locations at:
https://www.ilmatieteenlaitos.fi/havaintoasemat
For example:
```
from fmi import FMI
f = FMI()
# Fetch and print observations from Lappeenranta Airport
print(f.observations(fmisid=101237))
```
### New in 1.2.0
Added a helper `FMI.fetch_stations()` for fetching the possible stations. For example:
```
>>> from fmi import FMI
>>> from pprint import pprint
>>> pprint([
... station
... for station in FMI.fetch_stations()
... if station['name'].startswith('Lappeenranta')
... ])
[{'fmisid': 101252,
'groups': ['sää'],
'height': 77,
'latitude': 61.2,
'longitude': 28.47,
'name': 'Lappeenranta Hiekkapakka',
'started': 2009,
'wmo': 2919},
{'fmisid': 101237,
'groups': ['sää'],
'height': 104,
'latitude': 61.04,
'longitude': 28.13,
'name': 'Lappeenranta lentoasema',
'started': 1950,
'wmo': 2958}]
```
Forecast icons
--------------
Thanks to [FMI](https://github.com/fmidev/opendata-resources),
SVG icons are also provided as part of the library.
The weather symbol information is only available for forecasts unfortunately,
so the `Observation.icon` -property is valid only for them.
`.icon` returns the SVG-file path and `.icon_as_svg` returns the content itself.