Road Trip Command Center

⚙️ Application Preferences

Customize your dashboard experience. Preferences are saved entirely on your device and are never transmitted externally.

❓ User Guide & Operations Manual

Welcome to the Road Trip Command Center. This guide explains how to operate the dashboard's features to get the most accurate, real-time transportation data.

🗂️ Navigating the Tabs

• 🚗 Road Trip: Displays a high-density grid of all available cameras. By default, cameras are sorted geographically from West to East based on their longitude. Only feeds visible on your screen will actively load to save bandwidth.
• 🛣️ Corridors: Groups cameras logically by their highway route prefix (e.g., US-50, MD-2). Useful for tracking conditions along a specific commuter path.
• 🗺️ Map: Provides a geospatial overview of all camera infrastructure. Clustered bubbles indicate overlapping camera mounts; click a cluster to zoom in or spiderfy the individual camera feeds. Selecting a camera pin will stream its video in the adjacent panel. Ocean City Live webcams appear as a distinct 🌊 marker alongside the standard MDOT pins.
• 🌊 Ocean City Cams: A dedicated grid of live boardwalk, beach, and bay webcams from the Ocean City area, played back as native HLS video (rather than the embedded player used by the highway cameras). These are sourced independently of the MDOT feeds above and are not affected by West-to-East or proximity sorting.

🛰️ Location Tracking Mechanism

The "Center on My Location" button utilizes your device's built-in GPS capabilities to personalize the dashboard. When activated:

• A pulsating green marker is placed on the map to indicate your exact coordinates.
• The application calculates the Haversine distance from your location to every camera tower.
• Both the Road Trip and Corridors tabs instantly re-sort their grids to push the physically closest cameras to the absolute top of the page, appending a live distance badge (e.g., "1.2 mi") to each feed.
• Clicking "❌ Clear Tracking" instantly purges your coordinates from memory and restores the default West-to-East sorting baseline.

🎛️ Map Layers & Advanced Weather Data

The interactive map allows you to toggle multiple dynamic data layers to assess road safety before driving. Use the layer control icon in the top right corner of the map to access:

• Live Weather Radar: Real-time NEXRAD rain and snow returns.
• NWS Warnings & Watches: Blinking polygons showing active flash flood, tornado, and severe thunderstorm alerts from the National Weather Service.
• 24h Precipitation (MRMS): Visualizes accumulated rainfall to help identify low-lying highway stretches prone to standing water and hydroplaning.
• RTMA Surface Wind & Temp: Real-Time Mesoscale Analysis overlaying critical wind and temperature data to help predict bridge restrictions (like the Bay Bridge) or potential roadway freezing.
• CHART Traffic & Incidents: Official geometry from MDOT displaying road closures and verified accidents.

Opacity Mixing: The moment a new overlay is activated, a dimmer slider is dynamically injected directly beneath that layer's name in the control menu. Adjusting this slider instantly fades the layer, allowing you to fine-tune the visual balance.

🌊 Ocean City Live Webcams

The Ocean City Cams tab and its matching map markers stream live HLS video from IPCamLive-hosted cameras around the boardwalk, beach, inlet, and bay. Unlike the MDOT feeds, these aren't provided as a public API — they're curated from several Ocean City tourism and municipal webcam pages, and resolved to a playable video URL by a small lookup step on the dashboard's own server before playback begins in your browser.

• Feeds autoplay muted as you scroll them into view, using the same debounced, bandwidth-friendly loading behavior as the highway camera grids.
• The 🔄 refresh button and the Auto-Refresh Stalled Video Feeds setting (see ⚙️ Settings) both apply here too, re-resolving the camera's stream if playback stalls.
• A handful of cameras (e.g. golf course or marina cams set back from the boardwalk) intentionally sit further from the coastline than the rest — that's expected, not a data error.

ℹ️ About the Command Center

🎯 Purpose

The Road Trip Command Center is a personalized dashboard designed to monitor real-time traffic conditions, regional highway camera feeds, weather patterns, and Ocean City area webcams. It consolidates disparate public transportation datasets and regional live-cam feeds into a single, highly optimized interface to provide instant situational awareness across major commuter corridors and the Eastern Shore.

🔒 Privacy & Architecture

This application respects your privacy by executing almost entirely on your local device. Once the initial interface is loaded in your browser, all spatial distance calculations, proximity sorting, preference saves, and data parsing happen locally. No location data, usage statistics, or telemetry are ever sent back to a server. The one exception is the Ocean City Cams tab: since those streams aren't provided as a public API, playing one requires a small server-side lookup step (resolving which streaming server currently backs that camera) before video begins — that lookup carries only the camera's own public ID, never your location or usage data.

📡 Data Sources

This dashboard is powered by open, public datasets provided by government and academic organizations:

• MDOT CHART API: Live Camera & Highway JSON Feeds
• MDOT ArcGIS Spatial Server: Dynamic Incident & Traffic Map Layers
• Iowa Environmental Mesonet (IEM): Real-Time NEXRAD Radar, RTMA Wind/Temp Analyses, & MRMS Hydrology Layers
• OpenStreetMap: Base Map Cartography

🌊 Ocean City Live Webcams

Unlike the sources above, the Ocean City area cameras aren't a formal government API — they're privately hosted business and municipal webcams, curated by cross-referencing three public Ocean City tourism/visitor sites and de-duplicated down to each camera's underlying stream:

• oceancitylive.com — Ocean City Live webcam directory
• ococean.com — Town of Ocean City official webcams
• oceancity.com — Ocean City tourism webcam directory

All are streamed via IPCamLive, the third-party video host those sites embed.