A Python wrapper around the Meteoclimatic service.
PyMeteoclimatic is a client Python wrapper library for Meteoclimatic. Meteoclimatic is a large network of non-professional automatic real-time weather stations and an important directory of weather resources. The geographical scope of Meteoclimatic comprises the Iberian Peninsula, the two Spanish archipelagos (the Balearic Islands and the Canary Islands), southern France and Africa near the Strait of Gibraltar.
PyMeteoclimatic relies on the Meteoclimatic RSS feed. More specifically, PyMeteoclimatic leverages the coded, normalized data blocks included as HTML comments in the feeds between the [[<BEGIN:identificador:DATA>]] and [[<END:identificador:DATA>]] tags to obtain station weather information.
With PyMeteoclimatic you can obtain weather information directly from Meteoclimatic stations identified by their code. You can find out the station code from the station profile page in the Meteoclimatic site.
When obtaining the weather information from a station, you will get a meteoclimatic.Observation object, which represents the weather which is currently being observed from a certain station and contains the following fields.
| Field | Type | Description |
|---|---|---|
reception_time |
datetime.datetime |
Timestamp telling when the weather obervation has been received from the station |
station |
meteoclimatic.Station |
The Station relative to this observation |
weather |
meteoclimatic.Weather |
The Weather relative to this observation |
A meteoclimatic.Station object contains the following data.
| Field | Type | Description |
|---|---|---|
name |
str |
Name of the station |
code |
str |
Meteoclimatic code of the station (e.g. "ESCAT4300000043206B") |
url |
str |
URL of the Meteoclimatic station page |
A meteoclimatic.Weather object contains the following data. Note that not all stations have the same physical sensors and capabilities (e.g. pluviometer, barometer, ...), therefore, some of these values may be None for some stations. Check the Meteoclimatic station page for more information on your preferred station capabilities.
| Field | Type | Description |
|---|---|---|
reference_time |
datetime.datetime |
Timestamp of weather measurement |
condition |
meteoclimatic.Condition or str |
Single-word weather condition (e.g. "sun", "suncloud", "rain", ...). If it's a recognized condition, it will be mapped to a value of the meteoclimatic.Condition enumerate, otherwise it will be stored as a string |
temp_current |
float |
Current temperature in Celsius |
temp_max |
float |
Maximum temperature in Celsius for the past 24 hours |
temp_min |
float |
Minimum temperature in Celsius for the past 24 hours |
humidity_current |
float |
Current humidity in percentage points |
humidity_max |
float |
Maximum humidity in percentage points for the past 24 hours |
humidity_min |
float |
Minimum humidity in percentage points for the past 24 hours |
pressure_current |
float |
Current atmospheric pressure in hPa units |
pressure_max |
float |
Maximum atmospheric pressure in hPa units for the past 24 hours |
pressure_min |
float |
Minimum atmospheric pressure in hPa units for the past 24 hours |
wind_current |
float |
Current wind speed in km/h units |
wind_max |
float |
Maximum wind speed in km/h units for the past 24 hours |
wind_bearing |
float |
Wind bearing in degree units |
rain |
float |
Precipitation in mm units for the past 24 hours |
Install with pip for your ease.
$ pip install pymeteoclimatic
from meteoclimatic import MeteoclimaticClient
client = MeteoclimaticClient()
observation = client.weather_at_station("ESCAT4300000043206B")
print("Timestamp")
print("~~~~~~~~~")
print(observation.reception_time)
print()
print("Station")
print("~~~~~~~")
print(observation.station)
print()
print("Weather")
print("~~~~~~~")
print(observation.weather)Output:
Timestamp
~~~~~~~~~
2020-06-09 13:45:55+00:00
Station
~~~~~~~
<class 'meteoclimatic.station.Station'>({'name': 'Reus - Nord (Tarragona)', 'code': 'ESCAT4300000043206B', 'url': 'http://www.meteoclimatic.net/perfil/ESCAT4300000043206B'})
Weather
~~~~~~~
<class 'meteoclimatic.weather.Weather'>({'reference_time': datetime.datetime(2020, 6, 9, 13, 45, 55, tzinfo=datetime.timezone.utc), 'condition': <Condition.sun: 'sun'>, 'temp_current': 24.0, 'temp_max': 24.2, 'temp_min': 13.7, 'humidity_current': 45.0, 'humidity_max': 80.0, 'humidity_min': 44.0, 'pressure_current': 1013.5, 'pressure_max': 1015.3, 'pressure_min': 1013.5, 'wind_current': 13.0, 'wind_max': 31.0, 'wind_bearing': 232.0, 'rain': 0.2})
Please feel free to submit issues or fork the repository and send pull requests to update the library and fix bugs, implement support for new sentence types, refactor code, etc.