Spatial Extent

Portal Spatial Extents are used to describe the spatial extent of a collection.

See STAC Extent for more details.

SpatialExtent.ts

interface SpatialExtent {
  bbox: number[][];
}

spatial-extent.json

{
  "bbox": [[-122.4194, 37.7749, -122.4009, 37.7892]]
}

General Properties

bbox required

type: number[][]

In [W, S, E, N] order. Using WGS84 longitude/latitude coordinates.

Example that covers the whole Earth: [[-180.0, -90.0, 180.0, 90.0]].

Potential spatial extents covered by the Collection. Each outer array element can be a separate spatial extent describing the bounding boxes of the assets represented by this Collection using either 2D or 3D geometries.

The first bounding box always describes the overall spatial extent of the data. All subsequent bounding boxes can be used to provide a more precise description of the extent and identify clusters of data. Clients only interested in the overall spatial extent will only need to access the first item in each array. It is recommended to only use multiple bounding boxes if a union of them would then include a large uncovered area (e.g. the union of Germany and Chile). Thus, it doesn’t make sense to provide two bounding boxes and the validation will fail in this case.