Law enforcement aircraft detection and tracking
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.