覆盖范围商店¶
A coverage store 包含栅格格式空间数据。
/workspaces/<ws>/coveragestores[.<format>]¶
控制给定工作区中的所有覆盖率存储。
方法 |
行动 |
状态代码 |
格式 |
默认格式 |
|---|---|---|---|---|
GET |
列出工作区中的所有覆盖范围存储 |
200 |
HTML、XML、JSON |
HTML |
POST |
创建新的覆盖范围商店 |
201带 |
XML、JSON |
|
PUT |
405 |
|||
DELETE |
405 |
/workspaces/<ws>/coveragestores/<cs>[.<format>]¶
控制给定工作区中的特定覆盖率存储。
方法 |
行动 |
状态代码 |
格式 |
默认格式 |
参数 |
|---|---|---|---|---|---|
GET |
退货覆盖范围商店 |
200 |
HTML、XML、JSON |
HTML |
|
POST |
405 |
||||
PUT |
修改覆盖范围存储 |
||||
DELETE |
删除覆盖率存储区 |
例外情况¶
例外 |
状态代码 |
|---|---|
获取不存在的覆盖率存储区 |
404 |
更改覆盖范围存储的名称 |
403 |
放置Coverage Store的Changes工作区 |
403 |
根据包含已配置覆盖率的覆盖率存储区删除 |
403 |
参数¶
recurse¶
这个 recurse 参数以递归方式删除覆盖率存储区引用的所有层。此参数的允许值为“真”或“假”。默认值为“假”。
purge¶
这个 purge 参数用于自定义磁盘上文件的删除（在底层读卡器实现删除方法的情况下）。它可以取三个值之一：
none-（ 违约 ）不要从磁盘上删除任何存储区的文件。metadata-只删除辅助文件和元数据。建议不要从磁盘中删除数据文件（如颗粒）。all-清除与该存储相关的所有内容（元数据和颗粒）。
quietOnNotFound¶
这个 quietOnNotFound 参数避免在覆盖率存储不存在时记录异常。请注意，404状态代码仍将返回。
/workspaces/<ws>/coveragestores/<cs>/file[.<extension>]¶
此端点允许将包含空间数据的文件（通过POST或PUT）添加到现有覆盖率存储区中，或者在不存在的情况下创建新的覆盖率存储区。如果覆盖存储包含多个覆盖（例如netcdf文件的mosaic），所有覆盖都将配置，除非 configure=false 被指定为参数。
方法 |
行动 |
状态代码 |
格式 |
默认格式 |
参数 |
|---|---|---|---|---|---|
GET |
已弃用 .以mime类型的zip文件形式获取覆盖率存储区的基础文件 |
200 |
|||
POST |
如果覆盖存储是一个简单的存储（例如geotiff），它将返回405；如果覆盖存储是一个结构化的存储（例如mosaic），它将把指定的文件收集到其中，从而将文件集成到存储中。收获的意义取决于存储，对于mosaic，新文件将作为mosaic的新颗粒添加，现有文件将更新其属性，其他存储可能有不同的行为。 |
405如果覆盖存储是一个简单的存储，则200如果是结构化的，并且收获操作成功 |
|||
PUT |
创建或覆盖覆盖率存储区的文件 |
200 |
|||
DELETE |
405 |
备注
一个文件可以作为一个独立的或压缩的存档文件放在覆盖存储区中。独立文件仅适用于使用单个文件（如geotiff store）的覆盖率存储区。使用多个文件的覆盖率存储区（如ImageMosaic存储区）必须作为zip存档发送。
上载独立文件时，请设置 Content-type 基于文件类型。如果要加载zip存档，请设置 Content-type 到 application/zip .
例外情况¶
例外 |
状态代码 |
|---|---|
获取不存在的数据存储 |
404 |
获取不基于文件的数据存储 |
404 |
参数¶
extension¶
这个 extension 参数指定覆盖率存储区的类型。支持以下扩展：
延伸 |
覆盖范围存储 |
|---|---|
吉奥蒂夫 |
GeoTIFF |
世界文学 |
地理参考图像（jpeg、png、tiff） |
图像镶嵌 |
图像马赛克 |
configure¶
这个 configure 参数控制文件上载时覆盖率存储的配置方式。它可以取三个值之一：
first-（ 违约 ）仅设置覆盖范围存储中可用的第一个功能类型。none-不要配置任何功能类型。all-配置所有功能类型。
coverageName¶
这个 coverageName 参数指定覆盖率存储区中覆盖率的名称。只有当 configure 参数不等于“无”。如果未指定，则结果覆盖率将接收与其包含的覆盖率存储区相同的名称。
备注
目前覆盖存储和覆盖之间存在一对一的关系。但是，有计划支持多维覆盖，因此此参数可能会更改。
recalculate¶
这个 recalculate 参数指定是否重新计算覆盖范围的任何边界框。覆盖范围的某些属性会在必要时自动重新计算。特别是，当投影或投影策略更改时，将重新计算本机边界框。当重新计算本机边界框或在请求中显式提供新的本机边界框时，将重新计算lat/long边界框。（当本机和lat/long边界框显式包含在请求中时，不会自动重新计算它们。）此外，客户端可以显式请求一组固定字段进行计算，方法是在 recalculate 参数。例如：
recalculate=（空参数）-无论投影、投影策略等如何，都不要计算任何字段。这可能有助于避免在对大型数据集进行操作时进行缓慢的重新计算。recalculate=nativebbox-重新计算本机边界框，但不重新计算lat/长边界框。recalculate=nativebbox,latlonbbox-重新计算本机边界框和lat/long边界框。
filename¶
这个 filename 参数指定需要作为马赛克的一部分获取的文件的目标文件名。这对于避免冲突和确保正确的尺寸值以多维马赛克的名义可用非常重要。
filename=`NCOM_wattemp_000_20081102T0000000_12.tiff` Set the uploaded file name to ``NCOM_wattemp_000_20081102T0000000_12.tiff