# Bridge and expressway alignment sources

The transport layer uses OpenStreetMap highway geometry for horizontal road
alignment. It is a contextual model, not engineering or navigation data.

The checked-in snapshot contains 758 OSM ways. The browser layer uses 624
highway ways, including 285 interchange/ramp ways. It includes Staten Island
Expressway, West Shore Expressway, Dr. Martin Luther King Jr. Expressway and
Korean War Veterans Parkway, plus the bridge approaches. The four Verrazzano
deck carriageways are included as connections to the existing two-deck model:
the upper deck (OSM layer 3) and the lower deck (layer 2); the restricted
reversible median lane is left out. The source snapshot also retains other
nearby ways for audit; these are not all rendered.

`osm-source.json` preserves the source response with original way IDs, node IDs,
tags and WGS84 coordinates. `overpass-query.txt` records the acquisition query.
`tools/prepare-transport-network.py` transforms coordinates from EPSG:4326 into
EPSG:6539 US survey feet, multiplies by exactly `1200/3937`, and subtracts the
model's metre origin `[292600, 50500]`. The exported coordinate convention is
`[east, north]`; the viewer uses `(east, elevation, -north)`.

The derived `transport-network-data.js` exports:

- `BRIDGES`: full approach centerline, central-span stations, dimensions and
  source way IDs for Bayonne, Goethals and Outerbridge Crossing.
- `HIGHWAYS`: original individual directional highway/ramp ways with their
  source node IDs, tags, lane count and estimated width. Shared OSM nodes retain
  identical projected coordinates; no straight road connections are invented.
- `TRANSPORT_SOURCES`: acquisition/projection/license metadata and references.

OpenStreetMap data is © OpenStreetMap contributors, available under the Open
Database License. See <https://www.openstreetmap.org/copyright>.

The snapshot was acquired from the public VK Maps Overpass mirror at
<https://maps.mail.ru/osm/tools/overpass/api/interpreter>, using validated TLS
with the preparation environment's certificate bundle. Its OSM base timestamp
and SHA-256 are recorded in `TRANSPORT_SOURCES`. The network layer requires no
live third-party request in the browser.

## Bridge alignment and structural placement

Each bridge's two source carriageways are joined by source node IDs, oriented
from Staten Island toward New Jersey, then clipped to common longitudinal
cross-sections before the axis is averaged. This avoids shifting the centerline
when one named source carriageway extends farther inland than the other. All
original highway ways remain available at these endpoints.

Main spans are centered between mapped structural support footprints; the long
approach outline is not used to locate the channel span. Coordinates for each
support polygon use its area centroid, independent of vertex density.

| Crossing | Structural support OSM ways | Axis length | Main span stations |
| --- | --- | ---: | ---: |
| Bayonne | 1013440560, 1016686886 | 2,092.85 m | 750.01–1,260.55 m |
| Goethals | 1016689044, 1016689045, 1016689046, 1016689047 | 2,213.81 m | 1,020.05–1,294.37 m |
| Outerbridge | 1016687789, 1016687791 | 3,001.94 m | 1,068.80–1,297.40 m |

These named approach lengths do not claim to be official total bridge lengths.
Goethals' twin-deck separation is derived from the two mapped carriageways at
the main span; lane widths and shoulder widths remain illustrative. Bayonne
support footprints are wider than the exact arch spring points, so authoritative
span length is centered between them rather than equated to centroid distance.

## Structural references

- Bayonne: Port Authority, *The Beautiful Arch — Bayonne Bridge*, statistics
  brochure, documents a 1,675 ft arch span, 325 ft arch crown above water,
  99.5 ft bridge width and raised 215 ft midspan navigational clearance.
  <https://www.panynj.gov/bridges-tunnels/en/bayonne-bridge/facts-info.html>
  <https://corpinfo.panynj.gov/content/dam/bridges-tunnels/bayonne-bridge-shpo-documents/Bayonne%20Bridge%20Brochure.pdf>
- Goethals: the current crossing comprises twin cable stayed structures,
  replacing the old cantilever bridge in 2017–2018. The 900 ft main span is
  documented by the Coast Guard's 2010 final EIS notice; proposed tower tops
  were 272 ft above mean sea level. The contextual model does not represent
  these as a surveyed NAVD88 elevation.
  The current Port Authority fact sheet reports minimum clearance of 138.5 ft
  above mean high water (42.2148 m).
  <https://www.panynj.gov/bridges-tunnels/en/goethals-bridge/facts-info.html>
  <https://www.govinfo.gov/content/pkg/FR-2010-08-13/pdf/FR-2010-08-13.pdf>
  <https://portfolio.panynj.gov/2018/05/21/the-new-goethals-bridge-complete-and-open-for-business/>
- Outerbridge: Port Authority fact sheet; central main span 750 ft, overall
  bridge width 62 ft, navigational clearance 143 ft. The 2,100 ft through-truss
  assembly includes cantilever/anchor arms beyond the main channel span.
  <https://www.panynj.gov/bridges-tunnels/en/Outerbridge-crossing/facts-info.html>

Published clearances are above water and are **not** ground-datum elevations.
Deck elevations, profiles, structural member sizes, cross-sections and ramp
heights are illustrative. The deck surface includes a visual structural
allowance above published clearance. Terrain elevations come from the existing
terrain layer at runtime. Geometry remains unexaggerated; the viewer applies
vertical exaggeration once to the transport group.

## Rebuild

Install `pyproj` and `certifi` in a preparation environment, then run:

```text
python tools/prepare-transport-network.py --refresh
python tools/prepare-transport-network.py
```

Only `--refresh` requires network access. Do not refresh a reviewed snapshot
solely to rebuild the browser assets.
