Observations

Search observation data using any one of three methods:

• Search by country code or by country code and administrative area.
• Search by a bounding box, defined by latitude and longitude values.
• Return all available observations.

Observations by country code or by country code and administrative area

Example

[ { "observation": { "dateTime": "2024-04-09T15:30:00-04:00", "height": { "value": 1.3, "unit": "m", } }, "categories": { "action": { "value": 1.8, "unit": "m", }, "flood": { "value": 3.7, "unit": "m", }, "moderate": { "value": 4.6, "unit": "m", }, "major": { "value": 5.5, "unit": "m", }, "lowThreshold": null }, "id": "AFRV2", "location": { "name": "Alexandria", "countryCode": "US", "adminCode": "VA" }, "waterBody": "Four Mile Run", "status": { "name": "No Flooding", "colorHex": "#00ff00" } }, { "observation": { "dateTime": "2024-04-09T14:45:00-04:00", "height": { "value": 1.1, "unit": "m", } }, "categories": { "action": { "value": 3.4, "unit": "m", }, "flood": { "value": 3.7, "unit": "m", }, "moderate": null, "major": null, "lowThreshold": null }, "id": "AHLV2", "location": { "name": "Ashland", "countryCode": "US", "adminCode": "VA" }, "waterBody": "South Anna River", "status": { "name": "No Flooding", "colorHex": "#00ff00" } }, { "observation": { "dateTime": "2024-04-09T15:12:00-04:00", "height": { "value": -0, "unit": "m", } }, "categories": { "action": { "value": 1.2, "unit": "m", }, "flood": { "value": 2.1, "unit": "m", }, "moderate": { "value": 3, "unit": "m", }, "major": { "value": 3.7, "unit": "m", }, "lowThreshold": null }, "id": "ALEV2", "location": { "name": "Highway 1 at Alexandria", "countryCode": "US", "adminCode": "VA" }, "waterBody": "Four Mile Run", "status": { "name": "No Flooding", "colorHex": "#00ff00" } }, {... } ]

Top of page

Observations by bounding box

Example

{ "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "coordinates": [ -97.7933349609375, 30.221111297607422 ], "type": "Point" }, "properties": { "observation": { "dateTime": "2024-04-09T19:30:00+00:00", "height": 0.6 }, "categories": { "action": null, "flood": 4, "moderate": 4.3, "major": 5.5, "lowThreshold": null }, "id": "AAIT2", "location": { "name": "Manchaca Road at Austin", "countryCode": "US", "adminCode": "TX" }, "waterBody": "Williamson Creek", "status": { "name": "No Flooding", "colorHex": "#00ff00" } } }, { "type": "Feature", "geometry": { "coordinates": [ -134.7086181640625, 58.85194396972656 ], "type": "Point" }, "properties": { "observation": { "dateTime": "2024-04-09T18:45:00+00:00", "height": 9 }, "categories": { "action": 9.9, "flood": 10.2, "moderate": 10.5, "major": null, "lowThreshold": null }, "id": "AAKA2", "location": { "name": "Auke Bay", "countryCode": "US", "adminCode": "AK" }, "waterBody": "Antler River", "status": { "name": "No Flooding", "colorHex": "#00ff00" } } }, { "type": "Feature", "geometry": { "coordinates": [ -84.40763854980469, 33.82030487060547 ], "type": "Point" }, "properties": { "observation": { "dateTime": "2024-04-09T19:00:00+00:00", "height": 1.6 }, "categories": { "action": 4, "flood": 5.2, "moderate": 5.5, "major": 6.1, "lowThreshold": 0 }, "id": "AANG1", "location": { "name": "Atlanta", "countryCode": "US", "adminCode": "GA" }, "waterBody": "Peachtree Creek", "status": { "name": "No Flooding", "color": "#00ff00" } } }, {... } } ] }

Top of page

All available observations

Example

[ { "observation": { "dateTime": "2024-04-09T19:30:00+00:00", "height": 2 }, "categories": { "action": null, "flood": 13, "moderate": 14, "major": 18, "lowThreshold": null }, "id": "AAIT2", "location": { "name": "Manchaca Road at Austin", "countryCode": "US", "adminCode": "TX" }, "waterBody": "Williamson Creek", "status": { "name": "No Flooding", "colorHex": "#00ff00" } }, { "observation": { "dateTime": "2024-04-09T18:45:00+00:00", "height": 29.5 }, "categories": { "action": 32.5, "flood": 33.5, "moderate": 34.5, "major": null, "lowThreshold": null }, "id": "AAKA2", "location": { "name": "Auke Bay", "countryCode": "US", "adminCode": "AK" }, "waterBody": "Antler River", "status": { "name": "No Flooding", "colorHex": "#00ff00" } }, { "observation": { "dateTime": "2024-04-09T19:00:00+00:00", "height": 5.2 }, "categories": { "action": 13, "flood": 17, "moderate": 18, "major": 20, "lowThreshold": 0 }, "id": "AANG1", "location": { "name": "Atlanta", "countryCode": "US", "adminCode": "GA" }, "waterBody": "Peachtree Creek", "status": { "name": "No Flooding", "colorHex": "#00ff00" } }, {... } ]

Top of page

Stations

Example

{ "type": "FeatureCollection", "features": [ { "type": "Feature", "geometry": { "coordinates": [ -81.98332977294922, 36.68583297729492 ], "type": "Point" }, "properties": { "id": "ABDV2", "goesId": "24415608", "dcpOwner": "TENNVA", "hydrologicServiceArea": "MRX", "location": { "name": "ABINGTON", "countryCode": "US", "adminCode": "VA" } } }, { "type": "Feature", "geometry": { "coordinates": [ -75.57888793945312, 37.956390380859375 ], "type": "Point" }, "properties": { "id": "ACKV2", "goesId": "DD87C722", "dcpOwner": "USGS01", "hydrologicServiceArea": "AKQ", "location": { "name": "ACCOMACK WELL NEAR BULLBEGGER NEAR ACCOMACK 17NE", "countryCode": "US", "adminCode": "VA" } } }, { "type": "Feature", "geometry": { "coordinates": [ -77.08583068847656, 38.84333419799805 ], "type": "Point" }, "properties": { "id": "AFRV2", "goesId": "DE29B16A", "dcpOwner": "USGS01", "hydrologicServiceArea": "LWX", "location": { "name": "FOURMILE RUN NEAR ALEXANDRIA 1SE", "countryCode": "US", "adminCode": "VA" } } }, {... } ] }

Top of page

River status

Example

Top of page