airsofia APIairsofia.info ↗

"""Walkthrough: Sensor.Community SDK — monitor air quality data globally."""
from parse_apis.sensor_community_air_quality_api import (
    SensorCommunity, SensorModel, CountryCode, DataType, SensorNotFound
)

client = SensorCommunity()

# Search sensors by geographic area (Paris, 10km radius)
for reading in client.sensorreadings.by_area(latitude="48.8566", longitude="2.3522", radius="10", limit=5):
    print(reading.id, reading.timestamp, reading.location.country)

# Filter by country using the CountryCode enum
for reading in client.sensorreadings.by_country(country_code=CountryCode.BG, limit=3):
    print(reading.sensor.sensor_type.name, reading.location.latitude)

# Filter by sensor model
reading = client.sensorreadings.by_type(sensor_type=SensorModel.SDS011, limit=1).first()
if reading:
    for dv in reading.sensordatavalues:
        print(dv.value_type, dv.value)

# Drill into a specific sensor's latest readings
if reading:
    sensor = client.sensor(id=reading.sensor.id)
    for r in sensor.latest_readings(limit=3):
        print(r.timestamp, r.sensordatavalues)

# Typed error handling for a sensor that doesn't exist
try:
    for r in client.sensor(id=9999999).latest_readings(limit=1):
        print(r.id)
except SensorNotFound as exc:
    print(f"Sensor not found: {exc.sensor_id}")

# List archive files for historical data
archive = client.archivedirectories.list_files(year="2024", date="2024-01-15")
print(archive.url, len(archive.files))

print("exercised: sensorreadings.by_area / by_country / by_type / sensor.latest_readings / archivedirectories.list_files")