What's On Miami3D map

Home / 3D map / How it's made

How this map is made

The 3D map is MapLibre GL JS 4.7.1 on OpenFreeMap's vector tiles of OpenStreetMap, with buildings extruded from OSM heights, three.js r128 for the aircraft, a plain Node script that builds every page, and four small Vercel functions that relay live aircraft, sea, weather and boats with short edge caches.

The map names the real places matched to Grand Theft Auto VI in plain text. Grand Theft Auto VI is made by Rockstar Games; What's On Miami isn't affiliated with Rockstar Games or Take-Two Interactive, and the map shows no game imagery.

Written from the code as it stood when this page was built (20 November 2026). Sizes below are measured from this build.

The stack

  • RendererMapLibre GL JS 4.7.1, from unpkg. No framework, no bundler: the map page is one HTML file with its script inline.
  • Tiles and styleOpenFreeMap's dark style (OpenMapTiles schema, built from OpenStreetMap). No API key, no tile server of ours. The small route and race maps on other pages use OpenFreeMap's liberty style.
  • Buildings in 3DThe style's own building layer is hidden and redrawn as a fill-extrusion from OpenMapTiles' render_height and render_min_height (8 m where a building has no height), coloured by height so the skyline reads. A real place inside a building lights that building's own footprint; open-air places get a slim column instead.
  • three.jsr128 from cdnjs, through the aircraft layer our sister sites share (@whatson/core): 3D airliner and helicopter models in a MapLibre custom layer. The same three.js draws the Christmas tree in Bayfront Park in season (#xmas).
  • BuildPlain Node (node scripts/build.mjs) writes static HTML to public/: 40 places, 17 running routes and the rest are embedded in the map page as JSON at build time. The browser-side helpers (hash parsing, walk times, Run it, journeys) are plain ES5 functions, unit-tested in Node and printed into the page with Function#toString, so the code that's tested is the code that runs.
  • ServerVercel functions in api/, only for what a browser can't fetch itself (no CORS, a required User-Agent, a key), each cached at the edge (below). Everything else is static.
  • Walking graph"Make your journey" routes on foot with no routing service: scripts/fetch-walk.mjs pulls the walkable ways (footways, paths, residential streets; trunk roads only with a mapped sidewalk) for Miami Beach, the mainland core and the Venetian Causeway from OpenStreetMap through Overpass, keeps junctions and the shape points that hold each street within about 4 m of its line, and delta-codes them. 65,967 nodes, 1.37 MB (454 KB gzipped), fetched 18 November 2026. lib/walk.mjs turns it into compressed sparse rows with a 300 m grid for snapping and runs A*: in the browser, and in api/journey.js so the share card and the watch files draw the same line.
  • Journey video"Make my video" records the map's own canvas with MediaRecorder (canvas.captureStream(30), 6 Mbps, MP4 where the browser can, else WebM): 15 seconds, 9:16, an overview, then a street-level chase that slows at each stop. Made in the browser; nothing is uploaded. Clips for social posts use a headless recorder from the same core, driven by ?clean=1&c=….
  • Run itThe character runs the mapped line at a steady pace (25 to 40 seconds for the whole route). The camera sits behind it at street level, pitched, and leads by a few hundred metres; its heading is the path's bearing from a little behind to a little ahead, turned toward a share at a time the short way round (runHeading, turnToward in lib/map-run.mjs).

Live data, and where it's cached

LayerSourceUpdatesCache
Aircraftadsb.lol (open ADS-B, ODbL, no key), 25 nautical miles around 25.79, -80.22, relayed by /api/aircraftThe map polls every 15 s and dead-reckons each aircraft between polls (heading and speed, up to 30 s)s-maxage=10, stale-while-revalidate=20 at Vercel's edge, plus 10 s in the function
Beach panelNOAA CO-OPS Virginia Key gauge 8723214 (water and air temperature, wind), NOAA NDBC buoy 41122 (waves; NDBC sends no CORS header), US EPA UV Index for 33139, through /api/seaSources every 6 to 30 minutes; a reading over 3 hours old shows as a dashs-maxage=900, stale-while-revalidate=1800
Running conditions, Drop inNational Weather Service hourly forecast (gridpoint MFL 110,50) and the latest KMIA reading; with ?lat=&lng=, the nearest station. Through /api/weather: the NWS wants a User-Agent and turns some browsers awayForecast hourly, observations about hourly; the map refetches after 10 minutess-maxage=900, stale-while-revalidate=1800; points must fall in Miami-Dade and are rounded to 0.01°, so the cache has a bounded set of keys
Boatsaisstream.io live AIS over Biscayne Bay, through /api/boats, which listens to the stream for a few seconds per callThe map polls every 60 s while the tab is visibles-maxage=60, stale-while-revalidate=120. Returns 503 until a key is set, and the layer stays hidden until it answers
Everything elseOur data files (places, events, clubs, routes, races, towers), checked by hand against official pagesWith each buildStatic

Privacy rules built in: an aircraft's identifier is never put in a link (plane cards are left out of the address on purpose), private jets are shown by type only, and boats are named only when their own broadcast says they're a working ship; never an MMSI or callsign. The map shows no hotel prices. Elsewhere on the site, hotel prices come from a fixed panel of hotels on sampled nights and are published as totals only (the median and how many were sold out), never one hotel's rate.

Live cams

5 public live streams of Miami as camera pins (#cams), listed in data/live-cams.json and drawn by scripts/map-cams.mjs as plain HTML markers. Only YouTube streams on the camera owner's own channel, with embedding allowed; no commercial webcam networks and no scraped image feeds.

  • Coral City CameraPortMiami, Government Cut: Underwater, live: an urban coral reef in about 3 m of water off the east end of PortMiami, with the fish that live on it. Best in daylight. Stream: Coral Morphologic. Pin approximate: the shoreline at the east end of PortMiami, as the channel describes it.
  • Miami River CameraMouth of the Miami River, Brickell: The mouth of the Miami River at Biscayne Bay and the Brickell Avenue Bridge opening for boats; the camera tracks passing boats on its own. Stream: Miami River Camera. Pin approximate: the channel says it overlooks the Brickell Avenue Bridge at the river mouth.
  • PortMiami cruise ship camPortMiami and Government Cut: Cruise ships, cargo ships and boats arriving and leaving PortMiami, with Dodge Island, Star Island, Fisher Island and South Beach in view, from several cameras in turn. Stream: Cruise Ships Live. Pin approximate: the pin marks the cruise terminals it shows; the channel doesn't say where its cameras are.
  • Acqualina Live Beach CamSunny Isles Beach: The beach and the Atlantic in front of Acqualina Resort on Collins Avenue: sand, sea and the weather. Stream: Acqualina Resort. Pin approximate: Acqualina Resort, 17875 Collins Avenue.
  • Intracoastal at Sunny IslesSunny Isles Beach, facing Aventura: The Intracoastal Waterway from Sunny Isles Beach, looking toward Aventura and the William Lehman Causeway: boats, yachts and bridge traffic. Stream: United Globe. Pin approximate: the west side of Sunny Isles Beach, by the Lehman Causeway.
  • Click to playThe card has a play button, not a player: the YouTube iframe (youtube-nocookie.com) is created only after the click, so nothing from YouTube loads before it, and it's removed when the card closes.
  • Stable embedsWhere a channel runs one stream, the card uses the channel's live embed (embed/live_stream?channel=…), so a new stream ID doesn't break it; a channel with several streams is embedded by video ID.
  • Offline streamsnode scripts/check-cams.mjs follows each channel's /live page to the stream on now, and checks YouTube's oEmbed and the video's embed flag; a cam that wasn't live says "Not live right now" with its channel's link. Streams can end between checks, so every card also says to open the channel if the player shows it offline. Last checked 19 November 2026.
  • Road camerasFL511 (FDOT) publishes no reuse licence for its camera snapshots: its User Terms and Conditions page (fl511.com/terms) shows no text, and the only embedding it offers is the whole interactive road map through its Embed Tool (fl511.com/Map/EmbeddedMapSetup). So we link out and show no FL511 images. The layer links to FL511's camera list.

What's approximate

  • The game placesRockstar has never named the real places it modelled. Each match carries a confidence: 15 confirmed (plain to see in an official trailer, several comparisons agree), 22 likely (one solid side-by-side), 3 guesses. Every link cites a published comparison. Official material only, nothing from leaks.
  • PositionsA place's point is the real place, approximately; a long thing (a causeway, a beach) gets one point. Race starts, give-back places and club meeting points are addresses placed with OSM's Nominatim; a few clubs only resolved to the street and are marked approximate.
  • Walk times"About N min on foot" on cards is a straight line at about 80 m a minute, marked as an estimate; journeys use the street graph.
  • Race coursesOur trace of the organiser's course map on OSM streets, not their file; a trace on centre lines measures a little longer than the certified distance.
  • AircraftOnly what ADS-B receivers near Miami hear; owners who block their aircraft aren't shown. Positions between polls are extrapolated.
  • Hotel prices (not on the map)Sampled nights, not live rates, and sold-out hotels push the typical price up: half or more sold out means the price is a floor.

Performance

  • The map page693 KB of HTML with its data and script inline, 204 KB gzipped (measured from this build). MapLibre and three.js come from their CDNs and aren't counted here.
  • Lazy loadsThe walking graph (1.37 MB, 454 KB gzipped) is fetched only when Make your journey opens. Sea and weather are fetched only when the beach panel or Run mode is on; boats only once their feed answers; card photos load with the card.
  • One request per viewEvery layer is a GeoJSON source made from the embedded data at load, so switching views costs no request. Buildings are found once their tiles are on screen (queryRenderedFeatures), not in advance.
  • Reduced motionWith prefers-reduced-motion, tours jump instead of flying, Run it shows the finish, and the journey video becomes one still.

Deep links

Every view, mode and card has an address, and the address bar always links to what's on screen. The hash holds them joined with &: one view, the modes, and one open card.

LinkOpens
#tourThe real-places tour: flies from place to place, one card at a time
#planesThe sky view: live aircraft over Miami in 3D
#oceanOcean Drive from above (beach mode is the default look)
#downtownDowntown and Brickell
#discoverThe Discover Miami tour (16 sights with credited photos)
#artThe Art Week fairs
#nightlifeClubs and venues, their buildings lit
#nighttourA tour of the clubs
#thingsThings to do
#oldOld Miami: the places gone and still standing
#oldtourThe Old Miami tour
#sportsSports venues with each team's next home game
#progressMiami in progress: towers under construction, approved or proposed
#boatsLive boats (only once the AIS feed is switched on; hidden until /api/boats answers)
#camsLive cams: public YouTube live streams from the cameras' owners, as camera pins
#cam=coral-city-cameraOne live cam's card (the player loads only when you click play)
#runRunning mode: every route as a line, run clubs as dots, conditions now
#run=venetian-causewayOne route's card, with its GPX and page
#run=miami-marathon-2027&goRun it: the character runs the route, the camera behind
#p=ocean-drive-art-deco-stripA real place's card (n= a club, t= a thing to do, d= a Discover stop, f= a fair, e= an event venue, o= Old Miami, g= a sports venue, w= a tower)
#b=1The Signature Bridge card
#here=25.7617,-80.1918What's near here for any point: walk times, stations, what we list close by
#view=25.76170,-80.19180,30,90&sun=2026-12-21T16:00The view and the sun from a floor: lat,lng,floor,bearing, then the time
#neonNeon mode (#night: the plain night look)
#journey=p:ocean-drive-art-deco-strip~p:lummus-park-and-muscle-beach-south-beachA journey of stops, walked along the streets (#journey alone opens the builder)
/map/j/p:ocean-drive-art-deco-strip~p:lummus-park-and-muscle-beach-south-beach/The same journey as its own page, with a preview card and GPX, TCX and FIT files
/map/s/p/ocean-drive-art-deco-strip/Any card or view as a page with its own preview, for link unfurls (WhatsApp, Slack, X)
?takeover=1The launch-week opening on any day
?clean=1&c=-80.1318,25.7795,15.4,62,-28No buttons or panels (the clip recorder), and the camera as lng,lat,zoom,pitch,bearing
?creator=1Make a clip: pick spots, a format and a caption

Combine them: /map/#run=venetian-causeway&neon. Link previews never see the hash, so each card also has a /map/s/… page that forwards to it.

Downloads

The map's layers as GeoJSON (RFC 7946, [lng, lat], at most 6 decimals), each with its licence in the file:

  • vice-city-real-places.geojsonThe real places behind Vice City (Grand Theft Auto VI), as points: 40 features · CC BY 4.0
  • miami-running-routes.geojsonRunning routes in Miami, as lines: 15 features · ODbL 1.0 (geometry from OpenStreetMap), properties CC BY 4.0
  • miami-race-courses.geojsonRace courses in Miami (marathon and half), as lines: 2 features · ODbL 1.0 (geometry from OpenStreetMap), properties CC BY 4.0
  • miami-race-starts.geojsonRace starts in Miami-Dade, as points: 17 features · ODbL 1.0 (geometry from OpenStreetMap), properties CC BY 4.0
  • miami-give-back.geojsonWays to give back in Miami-Dade, as points: 18 features · ODbL 1.0 (geometry from OpenStreetMap), properties CC BY 4.0
  • miami-run-clubs.geojsonRun clubs in Miami: where they meet, as points: 16 features · ODbL 1.0 (geometry from OpenStreetMap), properties CC BY 4.0

The same places, events, hotel price index and private-jet counts as CSV and JSON, and the running routes as GPX, FIT and TCX: datasets, running.

Licences and attribution

  • Map data© OpenStreetMap contributors, ODbL 1.0. Vector tiles © OpenMapTiles, served by OpenFreeMap. The credits are on the map at all times; on phones they fold to one line with ⓘ for the rest.
  • Aircraftadsb.lol, ODbL. Our private-jet counts are built from its archive, so they are ODbL too.
  • Sea and weatherNOAA (Tides & Currents, National Data Buoy Center, National Weather Service) and the US EPA: public domain.
  • PhotosWikimedia Commons (and a few Flickr) photos under the licence shown with each, credited on the card. Ours to show, not to relicense.
  • Our dataThe places, confidence, sources and notes: CC BY 4.0. Files that carry OSM-derived geometry (routes, traces, Nominatim points) are ODbL, and say so.
  • FactsWhere a fact comes from Wikipedia, the page links it.
  • Live camsEach stream belongs to its channel, credited and linked on its card, and plays in YouTube's own embedded player under YouTube's terms; we copy no frames.

Lessons learned

  1. A routing service wasn't needed. A walking graph for the busy parts of town, cut down to junctions and shape points, is 454 KB on the wire and loaded only when someone builds a journey; the same A* runs in the browser and the function, so the shared card never draws a different line from the one on screen (264d8fe).
  2. A camera that follows each segment's bearing jerks at every vertex. Run it looks at the path's bearing over a short window behind and ahead, and turns toward it a share at a time the short way round (350° to 10° goes through 0°); the journey video's chase uses the same smoothing (d9ac0e9, 264d8fe).
  3. Point the nose with atan2 along the path it actually flies. The CSS planes on the home page flew backwards at some widths: one keyframe's end sat behind a shared one. Each now flies one straight segment, and its heading is atan2 of that segment in the same units, so it's right at any width (c3f8d64).
  4. Measure the credits; don't guess their height. On phones the button rows sat on the OSM attribution. The fix was to measure it (--attrh, and the zoom-and-credits corner as --brw/--brh, kept current with a ResizeObserver) and stack everything above it, then fold the credits to one line with ⓘ for the full set. Tests guard the CSS (a7c0f41, 2a01d98, 48c49f2).
  5. Keep identifiers out of URLs from day one. Every card got an address, except aircraft: a tail number in a shareable link is a privacy leak, so plane cards never touch the hash (3314e00).

Corrections and questions: hello@whatsonmiami.com. Not affiliated with Rockstar Games or Take-Two Interactive, or with the data providers named.