This is a library to consume the SRF Meteo weather API published by Switzerland's public broadcasting cooperation, SRG SSR. You can find the API documentation on their website.
Important notice: SRF Meteo has revamped their API and therefore the current project is not working anymore. Since free access has now been severely restricted (6 calls per day for one location only), I am considering to scrap this project entirely. Its original purpose was for integrating with SmartHome solutions and now weather information is limited to a few updates a day.
The following code snippet shows how to use the library to get the current weather for a specific location in Switzerland (Berne).
from typing import Final
from datetime import datetime
import json
from swissweather.api import getCurrentForecast
import asyncio
async def main():
CLIENT_ID: Final = 'MY_CLIENT_ID' # get your account at https://developer.srgssr.ch/apis/srgssr-weather
CLIENT_SECRET: Final = 'MY_CLIENT_SECRET'
LATITUDE: Final = "46.94843" # Berne downtown
LONGITUDE: Final = "7.44323" # Berne downtown
response = await getCurrentForecast(CLIENT_ID, CLIENT_SECRET, LATITUDE, LONGITUDE)
print(json.dumps(response, indent=2))
if __name__ == "__main__":
asyncio.run(main())First, you must apply for a developer token and agree to their terms. As of this writing (June 2020), this is free for non-commercial use. After being accepted, you will get a client_id and client_secret you can use to interact with the service using this Python library.
All endpoints require the following parameters to be passed along:
client_id: the username you received from registering as developer from the link above
client_secret: the matching password you received from registering as developer from the link above
latitude: the first part of the coordinates from the location in Switzerland you want to know the forecast in WGS 84 notation.
longitude: the second part of the coordinates from the location in Switzerland you want to know the forecast in WGS 84 notation.
You can use an online map service like https://map.geo.admin.ch to get the coordinates for location you are interested in. Make sure you get the coordinates in the WGS 84 notation, not in the Swiss coordinate system. For this, you can switch to the WGS 84 notation in the dropdown at the bottom left of the map screen. Then move the mouse over the location you are interested in and you will see the coordinates next to the dropdown at the bottom of the map.
Currently, the following end-points are supported:
https://api.srgssr.ch/forecasts/v1.0/weather/current: Returns current weather forecast for all Swiss locations.
You get this forecast by calling getCurrentForecast(client_id: str, client_secret: str, latitude: str, longitude: str).
To find out about the information provided in the payload, have a look at the official documentation for currentforecast.
https://api.srgssr.ch/forecasts/v1.0/weather/7day: Returns next 7 days forecast for specific location.
You get this forecast by calling getSevenDayForecast(client_id: str, client_secret: str, latitude: str, longitude: str).
To find out about the information provided in the payload, have a look at the official documentation for weeksforecastbyid.
https://api.srgssr.ch/forecasts/v1.0/weather/nexthour: Returns forecast data for the next hour for a specific location.
You get this forecast by calling getHourlyForecast(client_id: str, client_secret: str, latitude: str, longitude: str).
To find out about the information provided in the payload, have a look at the official documentation for hourforecastbyid.
https://api.srgssr.ch/forecasts/v1.0/weather/24hour: Returns cities within Swiss locations.
You get this forecast by calling get24HourForecast(client_id: str, client_secret: str, latitude: str, longitude: str).
To find out about the information provided in the payload, have a look at the official documentation for 24hourforecastbyid.