WorldMonitor provides specialized tracking of military vessels and aircraft, identifying assets by their transponder characteristics and monitoring activity patterns. The system detects surge events, foreign military presence in sensitive regions, and assesses strike capability across multiple strategic theaters.
The system defines 10 active conflict zones (Iran, Strait of Hormuz, Ukraine, Gaza, South Lebanon, Red Sea, Sudan, Myanmar, Korean DMZ, Pakistan-Afghanistan Border) and 4 military command hotspots (INDO-PACIFIC, CENTCOM, EUCOM, ARCTIC). Different subsystems group these into theater lists tailored to their specific analysis, so theater counts vary by context throughout this page.
Military Vessel Identification
Vessels are identified as military through multiple methods:
MMSI Analysis: Maritime Mobile Service Identity numbers encode the vessel’s flag state. The system maintains a mapping of 150+ country codes to identify naval vessels:
| MID Range | Country | Notes |
|---|
| 338-339 | USA | US Navy, Coast Guard |
| 273 | Russia | Russian Navy |
| 412-414 | China | PLAN vessels |
| 232-235 | UK | Royal Navy |
| 226-228 | France | Marine Nationale |
| Category | Tracked Vessels |
|---|
| US Carriers | All 11 Nimitz/Ford-class (CVN-68 through CVN-78) |
| UK Carriers | HMS Queen Elizabeth (R08), HMS Prince of Wales (R09) |
| Chinese Carriers | Liaoning (16), Shandong (17), Fujian (18) |
| Russian Carrier | Admiral Kuznetsov |
| Notable Destroyers | USS Zumwalt (DDG-1000), HMS Defender (D36), HMS Duncan (D37) |
| Research/Intel | USNS Victorious (T-AGOS-19), USNS Impeccable (T-AGOS-23), Yuan Wang |
- Check vessel name against known database (hull numbers and ship names)
- Fall back to AIS ship type code if name match fails
- Apply MMSI pattern matching for country/operator identification
- For naval-prefix vessels (USS, HMS, HMCS, HMAS, INS, JS, ROKS, TCG), infer military status
Callsign Patterns: Known military callsign prefixes (NAVY, GUARD, etc.) provide secondary identification.
Naval Chokepoint Monitoring
The system monitors 12 critical maritime chokepoints with configurable detection radii:
| Chokepoint | Strategic Significance |
|---|
| Strait of Hormuz | Persian Gulf access, oil transit |
| Suez Canal | Mediterranean-Red Sea link |
| Strait of Malacca | Pacific-Indian Ocean route |
| Taiwan Strait | Cross-strait tensions |
| Bosphorus | Black Sea access |
| GIUK Gap | North Atlantic submarine route |
Naval Base Proximity
Activity near 12 major naval installations is tracked:
- Norfolk (USA) - Atlantic Fleet headquarters
- Pearl Harbor (USA) - Pacific Fleet base
- Sevastopol (Russia) - Black Sea Fleet
- Qingdao (China) - North Sea Fleet
- Yokosuka (Japan) - US 7th Fleet
Vessels within 50km of these bases are flagged, enabling detection of unusual activity patterns.
Aircraft Tracking (OpenSky)
Military aircraft are tracked via the OpenSky Network using ADS-B data. OpenSky blocks unauthenticated requests from cloud provider IPs (Vercel, Railway, AWS), so aircraft tracking requires a relay server with credentials.
Authentication:
- Register for a free account at opensky-network.org
- Create an API client in account settings to get
OPENSKY_CLIENT_ID and OPENSKY_CLIENT_SECRET
- The relay uses OAuth2 client credentials flow to obtain Bearer tokens
- Tokens are cached (30-minute expiry) and automatically refreshed
Identification Methods:
- Callsign matching: Known military callsign patterns (RCH, REACH, DUKE, etc.)
- ICAO hex ranges: Military aircraft use assigned hex code blocks by country
- Altitude/speed profiles: Unusual flight characteristics
Tracked Metrics:
- Position history (20-point trails over 5-minute windows)
- Altitude and ground speed
- Heading and track
Activity Detection:
- Formations (multiple military aircraft in proximity)
- Unusual patterns (holding, reconnaissance orbits)
- Chokepoint transits
Vessel Position History
The system maintains position trails for tracked vessels:
- 30-point history per MMSI
- 10-minute cleanup interval for stale data
- Trail visualization on map for recent movement
This enables detection of loitering, circling, or other anomalous behavior patterns.
Military Surge Detection
The system continuously monitors military aircraft activity to detect surge events, significant increases above normal operational baselines that may indicate mobilization, exercises, or crisis response.
Theater Classification
Military activity is analyzed across five geographic theaters (a subset of the system’s full conflict zone and hotspot definitions, scoped to regions with reliable ADS-B coverage for surge analysis):
| Theater | Coverage | Key Areas |
|---|
| Middle East | Persian Gulf, Levant, Arabian Peninsula | US CENTCOM activity, Iranian airspace |
| Eastern Europe | Ukraine, Baltics, Black Sea | NATO-Russia border activity |
| Western Europe | Central Europe, North Sea | NATO exercises, air policing |
| Pacific | East Asia, Southeast Asia | Taiwan Strait, Korean Peninsula |
| Horn of Africa | Red Sea, East Africa | Counter-piracy, Houthi activity |
Aircraft Classification
Aircraft are categorized by callsign pattern matching:
| Type | Callsign Patterns | Significance |
|---|
| Transport | RCH, REACH, MOOSE, HERKY, EVAC, DUSTOFF | Airlift operations, troop movement |
| Fighter | VIPER, EAGLE, RAPTOR, STRIKE | Combat air patrol, interception |
| Reconnaissance | SIGNT, COBRA, RIVET, JSTARS | Intelligence gathering |
Baseline Calculation
The system maintains rolling 48-hour activity baselines per theater:
- Minimum 6 data samples required for reliable baseline
- Default baselines when data insufficient: 3 transport, 2 fighter, 1 reconnaissance
- Activity below 50% of baseline indicates stand-down
Surge Detection Algorithm
surge_ratio = current_count / baseline
surge_triggered = (
ratio >= 2.0 AND
transport >= 5 AND
fighters >= 4
)
Surge Signal Output
When a surge is detected, the system generates a military_surge signal:
| Field | Content |
|---|
| Location | Theater centroid coordinates |
| Message | ”Military Transport Surge in [Theater]: [X] aircraft (baseline: [Y])“ |
| Details | Aircraft types, nearby bases (150km radius), top callsigns |
| Confidence | Based on surge ratio (0.6-0.9) |
Foreign Military Presence Detection
Beyond surge detection, the system monitors for foreign military aircraft in sensitive regions, situations where aircraft from one nation appear in geopolitically significant areas outside their normal operating range.
Sensitive Regions
The system tracks 18 strategically significant geographic areas:
| Region | Sensitivity | Monitored For |
|---|
| Taiwan Strait | Critical | PLAAF activity, US transits |
| Persian Gulf | Critical | Iranian, US, Gulf state activity |
| Baltic Sea | High | Russian activity near NATO |
| Black Sea | High | NATO reconnaissance, Russian activity |
| South China Sea | High | PLAAF patrols, US FONOPs |
| Korean Peninsula | High | DPRK activity, US-ROK exercises |
| Eastern Mediterranean | Medium | Russian naval aviation, NATO |
| Arctic | Medium | Russian bomber patrols |
- Identifies all military aircraft within the region boundary
- Groups aircraft by operating nation
- Excludes “home region” operators (e.g., Russian VKS in Baltic excluded from alert)
- Applies concentration thresholds (typically 2-3 aircraft per operator)
Critical Combinations
Certain operator-region combinations trigger critical severity alerts:
| Operator | Region | Rationale |
|---|
| PLAAF | Taiwan Strait | Potential invasion rehearsal |
| Russian VKS | Arctic | Nuclear bomber patrols |
| USAF | Persian Gulf | Potential strike package |
foreign_military_presence signal:
| Field | Content |
|---|
| Title | ”Foreign Military Presence: [Region]“ |
| Details | ”[Operator] aircraft detected: [count] [types]“ |
| Severity | Critical/High/Medium based on combination |
| Confidence | 0.7-0.95 based on aircraft count and type diversity |
Baseline-Based Surge Detection
Surges are detected by comparing current aircraft counts to historical baselines within defined military theaters:
| Parameter | Value | Purpose |
|---|
| Surge threshold | 2.0x baseline | Minimum multiplier to trigger alert |
| Baseline window | 48 hours | Historical data used for comparison |
| Minimum samples | 6 observations | Required data points for valid baseline |
| Category | Examples | Minimum Count |
|---|
| Transport/Airlift | C-17, C-130, KC-135, REACH flights | 5 aircraft |
| Fighter | F-15, F-16, F-22, Typhoon | 4 aircraft |
| Reconnaissance | RC-135, E-3 AWACS, U-2 | 3 aircraft |
Surge Severity
| Severity | Criteria | Meaning |
|---|
| Critical | 4x baseline or higher | Major deployment |
| High | 3x baseline | Significant increase |
| Medium | 2x baseline | Elevated activity |
Military Theaters
Surge detection groups activity into four primary strategic theaters (a simplified grouping used for baseline comparison, distinct from the 5-theater and 9-theater lists used elsewhere):
| Theater | Center | Key Bases |
|---|
| Middle East | Persian Gulf | Al Udeid, Al Dhafra, Incirlik |
| Eastern Europe | Poland | Ramstein, Spangdahlem, Lask |
| Pacific | Guam/Japan | Andersen, Kadena, Yokota |
| Horn of Africa | Djibouti | Camp Lemonnier |
Foreign Presence Detection
A separate system monitors for military operators outside their normal operating areas:
| Operator | Home Regions | Alert When Found In |
|---|
| USAF/USN | Alaska ADIZ | Persian Gulf, Taiwan Strait |
| Russian VKS | Kaliningrad, Arctic, Black Sea | Baltic Region, Alaska ADIZ |
| PLAAF/PLAN | Taiwan Strait, South China Sea | (alerts when increased) |
| Israeli IAF | Eastern Med | Iran border region |
FOREIGN MILITARY PRESENCE: Persian Gulf
USAF: 3 aircraft detected (KC-135, RC-135W, E-3)
Severity: HIGH - Operator outside normal home regions
News Correlation
Both surge and foreign presence alerts query the Focal Point Detector for context:
- Identify countries involved (aircraft operators, region countries)
- Check focal points for those countries
- If news correlation exists, attach headlines and evidence
Example with correlation:
MILITARY AIRLIFT SURGE: Middle East Theater
Current: 8 transport aircraft (2.5x baseline)
Aircraft: C-17 (3), KC-135 (3), C-130J (2)
NEWS CORRELATION:
Iran: "Iran protests continue amid military..."
-> Iran appears in both news (12) and map signals (9)
Aircraft Enrichment
Military aircraft tracking is enhanced with Wingbits enrichment data, providing detailed aircraft information that goes beyond basic transponder data.
What Wingbits Provides
When an aircraft is detected via OpenSky ADS-B, the system queries Wingbits for:
| Field | Description | Use Case |
|---|
| Registration | Aircraft tail number (e.g., N12345) | Unique identification |
| Owner | Legal owner of the aircraft | Military branch detection |
| Operator | Operating entity | Distinguish military vs. contractor |
| Manufacturer | Boeing, Lockheed Martin, etc. | Aircraft type classification |
| Model | Specific aircraft model | Capability assessment |
| Built Year | Year of manufacture | Fleet age analysis |
Military Classification Algorithm
The enrichment service analyzes owner and operator fields against curated keyword lists:
Confirmed Military (owner/operator match):
- Government: “United States Air Force”, “Department of Defense”, “Royal Air Force”
- International: “NATO”, “Ministry of Defence”, “Bundeswehr”
Likely Military (operator ICAO codes):
AIO (Air Mobility Command), RRR (Royal Air Force), GAF (German Air Force)RCH (REACH flights), CNV (Convoy flights), DOD (Department of Defense)
Possible Military (defense contractors):
- Northrop Grumman, Lockheed Martin, General Atomics, Raytheon, Boeing Defense, L3Harris
Aircraft Type Matching:
- Transport: C-17, C-130, C-5, KC-135, KC-46
- Reconnaissance: RC-135, U-2, RQ-4, E-3, E-8
- Combat: F-15, F-16, F-22, F-35, B-52, B-2
- European: Eurofighter, Typhoon, Rafale, Tornado, Gripen
Confidence Levels
Each enriched aircraft receives a confidence classification:
| Level | Criteria | Display |
|---|
| Confirmed | Direct military owner/operator match | Green badge |
| Likely | Military ICAO code or aircraft type | Yellow badge |
| Possible | Defense contractor ownership | Gray badge |
| Civilian | No military indicators | No badge |
Caching Strategy
Aircraft details rarely change, so aggressive caching reduces API load:
- Server-side: HTTP Cache-Control headers (24-hour max-age)
- Client-side: 1-hour local cache per aircraft
- Batch optimization: Up to 20 aircraft per API call
This means an aircraft’s details are fetched at most once per day, regardless of how many times it appears on the map.
Space Launch Infrastructure
The Spaceports layer displays global launch facilities for monitoring space-related activity and supply chain implications.
Tracked Launch Sites
| Site | Country | Operator | Activity Level |
|---|
| Kennedy Space Center | USA | NASA/Space Force | High |
| Vandenberg SFB | USA | US Space Force | Medium |
| Starbase | USA | SpaceX | High |
| Baikonur Cosmodrome | Kazakhstan | Roscosmos | Medium |
| Plesetsk Cosmodrome | Russia | Roscosmos/Military | Medium |
| Vostochny Cosmodrome | Russia | Roscosmos | Low |
| Jiuquan SLC | China | CNSA | High |
| Xichang SLC | China | CNSA | High |
| Wenchang SLC | China | CNSA | Medium |
| Guiana Space Centre | France | ESA/CNES | Medium |
| Satish Dhawan SC | India | ISRO | Medium |
| Tanegashima SC | Japan | JAXA | Low |
Why This Matters
Space launches are geopolitically significant:
- Military implications: Many launches are dual-use (civilian/military)
- Technology competition: Launch cadence indicates space program advancement
- Supply chain: Satellite services affect communications, GPS, reconnaissance
- Incident correlation: News about space debris, failed launches, or policy changes
Strategic Posture Analysis
The AI Strategic Posture panel aggregates military aircraft and naval vessels across defined theaters, providing at-a-glance situational awareness of global force concentrations.
Strategic Theaters
Nine geographic theaters are monitored continuously for posture analysis (this is a separate, more granular grouping than the surge detection theaters above, tailored for strategic posture assessment with per-theater strike capability thresholds):
| Theater | Bounds | Elevated Threshold | Critical Threshold |
|---|
| Iran Theater | Persian Gulf, Iraq, Syria (20N-42N, 30E-65E) | 50 aircraft | 100 aircraft |
| Taiwan Strait | Taiwan, East China Sea (18N-30N, 115E-130E) | 30 aircraft | 60 aircraft |
| Korean Peninsula | North/South Korea (33N-43N, 124E-132E) | 20 aircraft | 50 aircraft |
| Baltic Theater | Baltics, Poland, Scandinavia (52N-65N, 10E-32E) | 20 aircraft | 40 aircraft |
| Black Sea | Ukraine, Turkey, Romania (40N-48N, 26E-42E) | 15 aircraft | 30 aircraft |
| South China Sea | Philippines, Vietnam (5N-25N, 105E-121E) | 25 aircraft | 50 aircraft |
| Eastern Mediterranean | Syria, Cyprus, Lebanon (33N-37N, 25E-37E) | 15 aircraft | 30 aircraft |
| Israel/Gaza | Israel, Gaza Strip (29N-33N, 33E-36E) | 10 aircraft | 25 aircraft |
| Yemen/Red Sea | Bab el-Mandeb, Houthi areas (11N-22N, 32E-54E) | 15 aircraft | 30 aircraft |
Strike Capability Assessment
Beyond raw counts, the system assesses whether forces in a theater constitute an offensive strike package, the combination of assets required for sustained combat operations.
Strike-Capable Criteria:
- Aerial refueling tankers (KC-135, KC-10, A330 MRTT)
- Airborne command and control (E-3 AWACS, E-7 Wedgetail)
- Combat aircraft (fighters, strike aircraft)
Each theater has custom thresholds reflecting realistic strike package sizes:
| Theater | Min Tankers | Min AWACS | Min Fighters |
|---|
| Iran Theater | 10 | 2 | 30 |
| Taiwan Strait | 5 | 1 | 20 |
| Korean Peninsula | 4 | 1 | 15 |
| Baltic/Black Sea | 3-4 | 1 | 10-15 |
| Israel/Gaza | 2 | 1 | 8 |
Naval Vessel Integration
The panel augments aircraft data with real-time naval vessel positions from AIS tracking. Vessels are classified into categories:
| Category | Examples | Strategic Significance |
|---|
| Carriers | CVN, CV, LHD | Power projection, air superiority |
| Destroyers | DDG, DDH | Air defense, cruise missile strike |
| Frigates | FFG, FF | Multi-role escort, ASW |
| Submarines | SSN, SSK, SSBN | Deterrence, ISR, strike |
| Patrol | PC, PG | Coastal defense |
| Auxiliary | T-AO, AOR | Fleet support, logistics |
Posture Levels
| Level | Indicator | Criteria | Meaning |
|---|
| Normal | NORM | Below elevated threshold | Routine peacetime activity |
| Elevated | ELEV | At or above elevated threshold | Increased activity, possible exercises |
| Critical | CRIT | At or above critical threshold | Major deployment, potential crisis |
Trend Detection
Activity trends are computed from rolling historical data:
- Increasing: Current activity >10% higher than previous period
- Stable: Activity within +/-10% of previous period
- Decreasing: Current activity >10% lower than previous period
Server-Side Caching
Theater posture computations run on edge servers with Redis caching:
| Cache Type | TTL | Purpose |
|---|
| Active cache | 5 minutes | Matches OpenSky refresh rate |
| Stale cache | 1 hour | Fallback when upstream APIs fail |
