Add helper FMI.fetch_stations() for fetching the available stations.

README.md

@@ -50,6 +50,35 @@ f = FMI()
 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
 --------------
 

fmi/fmi.py

@@ -113,3 +113,25 @@ def forecast(self, model='hirlam', **params):
             maxlocations=1,
             klass=Forecast,
             **params)
+
+    @staticmethod
+    def fetch_stations():
+        response = requests.get('https://cdn.fmi.fi/weather-observations/metadata/all-finnish-observation-stations.fi.json')  # noqa: E501
+        response.raise_for_status()
+        return [
+            {
+                'fmisid': station.get('fmisid', None),
+                'wmo': station.get('wmo', None),
+                'name': station.get('name', ''),
+                'latitude': station.get('y', None),
+                'longitude': station.get('x', None),
+                'height': station.get('z', None),
+                'started': station.get('started', 1900),
+                'groups': [
+                    x.strip()
+                    for x in station.get('groups', '').split(',')
+                ],
+            }
+            for station in response.json().get('items', [])
+            if station['ended'] is None
+        ]

setup.py

@@ -3,7 +3,7 @@
 
 setup(
     name='fmi_weather',
-    version='1.1.2',
+    version='1.2.0',
     description='FMI weather data fetcher',
     author='Kimmo Huoman',
     author_email='[email protected]',