# Flights around Faro airport

Aircraft seen within 40 nautical miles of Faro airport: airline flights by callsign, airline and type; every other aircraft only 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 | adsb.lol (community ADS-B receivers) |
| Source | [https://api.adsb.lol/v2/point/37.0144/-7.9659/40](https://api.adsb.lol/v2/point/37.0144/-7.9659/40) |
| Reader page | [https://globe.adsb.lol/?lat=37.014&lon=-7.966&zoom=9](https://globe.adsb.lol/?lat=37.014&lon=-7.966&zoom=9) |
| 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/adsb-faro/collect.mjs](https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/sources/adsb-faro/collect.mjs) |
| Since | 2026-11-17 |
| Last read | 2026-11-18 19:14 UTC |
| Last run | ok: 1 requests ok, 0 failed |
| Now | 1 airline flights, 0 other aircraft |
| Licence | The data: [ODbL 1.0](https://opendatacommons.org/licenses/odbl/1-0/) (adsb.lol contributors). This page, the card and the records we add: [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/). |

## Reuse terms

adsb.lol: its API data is licensed under the Open Database License (ODbL 1.0): share-alike, with attribution; no key needed up to 500 requests a day per address. Reuse: yes, under ODbL 1.0 (attribution, share-alike for the database).

> license: ODbL 1.0 ... no key: 500 requests/day per IP
>
> The publisher's words (en), from [https://www.adsb.lol/docs/open-data/api/](https://www.adsb.lol/docs/open-data/api/), read on 2026-11-17.

Privacy: Our own rule, from the storm site: only airline callsigns are kept; other aircraft (private, military, unidentified) are counted, never listed.

## 2. The raw data

The raw answer from adsb.lol names every aircraft by its hex id and position, private ones included. This site keeps the storm site's privacy rule: it publishes no hex id and no position of a private aircraft, so the raw file is neither served nor kept. What is shown of it: every aircraft counted by altitude band, below the map.

## 3. The processed data

The collector keeps airline flights (an airline code and a flight number as callsign) with callsign, type, altitude, speed, heading and position to 0.01 degree; every other aircraft is only counted. The result: [latest.json](/api/v1/adsb-faro/latest.json).

Airline flights within 40 nautical miles of Faro airport at the time read, by callsign, with their heading and altitude. The data: [/api/v1/adsb-faro/latest.json](/api/v1/adsb-faro/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/adsb-faro/latest.json](https://data.promptugal.news/api/v1/adsb-faro/latest.json) |
| Every read | [https://data.promptugal.news/api/v1/adsb-faro/reads.json](https://data.promptugal.news/api/v1/adsb-faro/reads.json) |
| Card | [https://data.promptugal.news/api/v1/adsb-faro/card.json](https://data.promptugal.news/api/v1/adsb-faro/card.json) |
| OpenAPI | [https://data.promptugal.news/api/v1/adsb-faro/openapi.json](https://data.promptugal.news/api/v1/adsb-faro/openapi.json) |

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

## Vault

| Field | Value |
|---|---|
| Vault id | sd1fblzs |
| Public read key | `sgit_public_read_dd88c305ed7763ba851800f41315e623d8e0443da1a10f80f4128ef9b1c58863` |
| Clone | `sgit clone sgit_public_read_dd88c305ed7763ba851800f41315e623d8e0443da1a10f80f4128ef9b1c58863:sd1fblzs` |
| 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:14 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 19:09 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 19:06 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 19:02 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 18:55 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 18:51 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 17:53 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 17:38 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 16:30 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 16:11 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 16:07 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 16:04 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:58 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:54 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:50 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:46 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:43 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:39 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:36 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:32 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:27 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:13 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 15:08 UTC | 1 | 0 | 1 of 1 |
| 2026-11-18 14:50 UTC | 1 | 0 | 1 of 1 |

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

## Preview of the values

The first 1 of 1 entries in `airline`, as read 2026-11-18 19:14 UTC. Source: [https://api.adsb.lol/v2/point/37.0144/-7.9659/40](https://api.adsb.lol/v2/point/37.0144/-7.9659/40). Long values are shortened here; the file has them whole.

| callsign | airline_icao | type | alt_ft | on_ground | ground_speed_kt | Source |
|---|---|---|---|---|---|---|
| RUK3EV | RUK | B738 | 36025 | false | 454.1 | [source](https://api.adsb.lol/v2/point/37.0144/-7.9659/40) |

---

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/adsb-faro/
