Retrieve point forecasts for specific geographic coordinates. This endpoint provides detailed weather forecasts for individual locations with high temporal resolution and multiple weather variables.
This endpoint allows getting the forecast for a given coordinate or set of coordinates. This runs WindBorne's custom point forecasting model, making it more accurate than simple interpolation of the gridded output. These forecasts are at hourly resolution out to 5 days and then 6-hourly beyond that.
A model parameter can be provided to specify which weather model’s forecast to retrieve. You can find a list of available models here.
If no model is provided, the latest available model is used by default.
| Name | Description | Format |
|---|---|---|
| coordinates Required | A semi-colon separated list of latitude,longitude tuples, e.g., 37,-121;40.3,-100 | lat,lon;lat,lon;... |
| min_forecast_time Optional | An ISO 8601 date string representing the minimum forecast time to calculate point forecasts for. | YYYY-MM-DDThh:mm:ssZ |
| max_forecast_time Optional | An ISO 8601 date string representing the maximum forecast time to calculate point forecasts for. | YYYY-MM-DDThh:mm:ssZ |
| min_forecast_hour Optional | The minimum forecast hour to calculate point forecasts for. | - |
| max_forecast_hour Optional | The maximum forecast hour to calculate point forecasts for. | - |
| initialization_time Optional | An ISO 8601 date string representing the time at which the forecast was made. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used. | YYYY-MM-DDThh:mm:ssZ |
| Name | Type | Description |
|---|---|---|
| coordinates Required | string | A semi-colon separated list of latitude,longitude tuples. e.g., 37,-121;40.3,-100 |
| -mt, --min-time Optional | string | An ISO 8601 date string representing the minimum forecast time to calculate point forecasts for. Supports YYYY-MM-DDThh:mm:ssZ |
| -xt, --max-time Optional | string | An ISO 8601 date string representing the maximum forecast time to calculate point forecasts for. Supports YYYY-MM-DDThh:mm:ssZ |
| -mh, --min-hour Optional | number | The minimum forecast hour to calculate point forecasts for. |
| -xh, --max-hour Optional | number | The maximum forecast hour to calculate point forecasts for. |
| -i, --init-time Optional | string | An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used. |
| output_file Optional | string | The file to which the response will be written. If not provided, the response is printed to stdout. |
| Name | Type | Description |
|---|---|---|
| coordinates | string or array | A list of coordinates. Provide as a list of (lat, lon) tuples, e.g., [(37, -121), (40.3, -100)], or a semicolon-delimited string, e.g., 37,-121;40.3,-100 |
| min_forecast_time | string | An ISO 8601 date string representing the minimum forecast time to calculate point forecasts for. Supports YYYY-MM-DDThh:mm:ssZ |
| max_forecast_time | string | An ISO 8601 date string representing the maximum forecast time to calculate point forecasts for. Supports YYYY-MM-DDThh:mm:ssZ |
| min_forecast_hour | number | The minimum forecast hour to calculate point forecasts for. |
| max_forecast_hour | number | The maximum forecast hour to calculate point forecasts for. |
| initialization_time | string | An ISO 8601 date string representing the time at which the forecast was made. Supports YYYY-MM-DDThh:mm:ssZ. Uses only date, hour and minutes. Seconds are discarded. If omitted, the latest forecast is used. |
| output_file | string | If provided, the response data will be saved to this file. File extension determines format: .csv or .json |
| print_response | boolean | If true, the response data will be printed to stdout. Default: false |
| Name | Type | Description | Format |
|---|---|---|---|
| forecasts | array | An array of forecasts Note: In the same order as the input coordinates | - |
| dewpoint_2m | numeric | The dewpoint at 2m above ground level | ºC |
| latitude | numeric | The latitude of the point, between -90 and 90 | degrees |
| longitude | numeric | The longitude of the point, between -180 and 180 | degrees |
| precipitation | numeric | The hourly precipitation | millimeter |
| pressure_msl | numeric | The pressure as converted to MSL pressure | hectopascals |
| temperature_2m | numeric | The temperature at 2m above ground level | ºC |
| time | string | The ISO 8601 timestamp of when this forecast point is valid | ISO 8601 |
| wind_u_10m | numeric | The U component of wind speed at 10m above ground level | m/s |
| wind_v_10m | numeric | The V component of wind speed at 10m above ground level | m/s |
| initialization_time | string | The ISO 8601 timestamp of the forecast initialization time | ISO 8601 |