Coverage stores

A coverage store contains raster format spatial data.

/workspaces/<ws>/coveragestores[.<format>]

Controls all coverage stores in a given workspace.

Method Action Status code Formats Default Format
GET List all coverage stores in workspace ws 200 HTML, XML, JSON HTML
POST Create a new coverage store 201 with Location header XML, JSON  
PUT   405    
DELETE   405    

/workspaces/<ws>/coveragestores/<cs>[.<format>]

Controls a particular coverage store in a given workspace.

Method Action Status code Formats Default Format Parameters
GET Return coverage store cs 200 HTML, XML, JSON HTML quietOnNotFound
POST   405      
PUT Modify coverage store cs        
DELETE Delete coverage store cs       recurse, purge

Exceptions

Exception Status code
GET for a coverage store that does not exist 404
PUT that changes name of coverage store 403
PUT that changes workspace of coverage store 403
DELETE against a coverage store that contains configured coverage 403

Parameters

recurse

The recurse parameter recursively deletes all layers referenced by the coverage store. Allowed values for this parameter are “true” or “false”. The default value is “false”.

purge

The purge parameter is used to customize the delete of files on disk (in case the underlying reader implements a delete method). It can take one of the three values:

  • none-(Default) Do not delete any store’s file from disk.
  • metadata-Delete only auxiliary files and metadata. It’s recommended when data files (such as granules) should not be deleted from disk.
  • all-Purge everything related to that store (metadata and granules).

quietOnNotFound

The quietOnNotFound parameter avoids to log an Exception when the coverage store is not present. Note that 404 status code will be returned anyway.

/workspaces/<ws>/coveragestores/<cs>/file[.<extension>]

This end point allows a file containing spatial data to be added (via a POST or PUT) into an existing coverage store, or will create a new coverage store if it doesn’t already exist. In case of coverage stores containing multiple coverages (e.g., mosaic of NetCDF files) all the coverages will be configured unless configure=false is specified as a parameter.

Method Action Status code Formats Default Format Parameters
GET Deprecated. Get the underlying files for the coverage store as a zip file with MIME type application/zip. 200      
POST If the coverage store is a simple one (e.g. GeoTiff) it will return a 405, if the coverage store is a structured one (e.g., mosaic) it will harvest the specified files into it, which in turn will integrate the files into the store. Harvest meaning is store dependent, for mosaic the new files will be added as new granules of the mosaic, and existing files will get their attribute updated, other stores might have a different behavior. 405 if the coverage store is a simple one, 200 if structured and the harvest operation succeded     recalculate
PUT Creates or overwrites the files for coverage store cs 200 See note below :set spell spelllang=en_us configure, coverageName
DELETE   405      

Note

A file can be PUT to a coverage store as a standalone or zipped archive file. Standalone files are only suitable for coverage stores that work with a single file such as GeoTIFF store. Coverage stores that work with multiple files, such as the ImageMosaic store, must be sent as a zip archive.

When uploading a standalone file, set the Content-type appropriately based on the file type. If you are loading a zip archive, set the Content-type to application/zip.

Exceptions

Exception Status code
GET for a data store that does not exist 404
GET for a data store that is not file based 404

Parameters

extension

The extension parameter specifies the type of coverage store. The following extensions are supported:

Extension Coverage store
geotiff GeoTIFF
worldimage Georeferenced image (JPEG, PNG, TIFF)
imagemosaic Image mosaic

configure

The configure parameter controls how the coverage store is configured upon file upload. It can take one of the three values:

  • first—(Default) Only setup the first feature type available in the coverage store.
  • none—Do not configure any feature types.
  • all—Configure all feature types.

coverageName

The coverageName parameter specifies the name of the coverage within the coverage store. This parameter is only relevant if the configure parameter is not equal to “none”. If not specified the resulting coverage will receive the same name as its containing coverage store.

Note

At present a one-to-one relationship exists between a coverage store and a coverage. However, there are plans to support multidimensional coverages, so this parameter may change.

recalculate

The recalculate parameter specifies whether to recalculate any bounding boxes for a coverage. Some properties of coverages are automatically recalculated when necessary. In particular, the native bounding box is recalculated when the projection or projection policy is changed. The lat/long bounding box is recalculated when the native bounding box is recalculated or when a new native bounding box is explicitly provided in the request. (The native and lat/long bounding boxes are not automatically recalculated when they are explicitly included in the request.) In addition, the client may explicitly request a fixed set of fields to calculate by including a comma-separated list of their names in the recalculate parameter. For example:

  • recalculate= (empty parameter)—Do not calculate any fields, regardless of the projection, projection policy, etc. This might be useful to avoid slow recalculation when operating against large datasets.
  • recalculate=nativebbox—Recalculate the native bounding box, but do not recalculate the lat/long bounding box.
  • recalculate=nativebbox,latlonbbox—Recalculate both the native bounding box and the lat/long bounding box.