NLDI Nearby Stations API

Find NWIS stations near a coordinate via USGS NLDI network navigation. Returns stations labeled as upstream/downstream and navigation path.

POST /api/usgswater/nearby

Request Body

{
  "lon": -95.3698,
  "lat": 29.7604,
  "networkDistanceKm": 50,
  "includeUpstreamMain": true,
  "includeUpstreamTributaries": true,
  "includeDownstreamMain": true,
  "includeDownstreamDiversions": false,
  "radiusKm": 20
}

Parameters

Parameter	Type	Required	Description
lon	number	Yes	Longitude of the search origin
lat	number	Yes	Latitude of the search origin
networkDistanceKm	number	Yes	Network distance cap (max 100 km)
includeUpstreamMain	boolean	No	Include upstream main navigation (UM)
includeUpstreamTributaries	boolean	No	Include upstream tributaries (UT)
includeDownstreamMain	boolean	No	Include downstream main (DM)
includeDownstreamDiversions	boolean	No	Include downstream diversions (DD)
radiusKm	number	No	Straight-line filter radius (max 50 km)

Response

{
  "origin": { "lon": -95.3698, "lat": 29.7604, "comid": 12345678 },
  "stations": [
    {
      "stationId": "08060700",
      "name": "Brazos River at XYZ",
      "lon": -95.12,
      "lat": 29.45,
      "direction": "UPSTREAM",
      "path": "UM",
      "networkDistanceKm": 12.34
    }
  ]
}

Errors

Code	Description
400 BAD_REQUEST	Invalid inputs
502 UPSTREAM_ERROR	NLDI failures or timeout

Sources

• USGS NLDI API