OSM/HydroLAKES layers, opt-in rivers/ponds, and nearest-water API

[dillonstreator]

Summary

Re-source water coverage from upstream OSM and HydroLAKES, make layers opt-in per host, add optional inland rivers/ponds, and ship a nearest-shoreline API with a map demo control.

1. Replace geo-maps with OSM oceans/seas + HydroLAKES

The @geo-maps/earth-waterbodies-1m package is unmaintained (~2017 OSM vintage). Data now comes from upstream:

• Oceans & seas — OSM coastline water polygons (ODbL)
• Inland lakes & reservoirs — HydroLAKES v1.0 ≥ 2 km² (CC-BY 4.0)

Lake Superior, the Caspian Sea, and ~90k other lakes now return water: true. Dataset update checks poll OSM Last-Modified / ETag instead of the npm registry.

2. Opt-in coverage layers

Coverage is {feature}:{precision} via WATER_LAYERS:

WATER_LAYERS=oceans:medium,lakes:medium   # default
WATER_LAYERS=oceans:full,lakes:high       # finer shorelines, more lakes
WATER_LAYERS=oceans                       # oceans only

data/layers.json declares delivery (bundled, download, or range). WATER_LAYERS_REGISTRY can point at a custom registry.

3. Query FlatGeobuf’s packed R-tree directly

GDAL already writes a Hilbert R-tree into the FGB; the old in-memory RBush rebuild was redundant. Lookups use a point-sized bbox against the file index.

	before	after
resident memory	~1049 MB	~294 MB (oceans+lakes medium)
startup	~2.0 s	~554 ms

4. Optional rivers & ponds (Geofabrik extracts)

Global rivers:medium and ponds:medium are built from continent PBFs and published as GitHub release assets (data-v1). They stay opt-in (delivery: download); default coverage remains oceans + lakes.

5. GET /api/nearest + demo map control

• Query: lat, lon, optional count (1–25), type, maxKm
• Response: shoreline snaps ranked by distance, then area
• Homepage: on land results, a Leaflet Find nearest water control plots hits and fits bounds

Notes for the reviewer

• isOnWater() is async and returns layer. water: false means “not in any enabled layer”; use GET /api/layers for what an instance has loaded.
• Nearest hits are shoreline coordinates — they may not return water: true from /api/water (ring is outside polygon fill).
• Oceans/lakes medium stay bundled; rivers/ponds download from the data-v1 release.

Test plan

• pnpm test
• pnpm exec tsc --noEmit / pnpm build
• Layer selector + opt-in runtime tests
• Nearest API + homepage content assertions
• Confirm nightly dataset-update workflow on CI runner memory
• Smoke the demo: land click → Find nearest water → pins + JSON

[dillonstreator]

Rivers & ponds follow-up

Added opt-in rivers and ponds layers sourced from Geofabrik continent OSM PBFs (GDAL OSM driver → FlatGeobuf):

Layer	What it covers	Medium artifact
rivers	OSM water=river / water=canal / waterway=riverbank area polygons	58k features, 19.5 MB
ponds	Other inland natural=water / reservoirs in 0.01–2 km² (complements HydroLAKES)	325k features, 28.8 MB

Enable with WATER_LAYERS=oceans,lakes,rivers,ponds (default stays oceans+lakes).

Coverage caveat: the bundled medium artifacts currently include Antarctica, Central America, Australia-Oceania, and South America. Africa / Europe / Asia / North America PBFs are cached locally but the Africa extract OOMed Docker after filling the C: volume; re-run GEOFABRIK_REGIONS=… pnpm dataset:build:inland once Docker has disk headroom to extend the same artifacts. The registry scope field lists which regions each artifact covers.

Stream centerlines remain out of scope — only mapped riverbank polygons count, which is why a point on a narrow stream may still return water: false.

[cursor]

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

[dillonstreator]

Global inland layers

Rivers and ponds now cover all 8 Geofabrik continents and are published as release assets (too large for git):

• Release: https://github.com/osbytes/is-on-water/releases/tag/data-v1
• rivers:medium — ~138 MB gzip, 596,653 features
• ponds:medium — ~820 MB gzip, 10,077,531 features

delivery: download in data/layers.json. Oceans/lakes remain bundled. Default WATER_LAYERS is still oceans+lakes only; rivers/ponds stay opt-in.