Climate data

Using the Meteum API, you can view the average climate data for the last 10 years. The data can be detailed by days, weeks or months.

To get climate data for the selected geographical point, it is necessary to specify the climate object in the request when calling the GraphQL method weatherByPoint:

{
  weatherByPoint(request: { lat: 53.718706, lon: 44.453126 }) {
    climate {
      ...
    }
  }
}

Inside the climate object, you must specify one of the objects to drill down the request with optional parameters limit and offset:

  • `days' – by days.
  • `weeks' – by week.
  • `months' – by month.

The fields to be received in the response are specified inside these objects. By default, data is returned for the entire year from its beginning: the first day, week or month. Using the limit and offset parameters, you can set the desired period:

  • limit defines the number of records to be returned.
  • offset determines how many records to skip since the beginning of the year.

Example of a request for obtaining average climatic data at a point for the period from January 1st to January 10th:



{
  weatherByPoint(request: { lat: 53.718706, lon: 44.453126 }) {
    climate {
      days(limit: 10) {
        maxDayTemperature
        humidity
        pressure
        maxWindSpeed
        minWindSpeed
        prec
        precType
        precStrength
      }
    }
  }
}
Response
{
  "data": {
    "weatherByPoint": {
      "climate": {
        "days": [
          {
            "maxDayTemperature": -5,
            "humidity": 89,
            "pressure": 736,
            "maxWindSpeed": 6,
            "minWindSpeed": 3,
            "prec": 2.2,
            "precType": "NO_TYPE",
            "precStrength": "ZERO"
          },
          {
            "maxDayTemperature": -5,
            "humidity": 91,
            "pressure": 735,
            "maxWindSpeed": 6.5,
            "minWindSpeed": 3.7,
            "prec": 2.5,
            "precType": "SNOW",
            "precStrength": "AVERAGE"
          },
          {
            "maxDayTemperature": -6,
            "humidity": 88,
            "pressure": 734,
            "maxWindSpeed": 6.3,
            "minWindSpeed": 3.5,
            "prec": 2,
            "precType": "SNOW",
            "precStrength": "AVERAGE"
          },
          {
            "maxDayTemperature": -8,
            "humidity": 87,
            "pressure": 734,
            "maxWindSpeed": 5.8,
            "minWindSpeed": 3.5,
            "prec": 2.2,
            "precType": "SNOW",
            "precStrength": "AVERAGE"
          },
          {
            "maxDayTemperature": -8,
            "humidity": 88,
            "pressure": 736,
            "maxWindSpeed": 5.5,
            "minWindSpeed": 3.4,
            "prec": 1.8,
            "precType": "SNOW",
            "precStrength": "AVERAGE"
          },
          {
            "maxDayTemperature": -9,
            "humidity": 87,
            "pressure": 739,
            "maxWindSpeed": 5.4,
            "minWindSpeed": 3.5,
            "prec": 1.2,
            "precType": "NO_TYPE",
            "precStrength": "ZERO"
          },
          {
            "maxDayTemperature": -10,
            "humidity": 87,
            "pressure": 741,
            "maxWindSpeed": 5.5,
            "minWindSpeed": 3.7,
            "prec": 1.7,
            "precType": "NO_TYPE",
            "precStrength": "ZERO"
          },
          {
            "maxDayTemperature": -10,
            "humidity": 87,
            "pressure": 741,
            "maxWindSpeed": 6.5,
            "minWindSpeed": 4,
            "prec": 1.7,
            "precType": "NO_TYPE",
            "precStrength": "ZERO"
          },
          {
            "maxDayTemperature": -8,
            "humidity": 88,
            "pressure": 738,
            "maxWindSpeed": 5,
            "minWindSpeed": 3,
            "prec": 1.8,
            "precType": "SNOW",
            "precStrength": "AVERAGE"
          },
          {
            "maxDayTemperature": -10,
            "humidity": 88,
            "pressure": 736,
            "maxWindSpeed": 5,
            "minWindSpeed": 2.9,
            "prec": 0.6,
            "precType": "NO_TYPE",
            "precStrength": "ZERO"
          }
        ]
      }
    }
  }
}

Example of a request for obtaining average climatic data at a point for the period from January 11th to January 20th:



{
  weatherByPoint(request: { lat: 53.718706, lon: 44.453126 }) {
    climate {
      days(limit: 10, offset: 10) {
        maxDayTemperature
        humidity
        pressure
        maxWindSpeed
        minWindSpeed
        prec
        precType
        precStrength
      }
    }
  }
}
Response
{
  "data": {
    "weatherByPoint": {
      "climate": {
        "days": [
          {
            "maxDayTemperature": -10,
            "humidity": 86,
            "pressure": 736,
            "maxWindSpeed": 5.4,
            "minWindSpeed": 3.4,
            "prec": 1.7,
            "precType": "NO_TYPE",
            "precStrength": "ZERO"
          },
          {
            "maxDayTemperature": -7,
            "humidity": 88,
            "pressure": 736,
            "maxWindSpeed": 6.5,
            "minWindSpeed": 3.5,
            "prec": 1,
            "precType": "NO_TYPE",
            "precStrength": "ZERO"
          },
          {
            "maxDayTemperature": -5,
            "humidity": 92,
            "pressure": 732,
            "maxWindSpeed": 7.5,
            "minWindSpeed": 4.5,
            "prec": 2.7,
            "precType": "SNOW",
            "precStrength": "AVERAGE"
          },
          {
            "maxDayTemperature": -4,
            "humidity": 93,
            "pressure": 734,
            "maxWindSpeed": 6.5,
            "minWindSpeed": 4.4,
            "prec": 1.6,
            "precType": "SNOW",
            "precStrength": "AVERAGE"
          },
          {
            "maxDayTemperature": -5,
            "humidity": 92,
            "pressure": 737,
            "maxWindSpeed": 5.5,
            "minWindSpeed": 3.2,
            "prec": 1.6,
            "precType": "NO_TYPE",
            "precStrength": "ZERO"
          },
          {
            "maxDayTemperature": -6,
            "humidity": 92,
            "pressure": 739,
            "maxWindSpeed": 5,
            "minWindSpeed": 2.5,
            "prec": 2.7,
            "precType": "SNOW",
            "precStrength": "AVERAGE"
          },
          {
            "maxDayTemperature": -7,
            "humidity": 89,
            "pressure": 741,
            "maxWindSpeed": 5.5,
            "minWindSpeed": 2.9,
            "prec": 1.7,
            "precType": "SNOW",
            "precStrength": "AVERAGE"
          },
          {
            "maxDayTemperature": -8,
            "humidity": 91,
            "pressure": 742,
            "maxWindSpeed": 5.4,
            "minWindSpeed": 3,
            "prec": 1.8,
            "precType": "SNOW",
            "precStrength": "AVERAGE"
          },
          {
            "maxDayTemperature": -9,
            "humidity": 89,
            "pressure": 740,
            "maxWindSpeed": 4.5,
            "minWindSpeed": 3,
            "prec": 1,
            "precType": "NO_TYPE",
            "precStrength": "ZERO"
          },
          {
            "maxDayTemperature": -8,
            "humidity": 88,
            "pressure": 739,
            "maxWindSpeed": 5,
            "minWindSpeed": 3.2,
            "prec": 1.2,
            "precType": "NO_TYPE",
            "precStrength": "ZERO"
          }
        ]
      }
    }
  }
}

To get climate data for a selected geographical point, you need to select an aggregation interval: days, weeks or months. By default, data is returned for the entire year from its beginning: the first day, week or month.

Example of a request to get average climate data at a certain point for the whole year, aggregated by day:

curl 'https://api.meteum.ai/v1/longterm?lat=52.37125&lon=4.89388' -H 'X-Meteum-API-Key: <Key>'
Response
[
  {
    "time": 1,
    "cl": 79,
    "feels_like": -1,
    "h": 0.83,
    "is_cloudy": false,
    "is_overcast": true,
    "is_prec": true,
    "is_rain": true,
    "is_snow": false,
    "is_sunny": false,
    "max_day_t": 5,
    "min_night_t": 4,
    "p": 762,
    "p_pa": 1015,
    "prec": 4.4,
    "prec_chance": 0.6,
    "wind_dir": "sw",
    "wa": 214,
    "min_ws": 4.3,
    "max_ws": 9.1,
    "condition": "rain",
    "icon": "ovc_ra"
  },
  {
    "time": 2,
    "cl": 59,
    "feels_like": 0,
    "h": 0.77,
    "is_cloudy": false,
    "is_overcast": false,
    "is_prec": false,
    "is_rain": false,
    "is_snow": false,
    "is_sunny": true,
    "max_day_t": 6,
    "min_night_t": 5,
    "p": 763,
    "p_pa": 1017,
    "prec": 1.6,
    "prec_chance": 0.6,
    "wind_dir": "sw",
    "wa": 226,
    "min_ws": 4.8,
    "max_ws": 7.9,
    "condition": "clear",
    "icon": "skc_d"
  },
  {
    "time": 3,
    "cl": 82,
    "feels_like": -1,
    "h": 0.8,
    "is_cloudy": false,
    "is_overcast": true,
    "is_prec": true,
    "is_rain": true,
    "is_snow": false,
    "is_sunny": false,
    "max_day_t": 6,
    "min_night_t": 4,
    "p": 761,
    "p_pa": 1014,
    "prec": 3.4,
    "prec_chance": 0.6,
    "wind_dir": "sw",
    "wa": 211,
    "min_ws": 5.3,
    "max_ws": 9,
    "condition": "rain",
    "icon": "ovc_ra"
  },
  {
    "time": 4,
    "cl": 84,
    "feels_like": -1,
    "h": 0.8,
    "is_cloudy": false,
    "is_overcast": false,
    "is_prec": false,
    "is_rain": false,
    "is_snow": false,
    "is_sunny": true,
    "max_day_t": 6,
    "min_night_t": 5,
    "p": 760,
    "p_pa": 1013,
    "prec": 2.5,
    "prec_chance": 0.4,
    "wind_dir": "sw",
    "wa": 237,
    "min_ws": 5.9,
    "max_ws": 9,
    "condition": "clear",
    "icon": "skc_d"
  },
  {
    "time": 5,
    "cl": 74,
    "feels_like": -2,
    "h": 0.81,
    "is_cloudy": false,
    "is_overcast": true,
    "is_prec": true,
    "is_rain": true,
    "is_snow": false,
    "is_sunny": false,
    "max_day_t": 5,
    "min_night_t": 5,
    "p": 759,
    "p_pa": 1011,
    "prec": 1.7,
    "prec_chance": 0.6,
    "wind_dir": "sw",
    "wa": 219,
    "min_ws": 5.5,
    "max_ws": 8.8,
    "condition": "rain",
    "icon": "ovc_ra"
  }
  // ...
]

Example of a request to get average climate data at a certain point for the whole year, aggregated by month:

curl 'https://api.meteum.ai/v1/climate/by-weak?lat=52.37125&lon=4.89388' -H 'X-Meteum-API-Key: <Key>'
Response
[
  {
    "time": 1,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 5,
    "max_day_t": 6,
    "min_night_t": 3,
    "h": 0.81,
    "p": 761,
    "p_pa": 1014,
    "prec": 78.1,
    "overcast_days": 7,
    "rainy_days": 20,
    "sunny_days": 4,
    "wind_dir": "sw",
    "wa": 214,
    "ws": 6.5
  },
  {
    "time": 2,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 5,
    "max_day_t": 7,
    "min_night_t": 2,
    "h": 0.8,
    "p": 761,
    "p_pa": 1014,
    "prec": 58.2,
    "overcast_days": 8,
    "rainy_days": 15,
    "sunny_days": 5,
    "wind_dir": "sw",
    "wa": 213,
    "ws": 6.1
  },
  {
    "time": 3,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 8,
    "max_day_t": 11,
    "min_night_t": 4,
    "h": 0.75,
    "p": 762,
    "p_pa": 1015,
    "prec": 44.7,
    "overcast_days": 17,
    "rainy_days": 8,
    "sunny_days": 6,
    "wind_dir": "sw",
    "wa": 243,
    "ws": 5.3
  },
  {
    "time": 4,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 12,
    "max_day_t": 15,
    "min_night_t": 7,
    "h": 0.7,
    "p": 762,
    "p_pa": 1015,
    "prec": 30.2,
    "overcast_days": 16,
    "rainy_days": 5,
    "sunny_days": 9,
    "wind_dir": "w",
    "wa": 286,
    "ws": 4.4
  },
  {
    "time": 5,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 15,
    "max_day_t": 17,
    "min_night_t": 8,
    "h": 0.69,
    "p": 762,
    "p_pa": 1015,
    "prec": 48.9,
    "overcast_days": 14,
    "rainy_days": 9,
    "sunny_days": 8,
    "wind_dir": "nw",
    "wa": 312,
    "ws": 4.5
  },
  {
    "time": 6,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 18,
    "max_day_t": 20,
    "min_night_t": 13,
    "h": 0.69,
    "p": 762,
    "p_pa": 1015,
    "prec": 56.7,
    "overcast_days": 12,
    "rainy_days": 10,
    "sunny_days": 8,
    "wind_dir": "w",
    "wa": 284,
    "ws": 4.3
  },
  {
    "time": 7,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 20,
    "max_day_t": 22,
    "min_night_t": 15,
    "h": 0.69,
    "p": 761,
    "p_pa": 1014,
    "prec": 78.6,
    "overcast_days": 6,
    "rainy_days": 16,
    "sunny_days": 9,
    "wind_dir": "w",
    "wa": 254,
    "ws": 4.1
  },
  {
    "time": 8,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 20,
    "max_day_t": 22,
    "min_night_t": 16,
    "h": 0.7,
    "p": 761,
    "p_pa": 1014,
    "prec": 78,
    "overcast_days": 7,
    "rainy_days": 16,
    "sunny_days": 8,
    "wind_dir": "sw",
    "wa": 235,
    "ws": 4.3
  },
  {
    "time": 9,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 17,
    "max_day_t": 19,
    "min_night_t": 13,
    "h": 0.74,
    "p": 762,
    "p_pa": 1015,
    "prec": 70.9,
    "overcast_days": 5,
    "rainy_days": 17,
    "sunny_days": 8,
    "wind_dir": "sw",
    "wa": 225,
    "ws": 4.5
  },
  {
    "time": 10,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 13,
    "max_day_t": 16,
    "min_night_t": 10,
    "h": 0.77,
    "p": 762,
    "p_pa": 1015,
    "prec": 77,
    "overcast_days": 9,
    "rainy_days": 17,
    "sunny_days": 5,
    "wind_dir": "sw",
    "wa": 209,
    "ws": 5.4
  },
  {
    "time": 11,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 9,
    "max_day_t": 12,
    "min_night_t": 4,
    "h": 0.81,
    "p": 759,
    "p_pa": 1011,
    "prec": 80.3,
    "overcast_days": 4,
    "rainy_days": 24,
    "sunny_days": 2,
    "wind_dir": "sw",
    "wa": 212,
    "ws": 6
  },
  {
    "time": 12,
    "lat": 52.37125,
    "lon": 4.89388,
    "avg_day_t": 6,
    "max_day_t": 8,
    "min_night_t": 4,
    "h": 0.81,
    "p": 761,
    "p_pa": 1014,
    "prec": 72.5,
    "overcast_days": 10,
    "rainy_days": 18,
    "sunny_days": 3,
    "wind_dir": "sw",
    "wa": 225,
    "ws": 6.6
  }
]