# IPMA fire risk

The daily fire risk class (RCM, low to maximum) for every municipality of mainland Portugal, today and the next two days.

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/meteorology/rcm/](https://api.ipma.pt/open-data/forecast/meteorology/rcm/) |
| Reader page | [https://www.ipma.pt/en/riscoincendio/rcm.pt/](https://www.ipma.pt/en/riscoincendio/rcm.pt/) |
| 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-fire-risk/collect.mjs](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/sources/ipma-fire-risk/collect.mjs) |
| Since | 2026-11-17 |
| Last read | 2026-11-18 19:17 UTC |
| Last run | ok: 3 requests ok, 0 failed |
| Now | 278 municipalities |
| 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: [rcm-d0.json](/api/v1/ipma-fire-risk/raw/rcm-d0.json), [rcm-d1.json](/api/v1/ipma-fire-risk/raw/rcm-d1.json), [rcm-d2.json](/api/v1/ipma-fire-risk/raw/rcm-d2.json).

IPMA's three fire-risk files (today, tomorrow, the day after): municipalities by level. The data: [/api/v1/ipma-fire-risk/raw/rcm-d0.json](/api/v1/ipma-fire-risk/raw/rcm-d0.json).

## 3. The processed data

The collector joins the three day files into one list per municipality, with the level named. The result: [latest.json](/api/v1/ipma-fire-risk/latest.json).

Fire risk by municipality, on the map, for each of the three days. The data: [/api/v1/ipma-fire-risk/latest.json](/api/v1/ipma-fire-risk/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-fire-risk/latest.json](https://data.promptugal.news/api/v1/ipma-fire-risk/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/ipma-fire-risk/reads.json](https://data.promptugal.news/api/v1/ipma-fire-risk/reads.json) |
| Card | [https://data.promptugal.news/api/v1/ipma-fire-risk/card.json](https://data.promptugal.news/api/v1/ipma-fire-risk/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/ipma-fire-risk/openapi.json](https://data.promptugal.news/api/v1/ipma-fire-risk/openapi.json) |

```
curl -s https://data.promptugal.news/api/v1/ipma-fire-risk/latest.json
curl -s https://data.promptugal.news/api/v1/ipma-fire-risk/reads.json | head -c 600
```

## Vault

| Field | Value |
|---|---|
| Vault id | 94lw1wl8 |
| Public read key | `sgit_public_read_542db136a20c646072fd95c2f976d361eb17d073b45287bc9cac9405f0f1d1c8` |
| Clone | `sgit clone sgit_public_read_542db136a20c646072fd95c2f976d361eb17d073b45287bc9cac9405f0f1d1c8:94lw1wl8` |
| 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 | 3 | 0 | 0 of 3 |
| 2026-11-18 19:11 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 19:08 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 19:04 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 18:57 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 18:53 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 17:55 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 17:40 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 16:32 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 16:13 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 16:09 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 16:05 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 16:00 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 15:56 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 15:53 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 15:49 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 15:45 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 15:41 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 15:38 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 15:34 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 15:29 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 15:15 UTC | 3 | 0 | 0 of 3 |
| 2026-11-18 15:10 UTC | 3 | 0 | 3 of 3 |
| 2026-11-18 14:54 UTC | 0 | 3 | 0 of 3 |

Showing 24 of 48 runs kept. Full detail with sha256: [reads.json](https://data.promptugal.news/api/v1/ipma-fire-risk/reads.json).

## Preview of the values

The first 3 of 3 entries in `files`, as read 2026-11-18 19:17 UTC. Source: [https://api.ipma.pt/open-data/forecast/meteorology/rcm/rcm-d0.json](https://api.ipma.pt/open-data/forecast/meteorology/rcm/rcm-d0.json). Long values are shortened here; the file has them whole.

| d | date | run | file_date | source | Source |
|---|---|---|---|---|---|
| 0 | 2026-11-18 | 2026-11-17 | 2026-11-18 09:35:01 | https://api.ipma.pt/open-data/forecast/meteorology/rcm/rcm-d0.json | [source](https://api.ipma.pt/open-data/forecast/meteorology/rcm/rcm-d0.json) |
| 1 | 2026-11-19 | 2026-11-17 | 2026-11-18 09:35:02 | https://api.ipma.pt/open-data/forecast/meteorology/rcm/rcm-d1.json | [source](https://api.ipma.pt/open-data/forecast/meteorology/rcm/rcm-d1.json) |
| 2 | 2026-11-20 | 2026-11-17 | 2026-11-18 09:35:03 | https://api.ipma.pt/open-data/forecast/meteorology/rcm/rcm-d2.json | [source](https://api.ipma.pt/open-data/forecast/meteorology/rcm/rcm-d2.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-fire-risk/
