geospatial
Production & Active

Langarnama

Interactive real-time maritime surveillance, vessel tracking, and nautical GIS platform centered on Persian Gulf and Caspian Sea.

Langarnama Showcase

Overview

Langarnama is a specialized dark-themed maritime intelligence and vessel tracking application covering strategic Middle Eastern waters — the Persian Gulf, Strait of Hormuz, Gulf of Oman, and the Caspian Sea. Built with React 19, MapLibre GL, deck.gl 9, and FastAPI, it ingests live AIS telemetry via WebSockets into an async backend with in-memory spatial indexing. It features 20 Hz dead reckoning along COG/SOG, vessel classification with distinctive color codes, token-free nautical basemaps, tactical GIS drawing tools, and virtualized fleet directories.

Key Benchmark:

20 Hz nautical dead-reckoning interpolation with sub-millisecond layer updates

Key Engineering Features

Live maritime AIS ingestion & streaming via AISStream.io WebSocket into async FastAPI backend with in-memory spatial indexing
Color-coded vessel radar classification: Oil Tankers (red), Cargo (orange), Fishing (green), Passenger (blue), Tug (yellow), Naval (slate)
High-frequency dead reckoning (~20 Hz) using spherical haversine math along COG (Course Over Ground) and SOG (Speed Over Ground)
5 token-free nautical basemaps (Dark Matter, Voyager Streets, Positron Light, Satellite, Balad)
Tactical nautical GIS toolkit: geodesic distance rulers, UTM navigators, image draping, and PNG chart capture
High-density virtualized fleet directory (/ship) powered by TanStack Virtual with detailed vessel particulars

Key Technical Challenges & Solutions

1Accurate vessel icon heading rotation and wake path curves in narrow straits

Utilized deck.gl hardware matrix transformations for heading rotation and spherical arc calculations along vessel trails.

2Complete coverage of Iranian waters without reliance on restricted external map APIs

Configured 5 open-access and Iranian local tile providers operating token-free with zero authentication bottlenecks.

Project Specifications

Category
geospatial
Engineering Role
Lead Frontend Engineer
Status
Production & Active

Technical Architecture & Stack

Maritime GIS & Visualization
MapLibre GL 4.7+
deck.gl 9 (IconLayer, PathLayer, ScatterplotLayer)
Turf.js Nautical Calculations
Frontend & UI
React 19
TypeScript 5
Material UI 7
Vite 5
@tanstack/react-virtual
Streaming & Backend
Python 3.10+
FastAPI
AISStream.io WebSocket Feed
Zero-Latency Spatial Indexer
Resilience & Fallback
Persian Gulf & Caspian Baseline Dataset
20 Hz Motion Interpolation
Token-Free Vector Basemaps