Wetterdaten

Avirach

Aktuelle Wetterdaten, 7-Tage-Vorhersagen und historische Statistiken über bis zu 26 Jahre — mit intelligentem H3-Geocaching.

Pricing

3Credits

Aktuelles Wetter

3Credits

Batch-Abruf (bis 100 Standorte)

3 Credits pro erfolgreichem Element. Ein Batch zählt als 1 Call gegen das Rate-Limit.

10Credits

Historische Statistiken

25 Credits mit include=data

+25Tagesbereich (2-7 Tage)

+50Monatsabfrage (8-31 Tage)

GET/v1/avirach/overview

Ruft aktuelle Wetterdaten und Vorhersagen für einen Standort ab.

Parameter

Name	Typ	Status	Beschreibung
`h3_index`	string	Empfohlen	H3 Hex-Index (Resolution 6) — bevorzugte Methode
`lat`	number	Alternative	Breitengrad (-90 bis 90) — Alternative, mit lon
`lon`	number	Alternative	Längengrad (-180 bis 180) — Alternative, mit lat

Request

curl "https://api.centra.dbpg.io/v1/avirach/overview?h3_index=861f1d48fffffff" \
  -H "Authorization: Bearer sk-live-your_api_key"

Response

{
  "h3_index": "861f1d48fffffff",
  "center_coords": {
    "lat": 52.52437,
    "lon": 13.39645
  },
  "data": {
    "current": {
      "temperature_2m": 8.5,
      "relative_humidity_2m": 78,
      "weather_code": 3,
      "wind_speed_10m": 12.4
    },
    "daily": {
      "temperature_2m_max": [9.2, 11.1, 8.7],
      "temperature_2m_min": [4.1, 5.8, 3.2]
    }
  }
}

POST/v1/avirach/overview/batch

Ruft aktuelle Wetterdaten für bis zu 100 Standorte in einem einzigen Request ab.

Parameter

Name	Typ	Status	Beschreibung
`items`	array	Ja	Array von 1-100 Standort-Objekten. Jedes Item: { lat, lon } oder { h3_index }.

Request

curl -X POST "https://api.centra.dbpg.io/v1/avirach/overview/batch" \
  -H "Authorization: Bearer sk-live-your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      {"lat": 52.5200, "lon": 13.4050},
      {"lat": 52.5200, "lon": 13.4050},
      {"h3_index": "861f8d0f7ffffff"},
      {"lat": 999, "lon": 0}
    ]
  }'

Response

{
  "results": [
    { "status": "ok", "h3_index": "861f1d48fffffff", "center_coords": {"lat":52.524,"lon":13.396}, "data": {...} },
    { "status": "ok", "h3_index": "861f1d48fffffff", "center_coords": {"lat":52.524,"lon":13.396}, "data": {...} },
    { "status": "ok", "h3_index": "861f8d0f7ffffff", "center_coords": {"lat":48.135,"lon":11.582}, "data": {...} },
    { "status": "error", "error": {"code":"invalid_coords","message":"Latitude must be between -90 and 90, got: 999"} }
  ],
  "usage": { "credits_used": 9, "remaining_balance": 12345 }
}

Batch-Semantik

Die Reihenfolge bleibt erhalten — results[i] entspricht items[i]. Duplikate (gleiche H3-Zelle) liefern dieselbe Payload zurück. Jedes Element hat status:"ok" mit data oder status:"error" mit einem Error-Code (invalid_h3, invalid_coords, missing_params, upstream_unavailable). Abrechnung: 3 Credits pro erfolgreichem Element (Fehler-Elemente sind kostenlos). Ein Batch-Request zählt als ein Call gegen das Rate-Limit, unabhängig von der Anzahl der Items.

GET/v1/avirach/history/locations

Liefert alle für historische Abfragen verfügbaren Standorte (kuratiert, aktuell vor allem Flughäfen). Kostenlos — 0 Credits, kein Rate-Limit-Sonderfall.

Parameter

Name	Typ	Status	Beschreibung
`category`	string	Optional	Optional: Filter nach Kategorie (z. B. ``airport``).
`search`	string	Optional	Optional: Volltext-Suche über Name und ICAO-Code.

Request

curl "https://api.centra.dbpg.io/v1/avirach/history/locations?category=airport" \
  -H "Authorization: Bearer sk-live-your_api_key"

Response

{
  "locations": [
    {
      "h3_index": "851f8d0ffffffff",
      "name": "München Flughafen",
      "icao": "EDDM",
      "category": "airport",
      "lat": 48.3538,
      "lon": 11.7861,
      "data_from": 2000
    }
  ],
  "count": 1
}

GET/v1/avirach/history

Historische Wetterstatistiken für einen Standort — einzelne Tage, Tagesbereiche oder ganze Monate, aggregiert über frei wählbare Zeiträume.

Parameter

Name	Typ	Status	Beschreibung
`h3_index`	string	Empfohlen	H3 Hex-Index (Resolution 5)
`lat`	number	Alternative	Breitengrad (-90 bis 90) — Alternative, mit lon
`lon`	number	Alternative	Längengrad (-180 bis 180) — Alternative, mit lat
`month`	number	Ja	Monat (1-12)
`day`	number	Optional	Tag (1-31). Ohne = ganzer Monat. Nicht kombinierbar mit day_from/day_to
`day_from / day_to`	number	Optional	Tagesbereich (z.B. day_from=20&day_to=27). Nicht kombinierbar mit day
`hour`	number	Optional	Stunde UTC (0-23). Ohne = alle Stunden
`years`	number	Optional	Letzte N Jahre (Default: 26, Max: 26). Nicht kombinierbar mit year / year_from+year_to
`year`	number	Optional	Einzelnes Jahr (z.B. 2023). Nicht kombinierbar mit years / year_from+year_to
`year_from / year_to`	number	Optional	Jahresbereich (z.B. year_from=2010&year_to=2019). Nicht kombinierbar mit years / year
`include`	string	Optional	statistics (Default), data, oder statistics,data

Request

curl "https://api.centra.dbpg.io/v1/avirach/history?h3_index=861f8d0f7ffffff&month=12&day=31&hour=10" \
  -H "Authorization: Bearer sk-live-your_api_key"

Response

{
  "h3_index": "861f8d0f7ffffff",
  "query": { "month": 12, "day": 31, "hour": 10, "years": 26 },
  "count": 26,
  "statistics": {
    "temperature_2m": {
      "unit": "°C",
      "min": -4.8,
      "max": 12.9,
      "mean": 2.62,
      "median": 1.6,
      "stddev": 4.34,
      "p10": -1.95,
      "p90": 8.6,
      "count": 26
    }
  }
}

H3 Geo-Indexing

Alle H3-Indizes werden automatisch auf Resolution 6 (~36 km²) normalisiert. Bei Normalisierung enthält die Response zusätzlich und .

Kennzeichnung

Wetterdaten u. a. bereitgestellt durch Open-Meteo