# IPMA station observations

The latest hourly observation of each IPMA surface station: temperature, humidity, wind, rain, pressure and radiation, with the station's name and position.

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/observation/meteorology/stations/observations.json](https://api.ipma.pt/open-data/observation/meteorology/stations/observations.json) |
| Reader page | [https://www.ipma.pt/en/otempo/obs.superficie/](https://www.ipma.pt/en/otempo/obs.superficie/) |
| 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-observations/collect.mjs](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/sources/ipma-observations/collect.mjs) |
| Since | 2026-11-17 |
| Last read | 2026-11-18 19:17 UTC |
| Last run | ok: 2 requests ok, 0 failed |
| Now | 171 of 227 stations reporting |
| 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: [observations.json](/api/v1/ipma-observations/raw/observations.json), [stations.json](/api/v1/ipma-observations/raw/stations.json).

Every station, every hour IPMA published in its 24-hour file: temperature lines for a few stations. The data: [/api/v1/ipma-observations/raw/observations.json](/api/v1/ipma-observations/raw/observations.json).

## 3. The processed data

The collector keeps only the latest hour of IPMA's 24-hour file for each station, names the fields, turns -99 into null and adds the station's place from IPMA's station list. The result: [latest.json](/api/v1/ipma-observations/latest.json).

The wind at each station in the latest hour: direction and speed. The data: [/api/v1/ipma-observations/latest.json](/api/v1/ipma-observations/latest.json).

The temperature at each station in the latest hour. The data: [/api/v1/ipma-observations/latest.json](/api/v1/ipma-observations/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-observations/latest.json](https://data.promptugal.news/api/v1/ipma-observations/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/ipma-observations/reads.json](https://data.promptugal.news/api/v1/ipma-observations/reads.json) |
| Card | [https://data.promptugal.news/api/v1/ipma-observations/card.json](https://data.promptugal.news/api/v1/ipma-observations/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/ipma-observations/openapi.json](https://data.promptugal.news/api/v1/ipma-observations/openapi.json) |

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

## Vault

| Field | Value |
|---|---|
| Vault id | a3y1ezgg |
| Public read key | `sgit_public_read_7ac36234dd95f92be33e01271c4a8d22b7c6926a9d965e58722fcfb79b1769c6` |
| Clone | `sgit clone sgit_public_read_7ac36234dd95f92be33e01271c4a8d22b7c6926a9d965e58722fcfb79b1769c6:a3y1ezgg` |
| 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 | 2 | 0 | 0 of 2 |
| 2026-11-18 19:12 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 19:08 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 19:05 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 18:57 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 18:53 UTC | 2 | 0 | 1 of 2 |
| 2026-11-18 17:56 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 17:41 UTC | 2 | 0 | 1 of 2 |
| 2026-11-18 16:32 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 16:13 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 16:09 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 16:06 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 16:00 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 15:56 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 15:53 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 15:49 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 15:45 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 15:41 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 15:38 UTC | 2 | 0 | 1 of 2 |
| 2026-11-18 15:34 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 15:29 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 15:15 UTC | 2 | 0 | 0 of 2 |
| 2026-11-18 15:10 UTC | 2 | 0 | 2 of 2 |
| 2026-11-18 14:58 UTC | 0 | 2 | 0 of 2 |

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

## Preview of the values

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

| id | name | lat | lon | Source |
|---|---|---|---|---|
| 1200501 | Flores (Aeródromo) | 39.45819 | -31.1301 | [source](https://api.ipma.pt/open-data/observation/meteorology/stations/observations.json) |
| 1200502 | Corvo (Aeródromo) | 39.67389 | -31.11362 | [source](https://api.ipma.pt/open-data/observation/meteorology/stations/observations.json) |
| 1200504 | Pico (Aeródromo) | 38.55219 | -28.44137 | [source](https://api.ipma.pt/open-data/observation/meteorology/stations/observations.json) |
| 1200505 | Horta / Aeroporto | 38.5211 | -28.7128 | [source](https://api.ipma.pt/open-data/observation/meteorology/stations/observations.json) |
| 1200506 | Horta (Obs. Principe Alberto) | 38.540781 | -28.63225 | [source](https://api.ipma.pt/open-data/observation/meteorology/stations/observations.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-observations/
