weather_get_conditions
Fetch weather conditions for a location and date range. Supports both historical data (from 1940) and forecasts (up to 16 days ahead).
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
latitude | number | Yes | — | Latitude (-90 to 90) |
longitude | number | Yes | — | Longitude (-180 to 180) |
startDate | string | Yes | — | Start date (YYYY-MM-DD) |
endDate | string | Yes | — | End date (YYYY-MM-DD) |
include | string[] | No | ["gdd", "precipitation", "temperature"] | Data to include: gdd, precipitation, temperature, soil_temperature |
Constraints:
- Maximum date range: 2 years (730 days)
endDatemust be afterstartDate- Soil temperature is only available for recent dates
Usage
Growing Season Weather
{
"latitude": 42.0,
"longitude": -93.6,
"startDate": "2025-05-01",
"endDate": "2025-09-30",
"include": ["gdd", "precipitation", "temperature"]
}Current Forecast
{
"latitude": 42.0,
"longitude": -93.6,
"startDate": "2025-03-16",
"endDate": "2025-03-30"
}Response
{
"error": false,
"data": {
"location": {
"latitude": 42.0,
"longitude": -93.6,
"timezone": "America/Chicago"
},
"dateRange": {
"startDate": "2025-05-01",
"endDate": "2025-09-30"
},
"daily": {
"dates": ["2025-05-01", "2025-05-02", "..."],
"temperature": {
"high_celsius": [22.5, 23.1],
"high_fahrenheit": [72.5, 73.6],
"low_celsius": [10.2, 11.0],
"low_fahrenheit": [50.4, 51.8],
"average_celsius": [16.3, 17.0],
"average_fahrenheit": [61.4, 62.7]
},
"precipitation": {
"total_mm": [0, 5.2, 0, 2.1],
"total_inches": [0, 0.2, 0, 0.08],
"rain_days": 65
},
"gdd": {
"base_temp_fahrenheit": 50,
"daily": [8.5, 8.7, 8.9],
"accumulated": [8.5, 17.2, 26.1]
}
}
}
}GDD (Growing Degree Days)
GDD is calculated using base 50F for corn:
GDD = max(0, (high + low) / 2 - base_temp)
The accumulated array gives cumulative GDD from the start date — useful for tracking crop development stages.
Use Cases
| Scenario | Parameters |
|---|---|
| Check planting conditions | Temperature + soil_temperature for next 7 days |
| Track crop development | GDD accumulated over growing season |
| Irrigation decisions | Precipitation totals for past 14 days |
| Frost risk assessment | Temperature lows for forecast period |
| Season comparison | Same date range across multiple years |
Data Source
Weather data is sourced from Open-Meteo, a free public weather API with global coverage.
Errors
| Code | Cause |
|---|---|
INVALID_PARAM_VALUE | Invalid coordinates, date format, or date range >730 days |
PROVIDER_ERROR | Open-Meteo API error |
| Parameter | Type | Required | Description |
|---|---|---|---|
| latitude | number | Required | Latitude of the location (-90 to 90) |
| longitude | number | Required | Longitude of the location (-180 to 180) |
| startDate | string | Required | Start date in ISO format (e.g., 2024-04-01) |
| endDate | string | Required | End date in ISO format (e.g., 2024-09-30) |
| include | array | Required | Data types to include: gdd (Growing Degree Days), precipitation, temperature, soil_temperature |
Try it
weather_get_conditionsSign in to try this tool
Sign in