# 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](https://api.ipma.pt/open-data/forecast/warnings/warnings_www.json) |
| Reader page | [https://www.ipma.pt/en/otempo/prev-sam/](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](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/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](https://api.ipma.pt/) (IPMA, Instituto Português do Mar e da Atmosfera). This page, the card and the records we add: [CC BY 4.0](https://creativecommons.org/licenses/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.
>
> The publisher's words (pt), from [https://api.ipma.pt/](https://api.ipma.pt/), read on 2026-11-17.

**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](/api/v1/ipma-warnings/raw/warnings.json).

Every entry in IPMA's warnings file, green ones included, as bars from start to end by area. The data: [/api/v1/ipma-warnings/raw/warnings.json](/api/v1/ipma-warnings/raw/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](/api/v1/ipma-warnings/latest.json).

The warnings in force or to come: areas by type, coloured by level. The data: [/api/v1/ipma-warnings/latest.json](/api/v1/ipma-warnings/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](/api/v1/README.md)).

| File | Address |
|---|---|
| Latest read | [https://data.promptugal.news/api/v1/ipma-warnings/latest.json](https://data.promptugal.news/api/v1/ipma-warnings/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/ipma-warnings/reads.json](https://data.promptugal.news/api/v1/ipma-warnings/reads.json) |
| Card | [https://data.promptugal.news/api/v1/ipma-warnings/card.json](https://data.promptugal.news/api/v1/ipma-warnings/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/ipma-warnings/openapi.json](https://data.promptugal.news/api/v1/ipma-warnings/openapi.json) |

```
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](https://data.promptugal.news/api/v1/ipma-warnings/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](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](https://api.ipma.pt/open-data/forecast/warnings/warnings_www.json) |
| AVR | Aveiro | rough sea | Agitação Marítima | yellow | 2026-11-20T00:00:00 | [source](https://api.ipma.pt/open-data/forecast/warnings/warnings_www.json) |
| BJA | Beja | rough sea | Agitação Marítima | yellow | 2026-11-18T17:19:00 | [source](https://api.ipma.pt/open-data/forecast/warnings/warnings_www.json) |
| BRG | Braga | rough sea | Agitação Marítima | orange | 2026-11-18T17:19:00 | [source](https://api.ipma.pt/open-data/forecast/warnings/warnings_www.json) |
| BRG | Braga | rain | Precipitação | yellow | 2026-11-18T17:19:00 | [source](https://api.ipma.pt/open-data/forecast/warnings/warnings_www.json) |

---

Version v0.1.47 · data read 2026-11-18 19:18 UTC · Code Apache-2.0; our pages, records and visualisations CC BY 4.0; each source's data under its own licence or terms, linked · [Repository](https://github.com/PrompTugal/PrompTugal__News__Data) · [Pay for what you read](https://promptugal.news/account/) · https://data.promptugal.news/sources/ipma-warnings/
