yrwatertemperatures 0.1.2

A Python client to fetch water temperatures in Norway from YR.no.

Norway Water Temperature API Client

A Python package to fetch water temperature data from various locations in Norway.

Installation

pip install yrwatertemperatures

API key

To use this package, you need an API key from yr.no, see https://hjelp.yr.no/hc/no/articles/5949243432850-API-for-badetemperaturer for more info.

Usage

First, you'll need to get an API key from the provider of the water temperature data.

Then, you can use the package like this:

from yrwatertemperatures import WaterTemperatures

# Replace 'YOUR_API_KEY' with your actual API key
api_key = 'YOUR_API_KEY'
client = WaterTemperatures(api_key)

try:
    # Fetch the water temperature data
    temperatures = client.get_all_water_temperatures()

    # Print the location and temperature
    for temp in temperatures:
        print(f"Location: {temp.name}, Temperature: {temp.temperature}°C")

except Exception as e:
    print(f"An error occurred: {e}")

Data Structure

The get_temperatures method returns a list of LocationData objects. Each object has the following attributes:

name (str): The name of the location.

location_id (str): A unique identifier for the location.

latitude (float): The latitude of the location.

longitude (float): The longitude of the location.

elevation (int): The elevation of the location in meters.

county (str): The county where the location is.

municipality (str): The municipality where the location is.

temperature (float): The water temperature in Celsius.

time (datetime): The timestamp of the reading.

source (str): The source of the data (not always present).