IPMA weather warnings
The weather warnings for every warning area of Portugal (the 18 mainland districts, Madeira and the Azores): yellow, orange and red in full, green counted.
Three layers: the source (who publishes it, the terms, when it was read), the raw data as the publisher served it, and the processed data, what this site makes of it. The processing is where the value is: named fields, places joined, gaps marked, every value kept with its source and time.
1. The source
At a glance
| Field | Value |
|---|---|
| Publisher | IPMA, Instituto Português do Mar e da Atmosfera |
| Source | https://api.ipma.pt/open-data/forecast/warnings/warnings_www.json |
| Reader page | https://www.ipma.pt/en/otempo/prev-sam/ |
| Schedule | hourly: the Pages workflow (.github/workflows/pages.yml), on a schedule at 17 minutes past each hour, and on every push to dev |
| Owner | data@PrompTugal.dinis |
| Collector | sources/ipma-warnings/collect.mjs |
| Since | 2026-11-17 |
| Last read | 2026-11-18 19:17 UTC |
| Last run | ok: 1 requests ok, 0 failed |
| Now | 27 active warnings in 25 areas |
| Licence | The data: the source's terms (IPMA, Instituto Português do Mar e da Atmosfera). This page, the card and the records we add: CC BY 4.0. |
Reuse terms
IPMA: free to copy and use for personal or public use if the use has no profit-making or offensive purpose; always name IPMA as the source. Reuse: with conditions: attribution to IPMA; no profit-making purpose.
O Utilizador pode copiar, importar ou utilizar gratuitamente informações ou símbolos nacionais existentes neste site para uso pessoal ou público desde que dessa utilização não decorram finalidades lucrativas ou ofensivas. O Utilizador deve referir, sempre, a fonte de informação.
Open question: Whether a paid reading meter on a PrompTugal site counts as a profit-making purpose under these terms is for Dinis to decide (or to ask IPMA). Until then the data site itself carries no meter.
2. The raw data
As IPMA served it at the latest read (2026-11-18 19:17 UTC), unprocessed. The files: warnings.json.
3. The processed data
The collector drops the green entries, names the area and the type in English, and counts the active warnings by level. The result: latest.json.
More about this source
What runs by code, by agents and by people
Code
- the collector reads the source and writes latest.json, reads.json and the vault copy
- GitHub Actions runs it every hour and deploys the site
- the build makes the API, the OpenAPI description and the pages
Agents
- data@PrompTugal.dinis (Opus) wrote the collector, this card and the pages on 17 November 2026; data.dev@ and data.design@ (Sonnet) wrote parts of the site build and the design variations
People
- Dinis Cruz instructs; no person has checked the values yet (not reviewed)
Cost
| Field | Value |
|---|---|
| per run tokens | 0 |
| per run model cost usd | 0 |
| runner | GitHub Actions on a public repository: no charge (GitHub's terms for public repositories); about 3 minutes a run for all sources together (measured locally, 17 November 2026) |
| build tokens | not measured: accountant@'s ledger is not running on this account; to be added when it is |
| note | Code only: no model is called when the data is collected. |
API addresses
These addresses stay for the life of v1 (the contract).
curl -s https://data.promptugal.news/api/v1/ipma-warnings/latest.json
curl -s https://data.promptugal.news/api/v1/ipma-warnings/reads.json | head -c 600
Vault
| Field | Value |
|---|---|
| Vault id | 4ol6ht3d |
| Public read key | sgit_public_read_abcdeee55bcbc6bf3598876a7344effaf15d873a625f8ab00c09afe2afc2b531 |
| Clone | sgit clone sgit_public_read_abcdeee55bcbc6bf3598876a7344effaf15d873a625f8ab00c09afe2afc2b531:4ol6ht3d |
| Note | Public read key: the source is public, so anyone may read the vault. A read key is derived one way and cannot write. The write key is never in this repository. |
Last runs
| Time (UTC) | Requests ok | Requests failed | Reads with changed bytes |
|---|---|---|---|
| 2026-11-18 19:17 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 19:12 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 19:08 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 19:05 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 18:57 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 18:53 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 17:56 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 17:41 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 16:32 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 16:13 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 16:10 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 16:06 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 16:01 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:57 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:53 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:49 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:45 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:42 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:38 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:35 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:30 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:15 UTC | 1 | 0 | 0 of 1 |
| 2026-11-18 15:10 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:06 UTC | 0 | 1 | 0 of 1 |
Showing 24 of 48 runs kept. Full detail with sha256: reads.json.
Preview of the values
The first 5 of 27 entries in active, as read 2026-11-18 19:17 UTC. Source: https://api.ipma.pt/open-data/forecast/warnings/warnings_www.json. Long values are shortened here; the file has them whole.
| area | area_name | type | type_pt | level | start | Source |
|---|---|---|---|---|---|---|
| AVR | Aveiro | rough sea | Agitação Marítima | orange | 2026-11-18T17:19:00 | source |
| AVR | Aveiro | rough sea | Agitação Marítima | yellow | 2026-11-20T00:00:00 | source |
| BJA | Beja | rough sea | Agitação Marítima | yellow | 2026-11-18T17:19:00 | source |
| BRG | Braga | rough sea | Agitação Marítima | orange | 2026-11-18T17:19:00 | source |
| BRG | Braga | rain | Precipitação | yellow | 2026-11-18T17:19:00 | source |