Accumulated Parameters

The Accumulated Parameters include accumulated temperature and accumulated precipitation.

  • Accumulated temperature is the sum, counted in degrees, by which the actual air temperature rises above or falls below a threshold level during the chosen time period.

  • Accumulated precipitation is the sum, counted in millimeters, of daily precipitation during the chosen time period.

Accumulated temperature

Call accumulated temperature data by city ID, city name and geo coordinates.

By city name

API calls:

http://history.openweathermap.org/data/2.5/history/accumulated_temperature?q={city name}
&start={start}&end={end}&threshold={threshold}&appid={YOUR_API_KEY}

Parameters:
q city name and country code divided by comma, use ISO 3166 country codes
start start date (unix time, UTC time zone), e.g. start=1586853378
end end date (unix time, UTC time zone), e.g. end=1589445367
threshold all values smaller than indicated value are not taken into account
API key unique API key (you can always find it on the account page, on the "API key" tab)

Example of API call:
http://history.openweathermap.org/data/2.5/history/accumulated_temperature?q=London,GB
&start=1586853378&end=1589445367&threshold=284&appid={YOUR_API_KEY}

By city ID

API calls:

http://history.openweathermap.org/data/2.5/history/accumulated_temperature?id={city ID}
&start={start}&end={end}&threshold={threshold}&appid={YOUR_API_KEY}

Parameters:
ID city ID
start start date (unix time, UTC time zone), e.g. start=1586853378
end end date (unix time, UTC time zone), e.g. end=1589445367
threshold all values smaller than indicated value are not taken into account
API key unique API key (you can always find it on the account page, on the "API key" tab)

Example of API call:
http://history.openweathermap.org/data/2.5/history/accumulated_temperature?id=2885679
&start=1586853378&end=1589445367&threshold=284&appid={YOUR_API_KEY}

By geographic coordinates

API calls:

http://history.openweathermap.org/data/2.5/history/accumulated_temperature?lat={lat}
&lon={lon}&start={start}&end={end}&threshold={threshold}&appid={YOUR_API_KEY}

Parameters:
lat, lon coordinates of the location of your interest
start start date (unix time, UTC time zone), e.g. start=1586853378
end end date (unix time, UTC time zone), e.g. end=1589445367
threshold all values smaller than indicated value are not taken into account
API key unique API key (you can always find it on the account page, on the "API key" tab)

Example of API call:
http://history.openweathermap.org/data/2.5/history/accumulated_temperature?lat=51.51&lon=-0.13
&start=1586853378&end=1589445367&threshold=284&appid={YOUR_API_KEY}
Example of API response:
   {
      "date": "2020-4-17",
      "temp": 574.37,
      "count": 2
    },
Parameters:
  • date Date
  • temp Temperature accumulated indicator, Kelvin
  • count Number of data measurements

Accumulated precipitation

Call accumulated precipitation data by city ID, city name and geo coordinates.

By city name

API call:

http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?q={city name}
&start={start}&end={end}&appid={YOUR_API_KEY}

Parameters:
q city name and country code divided by comma, use ISO 3166 country codes
start start date (unix time, UTC time zone), e.g. start=1586853378
end end date (unix time, UTC time zone), e.g. end=1589445367
API key unique API key (you can always find it on the account page, on the "API key" tab)

Exmaples of API calls:
http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?q=London,GB
&start=1586853378&end=1589445367&appid={YOUR_API_KEY}

By city ID

API call:

http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?id={city ID}
&start={start}&end={end}&appid={YOUR_API_KEY}

Parameters:

ID city ID
start start date (unix time, UTC time zone), e.g. start=1586853378
end end date (unix time, UTC time zone), e.g. end=1589445367
API key unique API key (you can always find it on the account page, on the "API key" tab)

Exmaples of API calls:
http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?id=2885679
&start=1586853378&end=1589445367&appid={YOUR_API_KEY}

By geographic coordinates

API call:

http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?lat={lat}
&lon={lon}&start={start}&end={end}&appid={YOUR_API_KEY}

Parameters:

lat, lon coordinates of the location of your interest
start start date (unix time, UTC time zone), e.g. start=1586853378
end end date (unix time, UTC time zone), e.g. end=1589445367
API key unique API key (you can always find it on the account page, on the "API key" tab)

Exmaples of API calls:
http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?lat=51.51&lon=-0.12
&start=1586853378&end=1589445367&appid={YOUR_API_KEY}
Example of API response:
   {
      "date": "2020-4-15",
      "rain": 0.6,
      "count": 2
    },
Parameters:
  • date Date
  • rain Precipitation accumulation indicator, mm
  • count Number of data measurements

The threshold parameter is not used. The whole ammount of precipitation data is provided for specified period. Precipitation data is provided in mm.