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 serves MetaMesh, which combines forecasts from multiple external models (ECMWF IFS, GFS, HRRR, AIFS, and others) with WindBorne’s operational WeatherMesh models and point decoder. Unlike the Interpolated Point Forecast, which interpolates from a gridded field, MetaMesh produces bias-corrected forecasts directly at the requested location.
| Name | Description | Format |
|---|---|---|
| coordinates Required | A semi-colon separated list of latitude,longitude tuples, e.g., 37.77,-122.42;40.7,-74.0. Longitude uses the -180 to 180 convention. | lat,lon;lat,lon;... |
| stations Alternative | A semi-colon separated list of ICAO station identifiers, e.g.panc;kjfk. Can be used instead of coordinates . When using station IDs, the forecast uses station-specific bias correction trained on METAR observations. See Available Stations for supported IDs. | id;id;... |
| 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 |
| Name | Type | Description |
|---|---|---|
| coordinates Required | string | A semi-colon separated list of latitude,longitude tuples. Longitude uses the -180 to 180 convention. e.g., 37.77,-122.42;40.7,-74.0 |
| stations Alternative | string | A semi-colon separated list of ICAO station identifiers (e.g., panc;kjfk). Can be used instead of coordinates . When provided, the forecast uses station-specific bias correction trained on METAR observations. |
| -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.77, -122.42), (40.7, -74.0)], or a semicolon-delimited string, e.g., 37.77,-122.42;40.7,-74.0 |
| stations | string or array | A list of ICAO station identifiers. Provide as a list of strings, e.g., ["panc", "kjfk"], or a semicolon-delimited string, e.g., panc;kjfk |
| 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 or stations | - |
| temperature_2m | numeric | The temperature at 2m above ground level | ºC |
| dewpoint_2m | numeric | The dewpoint at 2m above ground level | ºC |
| pressure_msl | numeric | The pressure as converted to MSL pressure | hectopascals |
| precipitation | numeric | Total precipitation accumulated over the forecast hour | mm |
| 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 |
| wind_speed_10m | numeric | The wind speed at 10m above ground level | m/s |
| wind_speed_100m | numeric | The 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 |
| station_id | string or null | The ICAO station identifier, if the forecast was requested by station. Null when queried by coordinates. | - |
| 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 |