Climate API

Klima eines Punktes: Jahressumme der Sonneneinstrahlung und Sonnenstunden, Temperatur- und Niederschlagsnormale mit Trend, Hitze- und Frosttage, Schneetage je Winter und der Dürreindex. Quelle: GeoSphere Austria, CC BY 4.0. Dasselbe Objekt steht als properties.climate im Grundstücks-Dossier.

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

Climate at a point (solar potential, normals, heat days, snow, drought)

GET /v1/climate/{coordinate}

Climate of one point from open data of GeoSphere Austria: solar potential (yearly global radiation in kWh/m2 and sunshine hours, mean of the last 3 complete years, 100 m), temperature and precipitation (normal 1991-2020, last 10 years, trend, monthly normals, 1 km), hot/summer/frost/ice days and tropical nights per year, snow days per winter and the current snow depth, and the drought index SPEI (90 and 365 days, latest value with class).

Mehr

Each section has source (dataset, cell, last day of data) and retrieved_at. Values are derived per grid cell and cached; the first request for a new cell fetches them from the source and can take 10 to 20 seconds (sections limits the work), later requests come from the cache. The same object is part of the parcel dossier (properties.climate). Outside Austria 404; 503 while the source is unavailable or rate limited. Data source: GeoSphere Austria (APOLIS, SPARTACUS, SNOWGRID-CL, WINFORE), CC BY 4.0 (attribution required).

Parameter

Name	Ort	Typ	Pflicht	Standard	Beschreibung
`coordinate`	path	string	ja	–	lon,lat or lon,lat.json
`sections`	query	string		`all`	Comma-separated sections to return (default: all)

Beispiel

curl -s -H "Authorization: Bearer YOUR_TOKEN" "https://api.mapx.at/v1/climate/15.3294,48.2272?sections=solar,snow" | jq

Beispielantwort

{
  "location": [
    15.3294,
    48.2272
  ],
  "status": "complete",
  "solar": {
    "period": "2023-2025",
    "years": 3,
    "global_radiation_kwh_m2_year": 1287.1,
    "global_radiation_horizontal_kwh_m2_year": 1219.1,
    "direct_radiation_kwh_m2_year": 911.6,
    "diffuse_radiation_kwh_m2_year": 375.5,
    "sunshine_hours_year": 2949.5,
    "relative_sunshine_pct": 60.3,
    "by_year": [
      {
        "year": 2025,
        "global_radiation_kwh_m2": 1310.8,
        "sunshine_hours": 2958.4
      }
    ],
    "source": {
      "provider": "GeoSphere Austria",
      "dataset": "apolis-v2-1d-100m",
      "name": "APOLIS solar radiation",
      "license": "CC BY 4.0",
      "resolution_m": 100,
      "cell_center": [
  …

Feld	Typ	Beschreibung
`location`	array	[longitude, latitude] (WGS84), optional height.
`status`	string	`partial`: some sections are still being loaded (parcel dossier: retry after `retry_after_s`)
`solar`	object,null	Solar potential: yearly sums, mean of the last 3 complete years (APOLIS, 100 m)
`temperature`	object,null	Air temperature (SPARTACUS, 1 km)
`precipitation`	object,null	Precipitation and sunshine (SPARTACUS, 1 km)
`temperature_extremes`	object,null	Hot, summer, frost and ice days per year, tropical nights (SPARTACUS daily data, 1 km); normal period 1991-2020 and last 10 complete years
`snow`	object,null	Snow cover (SNOWGRID-CL model, 1 km)
`drought`	object,null	Drought index SPEI (WINFORE, 1 km), latest value

Fehler (Details: Fehlerkatalog)

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

Playground

curl

Antwort erscheint hier.

Air Quality API Traffic API