Zum Inhalt springen
Air Quality API

Air Quality API

Täglicher Luftqualitätsindex und stündlich Stickstoffdioxid, Ozon, PM10 und PM2.5 bodennah sowie die Saharastaub-Fracht für einen Punkt, aus dem Chemiewettermodell der GeoSphere (3 km). Der Index folgt dem Europäischen Luftqualitätsindex der EEA (1 gut bis 6 sehr schlecht; SO2 liefert das Modell nicht). Kartenebenen: die Wetterkacheln aqi, no2, o3, pm10, pm25 und dust (siehe Weather API). Quelle: GeoSphere Austria, CC BY 4.0.

Basis-URL: https://api.mapx.at · Rate-Limit-Zone: search (10/s) · Guide: Karten

Air quality index and pollutants for a point

GET /v1/air-quality/{coordinate}

GeoSphere chemical weather model (3 km) bilinear to the point: daily index aqi (3 days) and hourly NO2, O3, PM10, PM2.5 near the surface in ug/m3 with an hourly index (worst level by the EEA European Air Quality Index limits; SO2 is not provided by the model) plus the Saharan dust load (mg/m2, 0.2 degree grid).

Mehr

Austria and surroundings. Data source: GeoSphere Austria, CC BY 4.0 (attribution required).

Parameter

NameOrtTypPflichtStandardBeschreibung
coordinatepathstringja–lon,lat, e.g. 16.37,48.21
hoursqueryinteger241 to 72, default 24

Beispiel

curl -s -H "Authorization: Bearer YOUR_TOKEN" "https://api.mapx.at/v1/air-quality/16.3725,48.2085?hours=6" | jq

Beispielantwort

{
  "location": {
    "lon": 16.37,
    "lat": 48.21
  },
  "model": "GeoSphere chemical weather forecast",
  "reference_time": "2026-11-08T00:00Z",
  "index_scale": {
    "1": "good",
    "2": "fair",
    "3": "moderate",
    "4": "poor",
    "5": "very_poor",
    "6": "extremely_poor"
  },
  "daily": [
    {
      "date": "2026-11-08",
      "index": 2,
      "category": "fair"
    }
  ],
  "hourly": [
    {
      "time": "2026-11-08T12:00Z",
      "index": 2,
      "category": "fair",
      "no2_ugm3": 18.2,
      "o3_ugm3": 45.1,
  …

Fehler (Details: Fehlerkatalog)

StatusBedeutung
400Parameter fehlt oder ist ungültig
401Token fehlt oder ungültig (missing-token, invalid-token, token-expired)
403Token nicht erlaubt (origin-not-allowed, origin-missing, pk-not-allowed, app-not-allowed, token-blocked, ip-not-allowed)
404Nicht gefunden (Name, Pfad oder Position)
429Rate-Limit überschritten, Retry-After abwarten
503Daten vorübergehend nicht verfügbar

Playground

Playground
curl
Antwort erscheint hier.