{
"date": "2020-4-17",
"temp": 574.37,
"count": 2
},
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 call
http://history.openweathermap.org/data/2.5/history/accumulated_temperature?q={city name}&start={start}&end={end}&threshold={threshold}&appid={API key}
Parameters | ||
---|---|---|
q |
required |
City name, state code and country code divided by comma, use ISO 3166 country codes.
You can specify the parameter not only in English. In this case, the API response should be returned in the same language as the language of requested location name if the location is in our predefined list of more than 200,000 locations. |
start |
required | Start date (unix time, UTC time zone), e.g. start=1586853378 |
end |
required | End date (unix time, UTC time zone), e.g. end=1589445367 |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
threshold |
optional | All values smaller than indicated value are not taken into account |
Example of API call
http://history.openweathermap.org/data/2.5/history/accumulated_temperature?q=London,GB&start=1586853378&end=1589445367&threshold=284&appid={API key}
By city ID
API call
http://history.openweathermap.org/data/2.5/history/accumulated_temperature?id={city ID}&start={start}&end={end}&threshold={threshold}&appid={API key}
Parameters | ||
---|---|---|
id |
required | City ID. The list of city IDs 'city.list.json.gz' can be downloaded here. |
start |
required | Start date (unix time, UTC time zone), e.g. start=1586853378 |
end |
required | End date (unix time, UTC time zone), e.g. end=1589445367 |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
threshold |
optional | All values smaller than indicated value are not taken into account |
Example of API call
http://history.openweathermap.org/data/2.5/history/accumulated_temperature?id=2885679&start=1586853378&end=1589445367&threshold=284&appid={API key}
By geographic coordinates
API call
http://history.openweathermap.org/data/2.5/history/accumulated_temperature?lat={lat}&lon={lon}&start={start}&end={end}&threshold={threshold}&appid={API key}
Parameters | ||
---|---|---|
lat, lon |
required | Geographical coordinates (latitude, longitude) |
start |
required | Start date (unix time, UTC time zone), e.g. start=1586853378 |
end |
required | End date (unix time, UTC time zone), e.g. end=1589445367 |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
threshold |
optional | All values smaller than indicated value are not taken into account |
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={API key}
Example of API response
Fields in API response
date
Datetemp
Temperature accumulated indicator, Kelvincount
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={API key}
Parameters | ||
---|---|---|
q |
required |
City name, state code and country code divided by comma, use ISO 3166 country codes.
You can specify the parameter not only in English. In this case, the API response should be returned in the same language as the language of requested location name if the location is in our predefined list of more than 200,000 locations. |
start |
required | Start date (unix time, UTC time zone), e.g. start=1586853378 |
end |
required | End date (unix time, UTC time zone), e.g. end=1589445367 |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
Example of API call
http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?q=London,GB&start=1586853378&end=1589445367&appid={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={API key}
Parameters | ||
---|---|---|
id |
required | City ID. The list of city IDs 'city.list.json.gz' can be downloaded here. |
start |
required | Start date (unix time, UTC time zone), e.g. start=1586853378 |
end |
required | End date (unix time, UTC time zone), e.g. end=1589445367 |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
By geographic coordinates
API call
http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?lat={lat}&lon={lon}&start={start}&end={end}&appid={API key}
Parameters | ||
---|---|---|
lat, lon |
required | Geographical coordinates (latitude, longitude) |
start |
required | Start date (unix time, UTC time zone), e.g. start=1586853378 |
end |
required | End date (unix time, UTC time zone), e.g. end=1589445367 |
appid |
required | Your unique API key (you can always find it on your account page under the "API key" tab) |
Example of API call
http://history.openweathermap.org/data/2.5/history/accumulated_precipitation?lat=51.51&lon=-0.12&start=1586853378&end=1589445367&appid={API key}
Example of API response
{
"date": "2020-4-15",
"rain": 0.6,
"count": 2
},
Fields in API response
date
Daterain
Precipitation accumulation indicator, mmcount
Number of data measurements