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. WeatherMesh-4 forecasts are at hourly resolution out to 5 days and then 6-hourly beyond that. WeatherMesh-5C forecasts are at hourly resolution out to 15 days.
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. | - |
| Name | Description | Format |
|---|---|---|
| coordinates Required | A semi-colon separated list of latitude,longitude tuples, e.g., 37.77,-122.42;40.7,-74.0 | 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. | - |
| 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. |
| 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 Required | string | A semi-colon separated list of latitude,longitude tuples. e.g., 37.77,-122.42;40.7,-74.0 |
| -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. |
| 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. |
| 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 |
|---|---|---|
| coordinates | string or array | A list of coordinates. Provide as a list of (lat, lon) tuples, e.g., [(37.77, -122.42), (40.7, -74.0)], or a semicolon-delimited string, e.g., 37.77,-122.42;40.7,-74.0 |
| 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. |
| 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 |
| forecast_zero | string | The ISO 8601 timestamp of the forecast zero time — the valid time of the first forecast point | ISO 8601 |
| initialization_time | string | The ISO 8601 timestamp of the forecast initialization time | ISO 8601 |
| Name | Type | Description | Format |
|---|---|---|---|
| forecasts | array | An array of forecasts Note: In the same order as the input coordinates | - |
| temperature_2m | numeric | The temperature at 2m above ground level | ºC |
| dewpoint_2m | numeric | The dewpoint at 2m above ground level | ºC |
| precipitation | numeric | The hourly precipitation | millimeter |
| pressure_msl | numeric | The pressure as converted to MSL pressure | hectopascals |
| 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 |
| wind_u_100m | numeric | The U component of wind speed at 100m above ground level | m/s |
| wind_v_100m | numeric | The V component of wind speed at 100m above ground level | m/s |
| latitude | numeric | The latitude of the point, between -90 and 90 | degrees |
| longitude | numeric | The longitude of the point, between -180 and 180 | degrees |
| time | string | The ISO 8601 timestamp of when this forecast point is valid | ISO 8601 |
| forecast_zero | string | The ISO 8601 timestamp of the forecast zero time — the valid time of the first forecast point | ISO 8601 |
| initialization_time | string | The ISO 8601 timestamp of the forecast initialization time | ISO 8601 |