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.