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"
    }
  }
}