# IPMA daily forecasts by place

Five-day forecasts (minimum and maximum temperature, chance of rain, weather type, wind) for each district capital and island, and Loulé, Portimão and Sagres.

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/cities/daily/](https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/) |
| Reader page | [https://www.ipma.pt/en/otempo/prev.localidade.hora/](https://www.ipma.pt/en/otempo/prev.localidade.hora/) |
| 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-city-forecasts/collect.mjs](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/sources/ipma-city-forecasts/collect.mjs) |
| Since | 2026-11-17 |
| Last read | 2026-11-18 19:15 UTC |
| Last run | ok: 36 requests ok, 0 failed |
| Now | 35 places |
| 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:15 UTC), unprocessed. The files: [city-1010500.json](/api/v1/ipma-city-forecasts/raw/city-1010500.json), [city-1020500.json](/api/v1/ipma-city-forecasts/raw/city-1020500.json), [city-1030300.json](/api/v1/ipma-city-forecasts/raw/city-1030300.json), [city-1030800.json](/api/v1/ipma-city-forecasts/raw/city-1030800.json), [city-1040200.json](/api/v1/ipma-city-forecasts/raw/city-1040200.json), [city-1050200.json](/api/v1/ipma-city-forecasts/raw/city-1050200.json), [city-1060300.json](/api/v1/ipma-city-forecasts/raw/city-1060300.json), [city-1070500.json](/api/v1/ipma-city-forecasts/raw/city-1070500.json), [city-1080500.json](/api/v1/ipma-city-forecasts/raw/city-1080500.json), [city-1080800.json](/api/v1/ipma-city-forecasts/raw/city-1080800.json), [city-1081100.json](/api/v1/ipma-city-forecasts/raw/city-1081100.json), [city-1081505.json](/api/v1/ipma-city-forecasts/raw/city-1081505.json), [city-1090700.json](/api/v1/ipma-city-forecasts/raw/city-1090700.json), [city-1090821.json](/api/v1/ipma-city-forecasts/raw/city-1090821.json), [city-1100900.json](/api/v1/ipma-city-forecasts/raw/city-1100900.json), [city-1110600.json](/api/v1/ipma-city-forecasts/raw/city-1110600.json), [city-1121400.json](/api/v1/ipma-city-forecasts/raw/city-1121400.json), [city-1131200.json](/api/v1/ipma-city-forecasts/raw/city-1131200.json), [city-1141600.json](/api/v1/ipma-city-forecasts/raw/city-1141600.json), [city-1151200.json](/api/v1/ipma-city-forecasts/raw/city-1151200.json), [city-1151300.json](/api/v1/ipma-city-forecasts/raw/city-1151300.json), [city-1160900.json](/api/v1/ipma-city-forecasts/raw/city-1160900.json), [city-1171400.json](/api/v1/ipma-city-forecasts/raw/city-1171400.json), [city-1182300.json](/api/v1/ipma-city-forecasts/raw/city-1182300.json), [city-2310300.json](/api/v1/ipma-city-forecasts/raw/city-2310300.json), [city-2320100.json](/api/v1/ipma-city-forecasts/raw/city-2320100.json), [city-3410100.json](/api/v1/ipma-city-forecasts/raw/city-3410100.json), [city-3420300.json](/api/v1/ipma-city-forecasts/raw/city-3420300.json), [city-3430100.json](/api/v1/ipma-city-forecasts/raw/city-3430100.json), [city-3440100.json](/api/v1/ipma-city-forecasts/raw/city-3440100.json), [city-3450200.json](/api/v1/ipma-city-forecasts/raw/city-3450200.json), [city-3460200.json](/api/v1/ipma-city-forecasts/raw/city-3460200.json), [city-3470100.json](/api/v1/ipma-city-forecasts/raw/city-3470100.json), [city-3480200.json](/api/v1/ipma-city-forecasts/raw/city-3480200.json), [city-3490100.json](/api/v1/ipma-city-forecasts/raw/city-3490100.json), [distrits-islands.json](/api/v1/ipma-city-forecasts/raw/distrits-islands.json).

IPMA's own daily forecast file for Faro, as served. The data: [/api/v1/ipma-city-forecasts/raw/city-1080500.json](/api/v1/ipma-city-forecasts/raw/city-1080500.json).

## 3. The processed data

The collector reads one file per place (35 places), names the fields, and joins each place's name and position from IPMA's list. The result: [latest.json](/api/v1/ipma-city-forecasts/latest.json).

Lowest and highest temperature by place, north to south, for each forecast day. The data: [/api/v1/ipma-city-forecasts/latest.json](/api/v1/ipma-city-forecasts/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-city-forecasts/latest.json](https://data.promptugal.news/api/v1/ipma-city-forecasts/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/ipma-city-forecasts/reads.json](https://data.promptugal.news/api/v1/ipma-city-forecasts/reads.json) |
| Card | [https://data.promptugal.news/api/v1/ipma-city-forecasts/card.json](https://data.promptugal.news/api/v1/ipma-city-forecasts/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/ipma-city-forecasts/openapi.json](https://data.promptugal.news/api/v1/ipma-city-forecasts/openapi.json) |

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

## Vault

| Field | Value |
|---|---|
| Vault id | dn8m3051 |
| Public read key | `sgit_public_read_33ba803fbab7d6d4d1c45b71ac38f384b1cc8d3236f43eee198b90036dacbf17` |
| Clone | `sgit clone sgit_public_read_33ba803fbab7d6d4d1c45b71ac38f384b1cc8d3236f43eee198b90036dacbf17:dn8m3051` |
| 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:15 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 19:10 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 19:06 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 19:03 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 18:55 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 18:52 UTC | 36 | 0 | 35 of 36 |
| 2026-11-18 17:54 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 17:39 UTC | 36 | 0 | 35 of 36 |
| 2026-11-18 16:30 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 16:11 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 16:08 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 16:04 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 15:59 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 15:55 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 15:51 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 15:47 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 15:43 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 15:40 UTC | 36 | 0 | 11 of 36 |
| 2026-11-18 15:36 UTC | 36 | 0 | 24 of 36 |
| 2026-11-18 15:33 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 15:28 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 15:14 UTC | 36 | 0 | 0 of 36 |
| 2026-11-18 15:08 UTC | 36 | 0 | 36 of 36 |
| 2026-11-18 14:50 UTC | 0 | 4 | 0 of 4 |

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

## Preview of the values

The first 5 of 35 entries in `cities`, as read 2026-11-18 19:15 UTC. Source: [https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1010500.json](https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1010500.json). Long values are shortened here; the file has them whole.

| id | name | area | lat | lon | source | Source |
|---|---|---|---|---|---|---|
| 1010500 | Aveiro | AVR | 40.6413 | -8.6535 | https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1010500.json | [source](https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1010500.json) |
| 1020500 | Beja | BJA | 38.02 | -7.87 | https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1020500.json | [source](https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1020500.json) |
| 1030300 | Braga | BRG | 41.5475 | -8.4227 | https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1030300.json | [source](https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1030300.json) |
| 1030800 | Guimarães | BRG | 41.4434 | -8.2938 | https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1030800.json | [source](https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1030800.json) |
| 1040200 | Bragança | BGC | 41.8076 | -6.7606 | https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1040200.json | [source](https://api.ipma.pt/open-data/forecast/meteorology/cities/daily/1040200.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-city-forecasts/
