Basic Weather API Providers
Weather Forecast with data aggregation
Weather Forecast API with data aggregation provides weather forecasts for 3 days at a 3-hour interval for your area of interest.
It’s based on HTTP requests sent to the server, the response format is JSON.
HTTP Request
POST https://api-connect.eos.com/api/forecast/weather/forecast/?api_key=<your api key>
Request Parameters
| Parameter | Value | Description |
|---|---|---|
| geometry | "modify" | The GeoJSON representation of a geometry describing the AOI. |
HTTP Response
When you correctly create the Weather Forecast HTTP request, you will get the next response to contain today's weather, tomorrow's weather and the day after tomorrow's weather
[
{
"Date": "string",
"Temp_air_min": "number",
"Temp_air_max": "number",
"Temp_land_min": "number",
"Temp_land_max": "number",
"Rel_humidity": "number",
"Snow_depth": "number",
"Rain": {
"02h": "number",
"05h": "number",
"08h": "number",
"11h": "number",
"14h": "number",
"17h": "number",
"20h": "number",
"23h": "number"
},
"Windspeed": {
"02h": "number",
"05h": "number",
"08h": "number",
"11h": "number",
"14h": "number",
"17h": "number",
"20h": "number",
"23h": "number"
}
},
{.......},
{.......}
]
Response Parameters
| Parameter | Description |
|---|---|
| Date | Forecast date, string |
| Temp_air_min | Min temperature at 2m above ground, number |
| Temp_air_max | Max temperature at 2m above ground, number |
| Temp_land_min | Min ground temperature , number |
| Temp_land_max | Max ground temperature , number |
| Rel_humidity | Avg relative humidity at 2m above ground, number |
| Snow_depth | Snow depth, number |
| Rain | Total precipitation (accumulated since model start), splited by 3 hours, object |
| Windspeed | Wind at 10m above ground, splited by 3 hours, object |
Example with Demo field
HTTP Request
curl -i -X POST 'https://api-connect.eos.com/api/forecast/weather/forecast/?api_key=<your api key>'
-H 'Content-Type: application/json'
-d '{
"geometry":{
"type":"Polygon",
"coordinates":[
[
[
29.659867,
49.596693
],
[
29.658108,
49.591491
],
[
29.667463,
49.590072
],
[
29.669137,
49.595135
],
[
29.659867,
49.596693
]
]
]
}
}'
HTTP Response
[
{
"Date": "2020-06-19",
"Temp_air_min": 17.6538940429688,
"Temp_air_max": 29.3750244140625,
"Temp_land_min": 17.5554443359375,
"Temp_land_max": 25.9509216308594,
"Rel_humidity": 64.6644866466522,
"Snow_depth": 0.0,
"Rain": {
"02h": 0.0,
"05h": 0.12890625,
"08h": 0.0,
"11h": 0.001953125,
"14h": 0.0,
"17h": 0.0,
"20h": 0.734375,
"23h": 1.03125
},
"Windspeed": {
"02h": 1.23166459761033,
"05h": 1.96454827331419,
"08h": 2.94955841432136,
"11h": 3.74045225487876,
"14h": 3.64391127324307,
"17h": 2.85368153766911,
"20h": 2.74912081590915,
"23h": 2.49867989706547
}
},
{
"Date": "2020-06-20",
"Temp_air_min": 18.5734497070313,
"Temp_air_max": 27.386865234375,
"Temp_land_min": 19.1393981933594,
"Temp_land_max": 25.3498474121094,
"Rel_humidity": 68.5226661364238,
"Snow_depth": 0.0,
"Rain": {
"02h": 0.25,
"05h": 0.00390625,
"08h": 0.0,
"11h": 0.046875,
"14h": 0.1875,
"17h": 0.0,
"20h": 0.0078125,
"23h": 0.0078125
},
"Windspeed": {
"02h": 2.61927615100219,
"05h": 3.88797470607151,
"08h": 5.02138262507789,
"11h": 5.94701097119733,
"14h": 6.32063930414637,
"17h": 4.01887715557214,
"20h": 2.4678575021484,
"23h": 2.84367868676212
}
},
{
"Date": "2020-06-21",
"Temp_air_min": 17.8347717285156,
"Temp_air_max": 27.2004638671875,
"Temp_land_min": 18.6470581054688,
"Temp_land_max": 25.140283203125,
"Rel_humidity": 75.9185802141825,
"Snow_depth": 0.0,
"Rain": {
"02h": 0.0,
"05h": 0.0,
"08h": 0.0,
"11h": 0.0546875,
"14h": 1.125,
"17h": 1.0390625,
"20h": 0.0,
"23h": 0.0
},
"Windspeed": {
"02h": 2.50855536412368,
"05h": 2.20294509692318,
"08h": 3.87850895887888,
"11h": 4.93255055992879,
"14h": 4.06098356725482,
"17h": 3.09260707926948,
"20h": 1.37359397286952,
"23h": 1.09101959658345
}
}
]
Weather Forecast without data aggregation
Weather Forecast API without data aggregation provides weather forecasts for 3 days at a 1-hour interval for your area of interest.
It’s based on HTTP requests sent to the server, the response format is JSON.
The area of interest is set via GeoJSON notation in the body of the request, or via an area identifier received from Geometry API.
HTTP Request
POST https://api-connect.eos.com/api/forecast/weather/forecast/world/?api_key=<your api key>
Request Parameters
| Parameter | Value | Description |
|---|---|---|
| geometry | "modify" | The GeoJSON representation of a geometry describing the AOI. |
| date_from | Start date | |
| date_to | End date |
HTTP Response
When you correctly create the Weather Forecast HTTP request, you will get the next response to contain today's weather, tomorrow's weather and the day after tomorrow's weather
[
{
"date&time": {
"t_2m__min": number,
"t_2m__max": number,
"asob_s__sum": number,
"tot_prec__sum": number,
"h_snow__sum": number,
"relhum_2m__avg": number,
"u_10m__avg": number,
"v_10m__avg": number,
"w_speed__avg": number,
"clct__avg": number,
"td_2m__avg": number,
"t_so__min": number,
"t_so__max": number,
"ps__avg": number,
"w_dir__avg": number,
"ww": number,
"ww_human": "cloudy/overcast"
}
},
{
"date&time": {
"t_2m__min": number,
"t_2m__max": number,
"asob_s__sum": number,
"tot_prec__sum": number,
"h_snow__sum": number,
"relhum_2m__avg": number,
"u_10m__avg": number,
"v_10m__avg": number,
"w_speed__avg": number,
"clct__avg": number,
"td_2m__avg": number,
"t_so__min": number,
"t_so__max": number,
"ps__avg": number,
"w_dir__avg": number,
"ww": number,
"ww_human": "cloudy/overcast"
}
},
]
Response parameters
| Parameter | Description |
|---|---|
| t_2m__min | temperature 2m above the ground (minimum) (K) |
| t_2m__max | temperature 2m above the ground (maximum) (K), |
| asob_s__sum | near-surface shortwave radiative flux (W/m^2) |
| tot_prec__sum | precipitation (rain, snow) (kg/m^2) |
| h_snow__sum | snow thickness (m) |
| relhum_2m__avg | humidity at a height of 2m (%) |
| u_10m__avg | east-west component of wind (m/s) |
| v_10m__avg | north-south component of wind (m/s) |
| w_speed__avg | average wind (m/s) |
| clct__avg | cloud cover (%) |
| td_2m__avg | dew point temperature at a height of 2m (K) |
| t_so__min | temperature of the earth at a depth of 6 cm (min) (K) |
| t_so__max | temperature of the earth at a depth of 6 cm (max) (K) |
| ps__avg | pressure (Pa) |
| w_dir__avg | wind direction (deg) |
| ww | weather type |
| ww_human | human-readable weather type |
Example with Demo field
HTTP Request
curl --location --request POST 'https://api-connect.eos.com/api/forecast/weather/forecast/world/?api_key=<your api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"geometry":{
"type":"Polygon",
"coordinates": [
[
[
29.659867,
49.596693
],
[
29.658108,
49.591491
],
[
29.667463,
49.590072
],
[
29.669137,
49.595135
],
[
29.659867,
49.596693
]
]
]
},
"date_from": "2020-06-20T00:00",
"date_to": "2020-06-22T00:00"
}'
HTTP Response
[
{
"2020-06-20T00:00:00": {
"t_2m__min": 292.0,
"t_2m__max": 292.5,
"asob_s__sum": 248.5,
"tot_prec__sum": 2.2,
"h_snow__sum": 0.0,
"relhum_2m__avg": 83.5,
"u_10m__avg": -0.0,
"v_10m__avg": -1.7,
"w_speed__avg": 1.7,
"clct__avg": 99.4,
"td_2m__avg": 289.4,
"t_so__min": 293.0,
"t_so__max": 293.2,
"ps__avg": 98384.4,
"w_dir__avg": 180.2,
"ww": 3,
"ww_human": "cloudy/overcast"
}
},
{
"2020-06-20T01:00:00": {
"t_2m__min": 291.7,
"t_2m__max": 292.3,
"asob_s__sum": 238.5,
"tot_prec__sum": 0.0,
"h_snow__sum": 0.0,
"relhum_2m__avg": 83.3,
"u_10m__avg": -0.1,
"v_10m__avg": -1.9,
"w_speed__avg": 1.9,
"clct__avg": 100.0,
"td_2m__avg": 289.1,
"t_so__min": 292.6,
"t_so__max": 292.8,
"ps__avg": 98341.9,
"w_dir__avg": 183.5,
"ww": 3,
"ww_human": "cloudy/overcast"
}
},
{...............},
{
"2020-06-22T00:00:00": {
"t_2m__min": 290.8,
"t_2m__max": 290.8,
"asob_s__sum": 221.7,
"tot_prec__sum": 0.0,
"h_snow__sum": 0.0,
"relhum_2m__avg": 95.2,
"u_10m__avg": 0.4,
"v_10m__avg": -1.0,
"w_speed__avg": 1.0,
"clct__avg": 100.0,
"td_2m__avg": 290.0,
"t_so__min": 291.9,
"t_so__max": 291.9,
"ps__avg": 98174.4,
"w_dir__avg": 157.0,
"ww": 3,
"ww_human": "cloudy/overcast"
}
}
]
Historical weather
Historical weather API provides information about the weather data in the date period for your area of interest.
It’s based on HTTP requests sent to the server, the response format is JSON.
The area of interest is set via GeoJSON notation in the body of the request, or via an area identifier received from Geometry API.
HTTP Request
POST https://api-connect.eos.com/api/cz/backend/forecast-history/?api_key=<your api key>
Request Parameters
| Parameter | Value | Description |
|---|---|---|
| geometry | "modify" | The GeoJSON representation of a geometry describing the AOI. |
| start_date | Period start date for selecting data. Format YYYY-MM-DD | |
| end_date | Period end date for selecting data. Format YYYY-MM-DD |
HTTP Response
When you correctly create the Historical weather HTTP request, you will get the next response to contain today's weather, tomorrow's weather and the day after tomorrow's weather
[
{
"temperature_min": number,
"temperature_max": number,
"vapour_pressure": number,
"wind_speed": number,
"rainfall": number,
"show_depth": number,
"hardening_index": number,
"temp_critical": number,
"date": "string"
},
{...........},
{
"temperature_min": number,
"temperature_max": number,
"vapour_pressure": number,
"wind_speed": number,
"rainfall": number,
"show_depth": number,
"hardening_index": number,
"temp_critical": number,
"date": "string"
}
]
Response parameters
| Parameter | Description |
|---|---|
| temperature_min | Min temperature at 2m above ground, number |
| temperature_max | Max temperature at 2m above ground, number |
| vapour_pressure | Vapor pressure |
| wind_speed | Wind at 10m above ground |
| rainfall | Total precipitation |
| show_depth | Snow depth |
| hardening_index | The index of death of winter crops |
| temp_critical | The temperature at which the winter crop dies |
| date | Date |
Example with Demo field
HTTP Request
curl --location --request POST 'https://api-connect.eos.com/api/cz/backend/forecast-history/?api_key=<your api key>' \
--header 'Content-Type: application/json' \
--data-raw '{
"geometry":{
"type":"Polygon",
"coordinates": [
[
[
29.659867,
49.596693
],
[
29.658108,
49.591491
],
[
29.667463,
49.590072
],
[
29.669137,
49.595135
],
[
29.659867,
49.596693
]
]
]
},
"start_date": "2020-04-20",
"end_date": "2020-04-22"
}'
HTTP Response
[
{
"temperature_min": "0.1",
"temperature_max": "10.1",
"vapour_pressure": "4.6",
"wind_speed": "4.2",
"rainfall": "0.0",
"show_depth": "0.0",
"hardening_index": null,
"temp_critical": null,
"date": "2020-04-20"
},
{
"temperature_min": "2.8",
"temperature_max": "9.7",
"vapour_pressure": "4.5",
"wind_speed": "3.2",
"rainfall": "0.0",
"show_depth": "0.0",
"hardening_index": null,
"temp_critical": null,
"date": "2020-04-21"
},
{
"temperature_min": "2.2",
"temperature_max": "14.8",
"vapour_pressure": "5.0",
"wind_speed": "3.2",
"rainfall": "0.0",
"show_depth": "0.0",
"hardening_index": null,
"temp_critical": null,
"date": "2020-04-22"
}
]