Cannonball Mode is a specialized feature for detecting and tracking potential law enforcement and surveillance aircraft in real-time. It analyzes aircraft behavior patterns, cross-references against a known LE aircraft database, and provides distance-based threat assessments.

Features

Real-time Threat Detection: Identifies helicopters and aircraft exhibiting surveillance patterns
Pattern Analysis: Detects circling, loitering, grid search, and speed trap patterns
Known LE Database: Cross-references aircraft against a curated database of law enforcement aircraft
Distance-based Alerts: Calculates distance from your position and alerts on proximity
Session Tracking: Groups detections into sessions for historical analysis

Endpoints

Threat Detection

Method	Endpoint	Description
GET	`/api/v1/cannonball/threats/`	Get current threats
POST	`/api/v1/cannonball/location/`	Update GPS location

Mode Activation

Method	Endpoint	Description
POST	`/api/v1/cannonball/activate/`	Activate Cannonball mode
DELETE	`/api/v1/cannonball/activate/`	Deactivate Cannonball mode

Sessions

Method	Endpoint	Description
GET	`/api/v1/cannonball/sessions/`	List all sessions
GET	`/api/v1/cannonball/sessions/active/`	Get active sessions
POST	`/api/v1/cannonball/sessions/{id}/end/`	End a session

Patterns

Method	Endpoint	Description
GET	`/api/v1/cannonball/patterns/`	List detected patterns
GET	`/api/v1/cannonball/patterns/stats/`	Get pattern statistics

Alerts

Method	Endpoint	Description
GET	`/api/v1/cannonball/alerts/`	List alerts
POST	`/api/v1/cannonball/alerts/{id}/acknowledge/`	Acknowledge an alert
POST	`/api/v1/cannonball/alerts/acknowledge-all/`	Acknowledge all alerts

Known Aircraft

Method	Endpoint	Description
GET	`/api/v1/cannonball/known-aircraft/`	List known LE aircraft

Statistics

Method	Endpoint	Description
GET	`/api/v1/cannonball/stats/`	Get statistics

WebSocket

Endpoint	Description
`/ws/cannonball/`	Real-time threat updates

Threat Levels

Level	Description
`info`	Aircraft of interest detected at distance
`warning`	Aircraft approaching or exhibiting patterns
`critical`	Confirmed LE aircraft in close proximity

Pattern Types

Pattern	Description
`circling`	Aircraft making repeated circular orbits
`loitering`	Aircraft remaining in a small area
`grid_search`	Systematic back-and-forth pattern
`speed_trap`	Low-altitude parallel highway flight
`parallel_highway`	Extended flight parallel to highway
`surveillance`	General surveillance behavior
`pursuit`	Active pursuit pattern

Authentication

All endpoints support both JWT authentication and API key authentication. Anonymous access is allowed with limited functionality.