Get a MetaMesh point forecast for each coordinate or station, with optional conditions, observations, and historical ERA5 averages (normals). include_climatology adds normals at every hour from the first to last forecast time; include_climatology_summary adds daily normals for the local dates covered by the forecast. Either option works on its own.
| Name | Type | Description | Format |
|---|---|---|---|
| coordinates Alternative | string | Semicolon-separated latitude,longitude pairs. Use this, stations , or both. | lat,lon;lat,lon;... |
| stations Alternative | string |
Comma- or semicolon-separated ICAO station identifiers. Results for coordinates come first.
See Available Stations for supported IDs. | ICAO IDs |
| include_conditions Optional | boolean | Add hourly, daily, and day/night summaries in conditions . | true or false |
| include_observations Optional | boolean | Add recent routine ASOS reports in observations . Coordinates use the nearest ASOS station. | true or false |
| include_distribution Optional | boolean | Add p10/p90 ranges for supported scalar fields, precipitation probabilities, and precipitation-type probabilities to each forecast point. | true or false |
| include_climatology Optional | boolean | Add hourly ERA5 normals from the first through last returned forecast time in climatologies . This can include hours between forecast points. | true or false |
| include_climatology_summary Optional | boolean | Add one ERA5 daily normal per local date covered by each forecast in climatology_summaries . | true or false |
| initialization_time Optional | string | Select an exact MetaMesh run for station forecasts. | ISO 8601 |
| min_forecast_hour Optional | integer | First forecast hour. Defaults to 0 and is limited to 0–360. | hours |
| max_forecast_hour Optional | integer | Last forecast hour. Defaults to 360 and is limited to 0–360. | hours |
| min_forecast_time Optional | string | Earliest forecast time to return. | ISO 8601 |
| max_forecast_time Optional | string | Latest forecast time to return. | ISO 8601 |
| observation_hours Optional | integer | Hours of observations to return. Defaults to 48; range 1–168. Used only when include_observations is true. | hours |
| climatology_normal Optional | string | Normal period: 1991-2020 , 2011-2020 , or 2016-2025 . Defaults to 1991-2020. Used when include_climatology or include_climatology_summary is true. | year range |
Requests with include_conditions or include_observations set to true accept at most 10 total locations.
Location arrays preserve input order, with coordinates before stations. Unknown or unavailable stations keep their position with an empty array or null condition.
| Name | Type | Description | Format |
|---|---|---|---|
| initialization_time | string | MetaMesh initialization time. | ISO 8601 |
| forecast_zero | string | Valid time of the first returned forecast point. | ISO 8601 |
| forecasts | array | One MetaMesh series per location. See Point Forecast. | - |
| conditions | array | One summary set per location. See Conditions. | - |
| observations | array | One chronological ASOS series per location. See ASOS Observations. | - |
| climatology_normal | string | The selected averaging years, present when either climatology option is requested. | year range |
| climatologies | array | One hourly normal series per forecast location, covering every hour from its first through last forecast time. Empty forecasts produce empty arrays. See Climatology. | - |
| climatology_summaries | array | One daily series per location, from its first through last forecast date. Dates use the location's fixed standard UTC offset, so a UTC forecast time may belong to the previous local date. Empty forecasts produce empty arrays. See Climatology Summary. | - |
| units | object | Units for numeric weather fields. Always present. | - |