Global Paths

[sdl60660]

Changes

This incorporates the new MERIT River Runner API for generating global flowpaths (more information here).

Additionally, addresses a whole host of issues associated with expanding globally, given that there were a lot of assumptions made in building the US-only version that do not hold here. A partial list is documented here:

Some features of notes besides geographic expansion:

• Fixes the clipped beginnings/ends of paths that came about as a result of path smoothing
• Expands stopping feature list significantly, particularly for ocean features, and incorporates inland lakes into navigation path
• Adds a modal for suggesting names when missing (name data coverage is lacking significantly on non-US paths, relatively)
• Fixes disjointedness from flight to path start by accurately gathering terrain-exaggeration-adjusted elevation data prior to run start

Issues of Concern

Note: due to some lingering issues, this version is considered in beta and will not yet be merged into main. It will also exist on a separate URL, here: https://river-runner-global.samlearner.com/, while the original US-only version persists on the original URL, here: https://river-runner.samlearner.com/. Some of these issues will be addressed in the front-end in this repo, others are issues being addressed in the underlying data/API. A few of these issues are notably worse in the global app than in the US-only app, for US flowpaths, which is part of the rationale of maintaining both, for the time being.

A partial list of issues being addressed:

• Incomplete feature name coverage, particularly outside of the United States
• Issues with over-grouping on feature names for paths that run through large inland lakes (many of these are documented here: Potential Path Issues ksonda/global-river-runner#25)
• Paths may not reflect true river paths when affected by engineered features such as dams, canals, and conduits (the Chicago Sanitary and Ship Canal is a notable example of this)
• The current Mercator projection is not ideal for the global view. Currently, it's the only available Mapbox GL projection suitable for this application, but that is due to change soon with a release of a 3D globe view. When this feature is ready from Mapbox, it will be incorporated into the app.

[vercel]

This pull request is being automatically deployed with Vercel (learn more).
To see the status of your deployments, click below or on the icon next to each commit.

river-runner-global – ./

🔍 Inspect: https://vercel.com/samlearner/river-runner-global/Fu2nuRcJEpK6p3saCrN6WsJ8zGf2
✅ Preview: https://river-runner-global.vercel.app

river-runner – ./

🔍 Inspect: https://vercel.com/samlearner/river-runner/S4YPQ1YLD9i4GZmag31XVpBhDSi5
✅ Preview: https://river-runner-git-global-samlearner.vercel.app