SpatialConstraint (GRID)

Element Description

The SpatialConstraint elements describes the geographic coverage (spatial constraints) of the grid. The groups elements describes the area of the Earth that a grid covers as a whole. Providing accurate spatial extent metadata is critical for allowing spatially-based data searches in the NASA's Common Metadata Repository (CMR) and other data discovery platforms.  

Best Practices

The grid is reference as a horizontal spatial extent using a Bounding Rectangle representation: The rectangle defined by a north latitude coordinate, south latitude coordinate, east longitude coordinate, and west longitude coordinate. The north bounding latitude may not exceed 90 degrees, the south bounding coordinate may not be less than -90 degrees, the west bounding coordinate may not be less than -180 degrees, and the east bounding coordinate may not exceed 180 degrees. If the 0-360 DegreeProjection element is set to true than the west bounding coordinate may not be less than 0 degrees and may not exceed 360 degrees and the east bounding coordinate may not be less than 0 degrees and may not exceed 360 degrees.

Also, there is the SpatialResolution element within the grid's SpatialConstraint information with units of measurement for distances which is highly recommended.

Examples:

SpatialConstraint": {
   "0_360_DegreeProjection": true,
   "NorthBoundingCoordinate": 90,
   "EastBoundingCoordinate": 0,
   "SouthBoundingCoordinate": -90,
   "WestBoundingCoordinate": 90,
   "SpatialResolution": {
      "Unit": "Degree",
      "LongitudeResolution": "0.0005",
      "LatitudeResolution": "90.000"
   }
}

Element Specification

SpatialConstraint is an optional element. (Cardinality: 0..1)

Metadata Validation

All records undergo schema and business rule validation before entering the system. 

• This element is optional.
• The WestBoundingCoordinate and EastBoundingCoordinate elements' value ranges depends on the 0_360_DegreeProjection element's populated value. If the 0_360_DegreeProjection element is set to "true" than the WestBoundingCoordinate and EastBoundingCoordinate value ranges are set to 0 to 360 and are validated using the JSON Schema 7 If-then-Else condition "CoordinateCondition" within the GRID schema.
• The SpatialResolution elements' value ranges are defined in the GRID schema's condition statements which also is using to validated the grid provider's entries.  

History

GRID Versioning