Locate a nearby mapped stream for drainage exploration

Source: R/drainage_exploration.R

Uses hydrogeofetch's NLDI hydrolocation service. Only results within 200 metres of the supplied point are accepted: more distant raindrop-trace results are refused rather than described as nearest-stream snaps. This is NHDPlusV2 reference hydrography, not a surveyed channel or a terrain-derived FG network.

locate_drainage_stream(point)

Arguments

point

One nonempty sf or sfc POINT with a known CRS.

Value

A `fg_drainage_location` list with `query_point`, `snapped_point`, `flowline` (sf in EPSG:4326), `comid`, `snap_distance_m`, `retrieved_at`, and `method`. Service failure or an unusable/ambiguous location raises an error.