Get weather forecast at coordinates
get_point_forecastFetch weather, marine, or air-quality forecasts for any lat/lon point. Includes decoded wind direction, precipitation type, and weather codes with variable parameter guide.
Instructions
Fetch machine-readable weather, marine, or air-quality forecast data for a lat/lon point from the Windy Point Forecast API (https://api.windy.com/point-forecast). Requires WINDY_API_KEY. Returns shaped timesteps with decoded wind direction, precipitation type, and WMO weather codes plus a parameterGuide explaining each requested variable. Pick a regional model when available (iconEu for Europe, hrrrConus for US, arome for France). Use list_forecast_options to browse all models, parameters, and pressure levels.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | Latitude in WGS84 decimal degrees (-90 to 90). Rounded to 2 decimals by the API (~1 km). | |
| lon | Yes | Longitude in WGS84 decimal degrees (-180 to 180). Rounded to 2 decimals by the API (~1 km). | |
| model | No | Numerical weather/sea/air-quality model. Pick a regional model when available for better terrain resolution. Weather models: gfs (global default), icon, iconD2 (DE/AT/CH), iconEu, arome*, nam*, hrrr*, canHrdps. Sea: gfsWave, iconWave, iconEuWave, canRdwpsWave, cmems. Air quality: cams (global), camsEu (Europe + pollen). Details: gfs: Global (NOAA GFS, ~13 km). Default worldwide fallback. — Any location globally when no regional high-res model applies. Good baseline for multi-day trail planning. | icon: Global (DWD ICON-Global). — Global coverage with a European model; alternative to GFS worldwide. | iconD2: Germany, Austria, Switzerland — high resolution (~2 km). — Alpine trails in DE/AT/CH where terrain detail matters. | iconEu: Europe and surrounding areas (~7 km). — European hiking/cycling; better than GFS for the Alps, Pyrenees, etc. | arome: France and surrounding areas (Météo-France AROME). — French trails including Alps, Massif Central, Pyrenees fringes. | aromeAntilles: French Antilles (Caribbean). — Guadeloupe, Martinique, and nearby islands. | aromeFrance: Metropolitan France only. — Mainland France trails when you want the France-specific AROME run. | aromeReunion: Réunion island (Indian Ocean). — Piton des Neiges, cirques, and Réunion hiking. | namConus: Continental USA and surrounding areas (NAM). — US lower-48 trail forecasts (Appalachian, Rockies, etc.). | namHawaii: Hawaii. — Hawaiian island trails and volcanoes. | namAlaska: Alaska and surrounding areas. — Alaskan wilderness and mountain routes. | hrrrConus: Continental USA — high resolution (~3 km, short-range). — Same-day / next-day US trail weather where convection and terrain matter. | hrrrAlaska: Alaska — high resolution short-range. — Detailed short-range forecasts for Alaskan trails. | canHrdps: Canada — high resolution (HRDPS). — Canadian Rockies, Coast Mountains, and other CA trail areas. | gfsWave: Global ocean waves (excludes Hudson Bay partly, Black Sea, Caspian, most Arctic). — Coastal hikes, beach trails, kayak/ferry crossings on open ocean. | iconWave: Global wave model (DWD ICON-GWAM). — Global marine conditions; alternative wave model to gfsWave. | iconEuWave: European seas (ICON-EWAM). — Mediterranean, Atlantic fringe, North Sea coastal trails. | canRdwpsWave: Canadian waters. — Pacific/Atlantic/Arctic coastal routes in Canada. | cmems: Global ocean currents (Copernicus Marine Service). — Coastal current safety for swimming, paddling, or tidal flat crossings. | cams: Global air quality (Copernicus CAMS). — Smoke, dust, or pollution affecting trail air quality worldwide. | camsEu: Europe — includes pollen (CAMS regional). — European trails during hay-fever season or smog events. | gfs |
| parameters | No | One or more forecast parameters. Default bundle covers typical trail planning: temp, wind, windGust, precip, rh, pressure, ptype, lclouds. | |
| levels | No | Pressure/geopotential levels for level-aware params (temp, dewpoint, wind, rh, gh). Other params always use surface. Default ['surface']. Levels: surface: Surface level (default). Best for trailhead conditions: ground temperature, surface wind, and precipitation at the coordinate. | 1000h: 1000 hPa (~sea level). Useful for coastal/lowland forecasts when surface orography differs from the model grid cell. | 950h: 950 hPa (~500 m). Lower foothills and valley inversions. | 925h: 925 hPa (~800 m). Mid-elevation valleys and lower mountain slopes. | 900h: 900 hPa (~1 km). Lower mountain ridges and high valleys. | 850h: 850 hPa (~1.5 km). Standard level for free-atmosphere temperature/wind; often used for mountain-pass and sub-alpine conditions. | 800h: 800 hPa (~2 km). High ridges and lower alpine terrain. | 700h: 700 hPa (~3 km). High alpine / treeline elevation band. | 600h: 600 hPa (~4.2 km). Upper alpine and lower glaciated terrain. | 500h: 500 hPa (~5.6 km). High peaks and upper-atmosphere weather systems. | 400h: 400 hPa (~7.2 km). Very high summits; jet-stream proximity. | 300h: 300 hPa (~9.1 km). Jet-stream level; strong winds aloft. | 200h: 200 hPa (~11.8 km). Upper troposphere. | 150h: 150 hPa (~13.5 km). Near tropopause. | |
| max_steps | No | Optional cap on returned forecast timesteps (from the start). Omit for the full model run. Use to keep responses small (e.g. 24 for ~3 days of 3-hourly data). |