# adsbfi/opendata architecture

> Architecture diagram of the GitHub repository adsbfi/opendata, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adsbfi/opendata
- Repository: https://github.com/adsbfi/opendata

## Overview

adsb.fi is a read-only aircraft-tracking data API. Clients query public endpoints by aircraft identifier, callsign, registration, squawk, military status, or geographic area and receive aircraft data; feeder contributors can request a periodically refreshed snapshot. The README documents endpoint behavior and rate limits, but this repository contains no implementation source, so internal routing, storage, and data-processing relationships cannot be established.

Main entry points: [`README.md`](https://github.com/adsbfi/opendata/blob/main/README.md) (Public endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_public["Public queries"]
  node_public_endpoints["Public endpoints<br/>[README.md]"]
  node_identifier_queries["Aircraft lookups<br/>[README.md]"]
  node_geographic_query["Geographic query<br/>[README.md]"]
  node_aircraft_data["Aircraft data<br/>[README.md]"]
end

subgraph group_feeder["Feeder access"]
  node_snapshot_endpoint["Snapshot endpoint<br/>[README.md]"]
  node_snapshot_data["Aircraft snapshot<br/>[README.md]"]
end

node_client(("API client"))
node_contributor(("Feeder contributor"))

node_client -->|"queries"| node_public_endpoints
node_public_endpoints -->|"supports lookups"| node_identifier_queries
node_public_endpoints -->|"supports area search"| node_geographic_query
node_identifier_queries -->|"returns aircraft"| node_aircraft_data
node_geographic_query -->|"returns aircraft"| node_aircraft_data
node_contributor -->|"requests snapshot"| node_snapshot_endpoint
node_snapshot_endpoint -->|"returns snapshot"| node_snapshot_data

click node_public_endpoints "https://github.com/adsbfi/opendata/blob/main/README.md"
click node_identifier_queries "https://github.com/adsbfi/opendata/blob/main/README.md"
click node_geographic_query "https://github.com/adsbfi/opendata/blob/main/README.md"
click node_aircraft_data "https://github.com/adsbfi/opendata/blob/main/README.md"
click node_snapshot_endpoint "https://github.com/adsbfi/opendata/blob/main/README.md"
click node_snapshot_data "https://github.com/adsbfi/opendata/blob/main/README.md"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_public_endpoints,node_identifier_queries,node_geographic_query,node_aircraft_data,node_client toneBlue
class node_snapshot_endpoint,node_snapshot_data toneAmber
class node_contributor toneIndigo
```

## Components

### Public queries

- [Public endpoints](https://github.com/adsbfi/opendata/blob/main/README.md): `README.md`
- [Aircraft lookups](https://github.com/adsbfi/opendata/blob/main/README.md): `README.md`
- [Geographic query](https://github.com/adsbfi/opendata/blob/main/README.md): `README.md`
- [Aircraft data](https://github.com/adsbfi/opendata/blob/main/README.md): `README.md`

### Feeder access

- [Snapshot endpoint](https://github.com/adsbfi/opendata/blob/main/README.md): `README.md`
- [Aircraft snapshot](https://github.com/adsbfi/opendata/blob/main/README.md): `README.md`

### Other components

- **API client**
- **Feeder contributor**

## Connections

- API client → Public endpoints: queries (evidence: `README.md`)
- Public endpoints → Aircraft lookups: supports lookups (evidence: `README.md`)
- Public endpoints → Geographic query: supports area search (evidence: `README.md`)
- Aircraft lookups → Aircraft data: returns aircraft (evidence: `README.md`)
- Geographic query → Aircraft data: returns aircraft (evidence: `README.md`)
- Feeder contributor → Snapshot endpoint: requests snapshot (evidence: `README.md`)
- Snapshot endpoint → Aircraft snapshot: returns snapshot (evidence: `README.md`)
