# mta.jamestannahill.com

> Subway Intel — real-time NYC subway intelligence for Midtown Manhattan, New York. Live arrivals, delay detection, network health, track diagram, map, and trip planning, refreshed from MTA GTFS-Realtime feeds every 30 seconds.

## What this is

Subway Intel (https://mta.jamestannahill.com/) is a real-time NYC subway dashboard operated by James Tannahill. It polls the MTA's GTFS-Realtime feeds for every subway line group (1-7/S, A/C/E, B/D/F/M, G, J/Z, L, N/Q/R/W, Staten Island Railway) plus the MTA service-alerts feed, and turns them into live arrival boards, delay intelligence, and network status.

Full technical index: https://mta.jamestannahill.com/llms-full.txt
Documentation: https://mta.jamestannahill.com/docs.html

## Views (hash routes)

- https://mta.jamestannahill.com/#/pulse — Network Pulse: per-line health (NOMINAL / DELAYED / DISRUPTED), average delay, headway variance, service alerts, live track diagram
- https://mta.jamestannahill.com/#/stations — My Stations: saved-station arrival boards with m:ss countdowns by direction
- https://mta.jamestannahill.com/#/nearby — Nearby: geolocated nearest stations with live arrivals and track diagram (deep link: ?near=STOP_ID)
- https://mta.jamestannahill.com/#/intel — Delay Intel: heuristic delay signals from headway gaps and schedule deviation
- https://mta.jamestannahill.com/#/map — Live Map: Mapbox map of stations, track geometry, and live vehicle positions
- https://mta.jamestannahill.com/#/plan — Plan: point-to-point trip planning with live departures and one-transfer routing

## Data sources

- **MTA GTFS-Realtime feeds** (api-endpoint.mta.info) — trip updates, vehicle positions, and alerts for all NYC subway line groups, polled every 30 seconds
- **MTA subway service alerts** — customer-facing alerts JSON feed (camsys)
- **MTA GTFS static** — stop locations, names, and scheduled travel times
- **NYC DOT subway line geometries** — physical track GeoJSON via NYC ArcGIS

## API

Same-origin JSON API at https://mta.jamestannahill.com

- `GET /api/stations/{stop_id}/arrivals` — Live arrivals for a GTFS stop (route, arrival time, delay seconds, direction)
- `GET /api/commute?origin=&destination=` — Trip options between two stops with live departures; falls back to one-transfer routing
- `GET /api/network` — Per-line health: status, avg delay, headway variance, alerts
- `GET /api/delay-intel` — Heuristic delay signals computed across all live arrivals
- `GET /api/stops/search?q=` — Station name search
- `GET /api/stops/nearest?lat=&lon=` — Nearest stations to a coordinate
- `GET /api/stops/all` — All parent stations
- `GET /api/tracks` — Track geometry GeoJSON
- `GET /api/subway-lines` — NYC DOT physical subway line geometries (GeoJSON)
- `GET /api/routes/{route_id}/stops?direction=` — Ordered stop sequence for a route
- `POST /api/feedback/arrival` — Crowd-sourced arrival timing corrections (HERE? Y/N)
- `GET /api/feedback/corrections` — Per-route timing bias corrections
- `WS /ws` — WebSocket pushing the full live-state snapshot on every poll cycle

## Pages

- [Dashboard](https://mta.jamestannahill.com/) — Single-page app (Network Pulse, Stations, Nearby, Intel, Map, Plan)
- [How It Works](https://mta.jamestannahill.com/docs.html) — Technical documentation, data pipeline, API reference

## About the operator

James Tannahill — https://jamestannahill.com