Skip to content

Latest commit

 

History

History
90 lines (76 loc) · 2.4 KB

README.md

File metadata and controls

90 lines (76 loc) · 2.4 KB
Raw

FMI weather observation and forecast fetcher

Test Status

This library provides easy to use methods for fetching both observations and forecast data from Finnish Meteorological Institute (FMI). 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, 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.