United States Army Corps of Engineers · Schema

CWMS Location

A physical location managed by the U.S. Army Corps of Engineers in the Corps Water Management System.

EngineeringFederal-GovernmentWater ResourcesHydrologyCivil Engineering

Properties

Name	Type	Description
name	string	The CWMS location identifier (e.g., DALT2, BIGE2)
office-id	string	Three-character USACE district office code (e.g., SWT, LRN)
latitude	number	Decimal latitude in WGS84
longitude	number	Decimal longitude in WGS84
elevation	numbernull	Elevation in the specified datum and unit
horizontal-datum	string	Horizontal datum (e.g., WGS84, NAD83)
vertical-datum	string	Vertical datum (e.g., NAVD88, NGVD29)
elevation-units	string	Unit for elevation measurement (ft or m)
public-name	string	Short public-facing name
long-name	string	Full descriptive name
description	string	Descriptive text about the location
kind	string	CWMS location kind
type	string	Location type classification
state-initial	string	Two-character U.S. state abbreviation
county-name	string	County name
timezone-name	string	IANA timezone name (e.g., US/Central)
nation	string	Nation code (e.g., US)
nearest-city	string	Name of the nearest city

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://cwms-data.usace.army.mil/cwms-data/schemas/location",
  "title": "CWMS Location",
  "description": "A physical location managed by the U.S. Army Corps of Engineers in the Corps Water Management System.",
  "type": "object",
  "required": ["name", "office-id"],
  "properties": {
    "name": {
      "type": "string",
      "description": "The CWMS location identifier (e.g., DALT2, BIGE2)"
    },
    "office-id": {
      "type": "string",
      "description": "Three-character USACE district office code (e.g., SWT, LRN)",
      "minLength": 2,
      "maxLength": 5
    },
    "latitude": {
      "type": "number",
      "minimum": -90,
      "maximum": 90,
      "description": "Decimal latitude in WGS84"
    },
    "longitude": {
      "type": "number",
      "minimum": -180,
      "maximum": 180,
      "description": "Decimal longitude in WGS84"
    },
    "elevation": {
      "type": ["number", "null"],
      "description": "Elevation in the specified datum and unit"
    },
    "horizontal-datum": {
      "type": "string",
      "description": "Horizontal datum (e.g., WGS84, NAD83)"
    },
    "vertical-datum": {
      "type": "string",
      "description": "Vertical datum (e.g., NAVD88, NGVD29)"
    },
    "elevation-units": {
      "type": "string",
      "description": "Unit for elevation measurement (ft or m)"
    },
    "public-name": {
      "type": "string",
      "description": "Short public-facing name"
    },
    "long-name": {
      "type": "string",
      "description": "Full descriptive name"
    },
    "description": {
      "type": "string",
      "description": "Descriptive text about the location"
    },
    "kind": {
      "type": "string",
      "description": "CWMS location kind",
      "enum": [
        "SITE",
        "STREAM_LOCATION",
        "PROJECT",
        "TURBINE",
        "EMBANKMENT",
        "LOCK",
        "OUTLET",
        "OVERFLOW",
        "BASE_RATING_TABLE"
      ]
    },
    "type": {
      "type": "string",
      "description": "Location type classification"
    },
    "state-initial": {
      "type": "string",
      "description": "Two-character U.S. state abbreviation",
      "minLength": 2,
      "maxLength": 2
    },
    "county-name": {
      "type": "string",
      "description": "County name"
    },
    "timezone-name": {
      "type": "string",
      "description": "IANA timezone name (e.g., US/Central)"
    },
    "nation": {
      "type": "string",
      "description": "Nation code (e.g., US)",
      "default": "US"
    },
    "nearest-city": {
      "type": "string",
      "description": "Name of the nearest city"
    }
  }
}