# Climate Normals
Climate normals are long-term averages of historical weather observations. Usually, these means are calculated over a period of 30 years (“reference period“). However, any other time series of sufficient length can be used to calculate climate normals.
Climate normals represent the typical monthly weather at a given location. The averages can also be used for calculating anomalies of current weather and climate conditions.
# Endpoint
Climate normals are provided through this endpoint:
GET https://api.meteostat.net/v2/point/climate
# Parameters
In order to query data for any location you’ll need to specify the lat
and lon
parameters. You will probably also want to add the alt
parameter to your request to make the output more precise. If you do not set the alt
parameter, Meteostat will detect the elevation using its own elevation model.
Parameter | Description | Type | Required | Default |
---|---|---|---|---|
lat | The latitude of the geographic location | Float | Yes | undefined |
lon | The longitude of the geographic location | Float | Yes | undefined |
alt | The elevation of the geographic location | Integer | No | 0 |
# Response
The response body includes the following properties.
Parameter | Description | Type |
---|---|---|
month | The integer number of the month (1 to 12) | Integer |
tavg | The mean temperature in °C | Float |
tmin | The average minimum temperature in °C | Float |
tmax | The average maximum temperature in °C | Float |
prcp | The average total precipitation in mm | Integer |
pres | The average sea-level air pressure in hPa | Float |
tsun | The average sunshine duration in hours (h) | Integer |
More information about the data format is available here.
Additionally, the meta
object includes the start
and end
year of the climate averages.
# Example
The following example requires the cURL command-line interface. Alternatively, you can use an API client like Postman.
curl --header "x-api-key: {key}" "https://api.meteostat.net/v2/point/climate?lat=-33.87&lon=151.21&alt=58"
Please replace {key}
with your personal API key.
# Data Response
The data output returns one object per hour. Have a look at this example:
{
"meta": {
"source": "National Oceanic and Atmospheric Administration, Deutscher Wetterdienst",
"start": 1961,
"end": 1990,
"exec_time": 0.015,
"generated": "2020-06-14 10:15:40"
},
"data": [
{
"month": 1,
"tavg": 0.7,
"tmin": null,
"tmax": null,
"prcp": 43.8,
"pres": 1018,
"tsun": 41
},
{
"month": 2,
"tavg": 1.8,
"tmin": null,
"tmax": null,
"prcp": 39.8,
"pres": 1017.5,
"tsun": 75
},
{
"month": 3,
"tavg": 5.2,
"tmin": null,
"tmax": null,
"prcp": 51.1,
"pres": 1014.9,
"tsun": 116
},
{
"month": 4,
"tavg": 9.2,
"tmin": null,
"tmax": null,
"prcp": 51.5,
"pres": 1014.2,
"tsun": 163
},
{
"month": 5,
"tavg": 13.7,
"tmin": null,
"tmax": null,
"prcp": 61.3,
"pres": 1014.6,
"tsun": 207
},
{
"month": 6,
"tavg": 17.1,
"tmin": null,
"tmax": null,
"prcp": 70.2,
"pres": 1015.6,
"tsun": 209
},
{
"month": 7,
"tavg": 18.9,
"tmin": null,
"tmax": null,
"prcp": 63,
"pres": 1016.6,
"tsun": 225
},
{
"month": 8,
"tavg": 18.3,
"tmin": null,
"tmax": null,
"prcp": 64.8,
"pres": 1016.1,
"tsun": 204
},
{
"month": 9,
"tavg": 14.8,
"tmin": null,
"tmax": null,
"prcp": 48.3,
"pres": 1018.3,
"tsun": 158
},
{
"month": 10,
"tavg": 9.8,
"tmin": null,
"tmax": null,
"prcp": 50.5,
"pres": 1017.6,
"tsun": 103
},
{
"month": 11,
"tavg": 4.7,
"tmin": null,
"tmax": null,
"prcp": 59.4,
"pres": 1018.3,
"tsun": 48
},
{
"month": 12,
"tavg": 1.8,
"tmin": null,
"tmax": null,
"prcp": 54.1,
"pres": 1016.9,
"tsun": 39
}
]
}
← Daily Data JavaScript →