Reference · built on requestCommons signalWeather & climate

IPMA API

Portuguese weather warnings, 5-day forecasts by place, sea state, fire risk, UV index and hourly station observations from IPMA, no key.

Request accessPricing ↗

About

The Instituto Português do Mar e da Atmosfera is Portugal's public institute for weather, sea and seismology. Its API at api.ipma.pt serves JSON, GeoJSON and CSV files for the mainland, Madeira and the Azores. Forecasts are built from two model runs a day, ECMWF and AROME, and keyed to a globalIdLocal per district capital, island or coastal point. Warnings follow the yellow, orange, red scale by warning area.

Through Fibric, an operator matches warnings and daily forecasts to the places you run and proposes a delivery hold, a site notice or a schedule change. You approve it. The warning id and file update time go on the record.

This is a reference listing. It documents what Fibric would read from IPMA API and what it could propose, based on the publisher's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Meteorological warnings up to 3 days at forecast/warnings/warnings_www.json: awarenessTypeName, awarenessLevelID, idAreaAviso, startTime, endTime
  • Daily forecast up to 5 days per place at forecast/meteorology/cities/daily/{globalIdLocal}.json: tMin, tMax, precipitaProb, predWindDir, classWindSpeed, idWeatherType
  • Sea-state forecast up to 3 days at forecast/oceanography/daily/hp-daily-sea-forecast-day{idDay}.json: totalSeaMin, totalSeaMax, waveHighMax, wavePeriodMax, sstMax
  • Fire-risk forecast (rcm codes 1 to 5) by municipality DICO at forecast/meteorology/rcm/rcm-d{idDay}.json
  • UV index forecast up to 3 days at forecast/meteorology/uv/uv.json with iUv per globalIdLocal
  • Hourly station observations for the last 24 hours at observation/meteorology/stations/observations.json, and the last 3 hours as obs-surface.geojson
  • Daily precipitation, air temperature and evapotranspiration by municipality as CSV, 20 days back

Proposed actions

Read-only. This feed informs operators; it changes nothing.

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Hold deliveries under a red warning

    warnings_www.json lists each warning area with its level and window. The operator maps idAreaAviso to your delivery districts and proposes holding orders bound for an orange or red area until endTime.

    With Weather Hold

  • Notify sites of a wind or heat warning

    When a Vento or Tempo Quente warning turns yellow or above for a site's area, the operator drafts the notice, names the affected sites and sends it once you approve.

    With Severe Weather Notice

  • Time coastal work by the sea-state forecast

    The sea forecast gives daily totalSeaMax and swell period per coastal point. The operator flags jobs on days above your working limit and proposes moving them, with the forecast date on file.

    With Field Dispatch

  • Prepare properties on high fire-risk days

    The rcm file scores every municipality 1 to 5. At risk 4 or 5 the operator proposes the pre-agreed checklist for properties in that DICO and records who signed off.

    With Storm Prep

Requirements

  • The globalIdLocal and idAreaAviso for each place, from distrits-islands.json and sea-locations.json
  • idEstacao values from observation/meteorology/stations/stations.json to read station observations
  • The code lists weather-type-classe.json, wind-speed-daily-classe.json and precipitation-classe.json to decode forecast fields
  • IPMA named as the source, with its logo and a link, wherever the information is shown
Authentication
None. The open-data files under api.ipma.pt are public without a key; IPMA asks that you email webmaster@ipma.pt to say you use the service and for what.

Limits

  • Only daily forecast values are published; the files refresh hourly but the content comes from the 00 UTC and 12 UTC runs
  • Observation values of -99.0 mean no data, and pressure or radiation is missing at some stations
  • The conditions of use cover personal or public use without profit; for-profit use is outside the published terms
  • Times are UTC; mainland and Madeira legal time is UTC+1 in summer and the Azores UTC-1 in winter

Access and pricing

Reference listing. Public feed access is separate from Fibric integration. If you request this feed, your quote covers the build, usage, and support.

Request IPMA API ↗

Questions and answers

Does the IPMA API need a key?
No. The files are public HTTP GETs. IPMA asks users to read the conditions of use and to email webmaster@ipma.pt describing their use, for statistics and service planning. A mailing list, API - Desenvolvimentos, announces changes.
How do warnings map to places?
Each warning carries idAreaAviso, a warning-area code such as BGC. distrits-islands.json and sea-locations.json list every forecast place with its globalIdLocal and idAreaAviso, so you join on that code. Only yellow, orange and red warnings appear with text.
Are there hourly forecasts?
No. The forecast files are daily only, up to 5 days per place and 3 days aggregated by day. Hourly values exist for observations: the last 24 hours at observations.json and the last 3 hours in GeoJSON, both refreshed hourly.
Ask about IPMA API

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.

This Commons signal listing is developed, published, and supported by Fibric. It reads public data published by Instituto Português do Mar e da Atmosfera, I.P. (api.ipma.pt). Upstream agencies and projects are the property of their respective owners, who are not affiliated with Fibric and do not sponsor or endorse this listing. Trademark policy