keligrubb/kestrelos

Fork 0

Files

T

keligrubb bb01e9a06c

Push / release (push) Successful in 13s

Details

Push / publish (push) Successful in 1m4s

Details

Add ADS-B, AIS, and ALPR map layers with live CoT streaming (#36 )

## Summary

- **ADS-B & AIS:** OpenSky and AISStream OSINT feeds upsert into the CoT store; tactical tracks still arrive via adsbcot/aiscot on `:8089`. Map clients subscribe via `GET /api/cot/stream` (SSE) with viewport bbox filtering and Air / Surface / Team layer toggles.
- **ALPR (Flock/OSM):** Toggleable license-plate reader layer sourced from OpenStreetMap, with SQLite cache, Overpass fallback, tiled viewport fetching, and clustered markers with direction cones.
- **Map performance:** Ring-based tile selection (fixes zoom-out crash), immutable tile cache, incremental marker sync, split cluster load/query, and padded SSE bbox to reduce reconnect churn.

## Docs

- `docs/tracking.md` — ADS-B/AIS accuracy tiers, freshness, self-hosted receivers, optional OSINT API keys
- `docs/map-and-cameras.md` — ALPR layer and map behavior updates

---------

Co-authored-by: Madison Grubb <madison@elastiflow.com>
Reviewed-on: #36

2026-06-24 20:54:50 +00:00

1.7 KiB

Raw Blame History

ADS-B and AIS

Aircraft and vessels use the same CoT store as ATAK/iTAK. The map consumes GET /api/cot/stream (SSE, viewport bbox). Toggle Air, Surface, and Team on the map.

Accuracy tiers

Tactical (best): local SDR/AIS receiver → adsbcot / aiscot → KestrelOS CoT :8089 (sub-second updates).
Vessels (live OSINT): AISStream WebSocket push as vessels transmit.
Aircraft (awareness OSINT): OpenSky bbox poll — not a live stream; typical lag ~5s.

For tactical use, run local receivers. Do not rely on OpenSky alone.

Freshness

Tracks update via SSE update events (CoT :8089, AISStream) or coalesced snapshot after each OpenSky poll. Stale tracks are removed automatically (team ~90s, OSINT ~30s without a new fix).

OSINT feeds run only while a map client is connected (SSE subscriber). Keep the map tab visible for live updates.

Self-hosted

ADS-B: adsbcot → tls://host:8089

[adsbcot]
COT_URL = tls://kestrelos.example.com:8089
FEED_URL = tcp+beast://127.0.0.1:30005

AIS: aiscot → tls://host:8089

[aiscot]
COT_URL = tls://kestrelos.example.com:8089
FEED_URL = tcp://127.0.0.1:10110

Use KestrelOS credentials (see atak-itak.md).

OSINT APIs (optional)

Set these only if you want viewport OSINT without local receivers:

Variable	Purpose
`AISSTREAM_API_KEY`	AISStream WebSocket
`OPENSKY_CLIENT_ID` / `OPENSKY_CLIENT_SECRET`	OpenSky OAuth (recommended for production)

UIDs: ICAO.* (ADS-B), MMSI.* (AIS). Icons follow CoT type (a-f-A-*, a-f-S-*, a-f-G-*).

1.7 KiB Raw Blame History