GeoServer Coverages

A coverage is a raster data set which originates from a coverage store.
More information: http://geoserver.org/comm/
Contact Info: geoserver-users@sourceforge.net
Version: 1.0.0
BasePath:/geoserver/rest
All rights reserved
http://apache.org/licenses/LICENSE-2.0.html

Access

Methods

[ Jump to Models ]

Table of Contents

Coverages

Coverages

Up
delete /workspaces/{workspace}/coverages/{coverage}
(deleteCoverage)
Invalid. Can only delete an individual coverage.

Responses

405

Method not allowed.

Up
delete /workspaces/{workspace}/coverages
(deleteCoverageStore)
Invalid. Can only delete an individual coverage.

Responses

405

Method not allowed.

Up
delete /workspaces/{workspace}/coveragestores/{store}/coverages/{coverage}
(deleteWorkspaceCoverage)
Delete a coverage (optionally recursively deleting layers).

Path parameters

workspace (required)
Path Parameter — The name of the workspace
store (required)
Path Parameter — The name of the coverage data store
coverage (required)
Path Parameter — The name of the coverage

Query parameters

recurse (optional)
Query Parameter — The recurse controls recursive deletion. When set to true all stores containing the resource are also removed. default: false

Responses

200

Successfully deleted.

Up
delete /workspaces/{workspace}/coveragestores/{store}/coverages
(deleteWorkspaceCoverageStore)
Invalid. Can only delete an individual coverage.

Responses

405

Method not allowed.

Up
get /workspaces/{workspace}/coverages/{coverage}
(getCoverage)
Get an individual coverage.

Path parameters

workspace (required)
Path Parameter — The name of the workspace
coverage (required)
Path Parameter — The name of the coverage

Query parameters

quietOnNotFound (optional)
Query Parameter — The quietOnNotFound parameter avoids logging an Exception when the coverage is not present. Note that 404 status code will be returned anyway. default: false

Return type

inline_response_200_1

Example data

Content-Type: application/json
"{\n    \"coverage\": {\n        \"abstract\": \"Digital elevation model for the Spearfish region.\\r\\n\\r\\nsfdem is a Tagged Image File Format with Geographic information\",\n        \"defaultInterpolationMethod\": \"nearest neighbor\",\n        \"description\": \"Generated from sfdem\",\n        \"dimensions\": {\n            \"coverageDimension\": [\n                {\n                    \"description\": \"GridSampleDimension[-9.999999933815813E36,-9.999999933815813E36]\",\n                    \"name\": \"GRAY_INDEX\",\n                    \"range\": {\n                        \"max\": -9.999999933815813e+36,\n                        \"min\": -9.999999933815813e+36\n                    }\n                }\n            ]\n        },\n        \"enabled\": true,\n        \"grid\": {\n            \"@dimension\": \"2\",\n            \"crs\": \"EPSG:26713\",\n            \"range\": {\n                \"high\": \"634 477\",\n                \"low\": \"0 0\"\n            },\n            \"transform\": {\n                \"scaleX\": 30,\n                \"scaleY\": -30,\n                \"shearX\": 0,\n                \"shearY\": 0,\n                \"translateX\": 589995,\n                \"translateY\": 4927995\n            }\n        },\n        \"interpolationMethods\": {\n            \"string\": [\n                \"nearest neighbor\",\n                \"bilinear\",\n                \"bicubic\"\n            ]\n        },\n        \"keywords\": {\n            \"string\": [\n                \"WCS\",\n                \"sfdem\",\n                \"sfdem\"\n            ]\n        },\n        \"latLonBoundingBox\": {\n            \"crs\": \"EPSG:4326\",\n            \"maxx\": -103.62940739432703,\n            \"maxy\": 44.5016011535299,\n            \"minx\": -103.87108701853181,\n            \"miny\": 44.370187074132616\n        },\n        \"metadata\": {\n            \"entry\": {\n                \"$\": \"sfdem_sfdem\",\n                \"@key\": \"dirName\"\n            }\n        },\n        \"name\": \"sfdem\",\n        \"namespace\": {\n            \"href\": \"http://localhost:/geoserver/restng/namespaces/sf.json\",\n            \"name\": \"sf\"\n        },\n        \"nativeBoundingBox\": {\n            \"crs\": {\n                \"$\": \"EPSG:26713\",\n                \"@class\": \"projected\"\n            },\n            \"maxx\": 609000,\n            \"maxy\": 4928010,\n            \"minx\": 589980,\n            \"miny\": 4913700\n        },\n        \"nativeCRS\": {\n            \"$\": \"PROJCS[\\\"NAD27 / UTM zone 13N\\\", \\n  GEOGCS[\\\"NAD27\\\", \\n    DATUM[\\\"North American Datum 1927\\\", \\n      SPHEROID[\\\"Clarke 1866\\\", 6378206.4, 294.9786982138982, AUTHORITY[\\\"EPSG\\\",\\\"7008\\\"]], \\n      TOWGS84[2.478, 149.752, 197.726, 0.526, -0.498, 0.501, 0.685], \\n      AUTHORITY[\\\"EPSG\\\",\\\"6267\\\"]], \\n    PRIMEM[\\\"Greenwich\\\", 0.0, AUTHORITY[\\\"EPSG\\\",\\\"8901\\\"]], \\n    UNIT[\\\"degree\\\", 0.017453292519943295], \\n    AXIS[\\\"Geodetic longitude\\\", EAST], \\n    AXIS[\\\"Geodetic latitude\\\", NORTH], \\n    AUTHORITY[\\\"EPSG\\\",\\\"4267\\\"]], \\n  PROJECTION[\\\"Transverse_Mercator\\\"], \\n  PARAMETER[\\\"central_meridian\\\", -105.0], \\n  PARAMETER[\\\"latitude_of_origin\\\", 0.0], \\n  PARAMETER[\\\"scale_factor\\\", 0.9996], \\n  PARAMETER[\\\"false_easting\\\", 500000.0], \\n  PARAMETER[\\\"false_northing\\\", 0.0], \\n  UNIT[\\\"m\\\", 1.0], \\n  AXIS[\\\"Easting\\\", EAST], \\n  AXIS[\\\"Northing\\\", NORTH], \\n  AUTHORITY[\\\"EPSG\\\",\\\"26713\\\"]]\",\n            \"@class\": \"projected\"\n        },\n        \"nativeFormat\": \"GeoTIFF\",\n        \"nativeName\": \"sfdem\",\n        \"requestSRS\": {\n            \"string\": [\n                \"EPSG:26713\"\n            ]\n        },\n        \"responseSRS\": {\n            \"string\": [\n                \"EPSG:26713\"\n            ]\n        },\n        \"srs\": \"EPSG:26713\",\n        \"store\": {\n            \"@class\": \"coverageStore\",\n            \"href\": \"http://localhost:/geoserver/restng/workspaces/sf/coveragestores/sfdem.json\",\n            \"name\": \"sf:sfdem\"\n        },\n        \"supportedFormats\": {\n            \"string\": [\n                \"ARCGRID\",\n                \"IMAGEMOSAIC\",\n                \"GTOPO30\",\n                \"GEOTIFF\",\n                \"GIF\",\n                \"PNG\",\n                \"JPEG\",\n                \"TIFF\"\n            ]\n        },\n        \"title\": \"Spearfish elevation\"\n    }\n}\n"

Example data

Content-Type: application/xml
"\n  sfdem\n  sfdem\n  \n    sf\n    \n  \n  Spearfish elevation\n  Generated from sfdem\n  Digital elevation model for the Spearfish region.\n\nsfdem is a Tagged Image File Format with Geographic information\n  \n    WCS\n    sfdem\n    sfdem\n    type\\@language=fr\\;\\@vocabulary=test\\;\n  \n  PROJCS["NAD27 / UTM zone 13N",\n  GEOGCS["NAD27",\n    DATUM["North American Datum 1927",\n      SPHEROID["Clarke 1866", 6378206.4, 294.9786982138982, AUTHORITY["EPSG","7008"]],\n      TOWGS84[2.478, 149.752, 197.726, 0.526, -0.498, 0.501, 0.685],\n      AUTHORITY["EPSG","6267"]],\n    PRIMEM["Greenwich", 0.0, AUTHORITY["EPSG","8901"]],\n    UNIT["degree", 0.017453292519943295],\n    AXIS["Geodetic longitude", EAST],\n    AXIS["Geodetic latitude", NORTH],\n    AUTHORITY["EPSG","4267"]],\n  PROJECTION["Transverse_Mercator", AUTHORITY["EPSG","9807"]],\n  PARAMETER["central_meridian", -105.0],\n  PARAMETER["latitude_of_origin", 0.0],\n  PARAMETER["scale_factor", 0.9996],\n  PARAMETER["false_easting", 500000.0],\n  PARAMETER["false_northing", 0.0],\n  UNIT["m", 1.0],\n  AXIS["Easting", EAST],\n  AXIS["Northing", NORTH],\n  AUTHORITY["EPSG","26713"]]\n  EPSG:26713\n  \n    589980.0\n    609000.0\n    4913700.0\n    4928010.0\n    EPSG:26713\n  \n  \n    -103.87108701853181\n    -103.62940739432703\n    44.370187074132616\n    44.5016011535299\n    EPSG:4326\n  \n  true\n  \n    \n      \n        false\n      \n    \n    10\n    \n      \n        false\n        \n      \n    \n    true\n    sfdem_sfdem\n  \n  \n    sf:sfdem\n    \n  \n  GeoTIFF\n  \n    \n      0 0\n      634 477\n    \n    \n      30.0\n      -30.0\n      0.0\n      0.0\n      589995.0\n      4927995.0\n    \n    EPSG:26713\n  \n  \n    ARCGRID\n    IMAGEMOSAIC\n    GTOPO30\n    GEOTIFF\n    GIF\n    PNG\n    JPEG\n    TIFF\n  \n  \n    nearest neighbor\n    bilinear\n    bicubic\n  \n  nearest neighbor\n  \n    \n      GRAY_INDEX\n      GridSampleDimension[-9.999999933815813E36,-9.999999933815813E36]\n      \n        -9.999999933815813E36\n        -9.999999933815813E36\n      \n    \n  \n  \n    EPSG:26713\n  \n  \n    EPSG:26713\n  \n\n"

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response containing coverage inline_response_200_1

Example data

Content-Type: application/json
{
    "coverage": {
        "abstract": "Digital elevation model for the Spearfish region.\r\n\r\nsfdem is a Tagged Image File Format with Geographic information",
        "defaultInterpolationMethod": "nearest neighbor",
        "description": "Generated from sfdem",
        "dimensions": {
            "coverageDimension": [
                {
                    "description": "GridSampleDimension[-9.999999933815813E36,-9.999999933815813E36]",
                    "name": "GRAY_INDEX",
                    "range": {
                        "max": -9.999999933815813e+36,
                        "min": -9.999999933815813e+36
                    }
                }
            ]
        },
        "enabled": true,
        "grid": {
            "@dimension": "2",
            "crs": "EPSG:26713",
            "range": {
                "high": "634 477",
                "low": "0 0"
            },
            "transform": {
                "scaleX": 30,
                "scaleY": -30,
                "shearX": 0,
                "shearY": 0,
                "translateX": 589995,
                "translateY": 4927995
            }
        },
        "interpolationMethods": {
            "string": [
                "nearest neighbor",
                "bilinear",
                "bicubic"
            ]
        },
        "keywords": {
            "string": [
                "WCS",
                "sfdem",
                "sfdem"
            ]
        },
        "latLonBoundingBox": {
            "crs": "EPSG:4326",
            "maxx": -103.62940739432703,
            "maxy": 44.5016011535299,
            "minx": -103.87108701853181,
            "miny": 44.370187074132616
        },
        "metadata": {
            "entry": {
                "$": "sfdem_sfdem",
                "@key": "dirName"
            }
        },
        "name": "sfdem",
        "namespace": {
            "href": "http://localhost:/geoserver/restng/namespaces/sf.json",
            "name": "sf"
        },
        "nativeBoundingBox": {
            "crs": {
                "$": "EPSG:26713",
                "@class": "projected"
            },
            "maxx": 609000,
            "maxy": 4928010,
            "minx": 589980,
            "miny": 4913700
        },
        "nativeCRS": {
            "$": "PROJCS[\"NAD27 / UTM zone 13N\", \n  GEOGCS[\"NAD27\", \n    DATUM[\"North American Datum 1927\", \n      SPHEROID[\"Clarke 1866\", 6378206.4, 294.9786982138982, AUTHORITY[\"EPSG\",\"7008\"]], \n      TOWGS84[2.478, 149.752, 197.726, 0.526, -0.498, 0.501, 0.685], \n      AUTHORITY[\"EPSG\",\"6267\"]], \n    PRIMEM[\"Greenwich\", 0.0, AUTHORITY[\"EPSG\",\"8901\"]], \n    UNIT[\"degree\", 0.017453292519943295], \n    AXIS[\"Geodetic longitude\", EAST], \n    AXIS[\"Geodetic latitude\", NORTH], \n    AUTHORITY[\"EPSG\",\"4267\"]], \n  PROJECTION[\"Transverse_Mercator\"], \n  PARAMETER[\"central_meridian\", -105.0], \n  PARAMETER[\"latitude_of_origin\", 0.0], \n  PARAMETER[\"scale_factor\", 0.9996], \n  PARAMETER[\"false_easting\", 500000.0], \n  PARAMETER[\"false_northing\", 0.0], \n  UNIT[\"m\", 1.0], \n  AXIS[\"Easting\", EAST], \n  AXIS[\"Northing\", NORTH], \n  AUTHORITY[\"EPSG\",\"26713\"]]",
            "@class": "projected"
        },
        "nativeFormat": "GeoTIFF",
        "nativeName": "sfdem",
        "requestSRS": {
            "string": [
                "EPSG:26713"
            ]
        },
        "responseSRS": {
            "string": [
                "EPSG:26713"
            ]
        },
        "srs": "EPSG:26713",
        "store": {
            "@class": "coverageStore",
            "href": "http://localhost:/geoserver/restng/workspaces/sf/coveragestores/sfdem.json",
            "name": "sf:sfdem"
        },
        "supportedFormats": {
            "string": [
                "ARCGRID",
                "IMAGEMOSAIC",
                "GTOPO30",
                "GEOTIFF",
                "GIF",
                "PNG",
                "JPEG",
                "TIFF"
            ]
        },
        "title": "Spearfish elevation"
    }
}

Example data

Content-Type: application/xml

  sfdem
  sfdem
  
    sf
    
  
  Spearfish elevation
  Generated from sfdem
  Digital elevation model for the Spearfish region.

sfdem is a Tagged Image File Format with Geographic information
  
    WCS
    sfdem
    sfdem
    type\@language=fr\;\@vocabulary=test\;
  
  PROJCS["NAD27 / UTM zone 13N",
  GEOGCS["NAD27",
    DATUM["North American Datum 1927",
      SPHEROID["Clarke 1866", 6378206.4, 294.9786982138982, AUTHORITY["EPSG","7008"]],
      TOWGS84[2.478, 149.752, 197.726, 0.526, -0.498, 0.501, 0.685],
      AUTHORITY["EPSG","6267"]],
    PRIMEM["Greenwich", 0.0, AUTHORITY["EPSG","8901"]],
    UNIT["degree", 0.017453292519943295],
    AXIS["Geodetic longitude", EAST],
    AXIS["Geodetic latitude", NORTH],
    AUTHORITY["EPSG","4267"]],
  PROJECTION["Transverse_Mercator", AUTHORITY["EPSG","9807"]],
  PARAMETER["central_meridian", -105.0],
  PARAMETER["latitude_of_origin", 0.0],
  PARAMETER["scale_factor", 0.9996],
  PARAMETER["false_easting", 500000.0],
  PARAMETER["false_northing", 0.0],
  UNIT["m", 1.0],
  AXIS["Easting", EAST],
  AXIS["Northing", NORTH],
  AUTHORITY["EPSG","26713"]]
  EPSG:26713
  
    589980.0
    609000.0
    4913700.0
    4928010.0
    EPSG:26713
  
  
    -103.87108701853181
    -103.62940739432703
    44.370187074132616
    44.5016011535299
    EPSG:4326
  
  true
  
    
      
        false
      
    
    10
    
      
        false
        
      
    
    true
    sfdem_sfdem
  
  
    sf:sfdem
    
  
  GeoTIFF
  
    
      0 0
      634 477
    
    
      30.0
      -30.0
      0.0
      0.0
      589995.0
      4927995.0
    
    EPSG:26713
  
  
    ARCGRID
    IMAGEMOSAIC
    GTOPO30
    GEOTIFF
    GIF
    PNG
    JPEG
    TIFF
  
  
    nearest neighbor
    bilinear
    bicubic
  
  nearest neighbor
  
    
      GRAY_INDEX
      GridSampleDimension[-9.999999933815813E36,-9.999999933815813E36]
      
        -9.999999933815813E36
        -9.999999933815813E36
      
    
  
  
    EPSG:26713
  
  
    EPSG:26713
  


Up
get /workspaces/{workspace}/coverages
(getCoverageStore)
Get the coverages available for the provided workspace.

Path parameters

workspace (required)
Path Parameter — The name of the workspace

Query parameters

list (optional)
Query Parameter — If the list parameter value is equal to "all" all the coverages available in the data source (even the non-published ones) will be returned.

Return type

inline_response_200

Example data

Content-Type: application/json
"{\n  \"coverages\": {\n    \"coverage\": [\n      {\n        \"name\": \"sfdem\",\n        \"href\": \"http://localhost:/geoserver/restng/workspaces/sf/coverages/sfdem.json\"\n      }\n    ]\n  }\n}\n"

Example data

Content-Type: text/xml
"\n  \n    sfdem\n    \n  \n\n"

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response containing the list of coverages. inline_response_200

Example data

Content-Type: application/json
{
  "coverages": {
    "coverage": [
      {
        "name": "sfdem",
        "href": "http://localhost:/geoserver/restng/workspaces/sf/coverages/sfdem.json"
      }
    ]
  }
}

Example data

Content-Type: text/xml

  
    sfdem
    
  


Up
get /workspaces/{workspace}/coveragestores/{store}/coverages/{coverage}
(getWorkspaceCoverage)
Get an individual coverage.

Path parameters

workspace (required)
Path Parameter — The name of the workspace
store (required)
Path Parameter — The name of the coverage datastore
coverage (required)
Path Parameter — The name of the coverage

Query parameters

quietOnNotFound (optional)
Query Parameter — The quietOnNotFound parameter avoids logging an Exception when the coverage is not present. Note that 404 status code will be returned anyway. default: false

Return type

inline_response_200_1

Example data

Content-Type: application/json
{
  "coverage" : {
    "abstract" : "Digital elevation model for the Spearfish region.\r\n\r\nsfdem is a Tagged Image File Format with Geographic information",
    "defaultInterpolationMethod" : "nearest neighbor",
    "description" : "Generated from sfdem",
    "dimensions" : {
      "coverageDimension" : [ {
        "description" : "GridSampleDimension[-9.999999933815813E36,-9.999999933815813E36]",
        "name" : "GRAY_INDEX",
        "range" : {
          "max" : -9.999999933815813E36,
          "min" : -9.999999933815813E36
        }
      } ]
    },
    "enabled" : true,
    "grid" : {
      "@dimension" : "2",
      "crs" : "EPSG:26713",
      "range" : {
        "high" : "634 477",
        "low" : "0 0"
      },
      "transform" : {
        "scaleX" : 30,
        "scaleY" : -30,
        "shearX" : 0,
        "shearY" : 0,
        "translateX" : 589995,
        "translateY" : 4927995
      }
    },
    "interpolationMethods" : {
      "string" : [ "nearest neighbor", "bilinear", "bicubic" ]
    },
    "keywords" : {
      "string" : [ "WCS", "sfdem", "sfdem" ]
    },
    "latLonBoundingBox" : {
      "crs" : "EPSG:4326",
      "maxx" : -103.62940739432703,
      "maxy" : 44.5016011535299,
      "minx" : -103.87108701853181,
      "miny" : 44.370187074132616
    },
    "metadata" : {
      "entry" : {
        "$" : "sfdem_sfdem",
        "@key" : "dirName"
      }
    },
    "name" : "sfdem",
    "namespace" : {
      "href" : "http://localhost:/geoserver/restng/namespaces/sf.json",
      "name" : "sf"
    },
    "nativeBoundingBox" : {
      "crs" : {
        "$" : "EPSG:26713",
        "@class" : "projected"
      },
      "maxx" : 609000,
      "maxy" : 4928010,
      "minx" : 589980,
      "miny" : 4913700
    },
    "nativeCRS" : {
      "$" : "PROJCS[\"NAD27 / UTM zone 13N\", \n  GEOGCS[\"NAD27\", \n    DATUM[\"North American Datum 1927\", \n      SPHEROID[\"Clarke 1866\", 6378206.4, 294.9786982138982, AUTHORITY[\"EPSG\",\"7008\"]], \n      TOWGS84[2.478, 149.752, 197.726, 0.526, -0.498, 0.501, 0.685], \n      AUTHORITY[\"EPSG\",\"6267\"]], \n    PRIMEM[\"Greenwich\", 0.0, AUTHORITY[\"EPSG\",\"8901\"]], \n    UNIT[\"degree\", 0.017453292519943295], \n    AXIS[\"Geodetic longitude\", EAST], \n    AXIS[\"Geodetic latitude\", NORTH], \n    AUTHORITY[\"EPSG\",\"4267\"]], \n  PROJECTION[\"Transverse_Mercator\"], \n  PARAMETER[\"central_meridian\", -105.0], \n  PARAMETER[\"latitude_of_origin\", 0.0], \n  PARAMETER[\"scale_factor\", 0.9996], \n  PARAMETER[\"false_easting\", 500000.0], \n  PARAMETER[\"false_northing\", 0.0], \n  UNIT[\"m\", 1.0], \n  AXIS[\"Easting\", EAST], \n  AXIS[\"Northing\", NORTH], \n  AUTHORITY[\"EPSG\",\"26713\"]]",
      "@class" : "projected"
    },
    "nativeFormat" : "GeoTIFF",
    "nativeName" : "sfdem",
    "requestSRS" : {
      "string" : [ "EPSG:26713" ]
    },
    "responseSRS" : {
      "string" : [ "EPSG:26713" ]
    },
    "srs" : "EPSG:26713",
    "store" : {
      "@class" : "coverageStore",
      "href" : "http://localhost:/geoserver/restng/workspaces/sf/coveragestores/sfdem.json",
      "name" : "sf:sfdem"
    },
    "supportedFormats" : {
      "string" : [ "ARCGRID", "IMAGEMOSAIC", "GTOPO30", "GEOTIFF", "GIF", "PNG", "JPEG", "TIFF" ]
    },
    "title" : "Spearfish elevation"
  }
}

Example data

Content-Type: application/xml
"\n  sfdem\n  sfdem\n  \n    sf\n    \n  \n  Spearfish elevation\n  Generated from sfdem\n  Digital elevation model for the Spearfish region.\n\nsfdem is a Tagged Image File Format with Geographic information\n  \n    WCS\n    sfdem\n    sfdem\n    type\\@language=fr\\;\\@vocabulary=test\\;\n  \n  PROJCS["NAD27 / UTM zone 13N",\n  GEOGCS["NAD27",\n    DATUM["North American Datum 1927",\n      SPHEROID["Clarke 1866", 6378206.4, 294.9786982138982, AUTHORITY["EPSG","7008"]],\n      TOWGS84[2.478, 149.752, 197.726, 0.526, -0.498, 0.501, 0.685],\n      AUTHORITY["EPSG","6267"]],\n    PRIMEM["Greenwich", 0.0, AUTHORITY["EPSG","8901"]],\n    UNIT["degree", 0.017453292519943295],\n    AXIS["Geodetic longitude", EAST],\n    AXIS["Geodetic latitude", NORTH],\n    AUTHORITY["EPSG","4267"]],\n  PROJECTION["Transverse_Mercator", AUTHORITY["EPSG","9807"]],\n  PARAMETER["central_meridian", -105.0],\n  PARAMETER["latitude_of_origin", 0.0],\n  PARAMETER["scale_factor", 0.9996],\n  PARAMETER["false_easting", 500000.0],\n  PARAMETER["false_northing", 0.0],\n  UNIT["m", 1.0],\n  AXIS["Easting", EAST],\n  AXIS["Northing", NORTH],\n  AUTHORITY["EPSG","26713"]]\n  EPSG:26713\n  \n    589980.0\n    609000.0\n    4913700.0\n    4928010.0\n    EPSG:26713\n  \n  \n    -103.87108701853181\n    -103.62940739432703\n    44.370187074132616\n    44.5016011535299\n    EPSG:4326\n  \n  true\n  \n    \n      \n        false\n      \n    \n    10\n    \n      \n        false\n        \n      \n    \n    true\n    sfdem_sfdem\n  \n  \n    sf:sfdem\n    \n  \n  GeoTIFF\n  \n    \n      0 0\n      634 477\n    \n    \n      30.0\n      -30.0\n      0.0\n      0.0\n      589995.0\n      4927995.0\n    \n    EPSG:26713\n  \n  \n    ARCGRID\n    IMAGEMOSAIC\n    GTOPO30\n    GEOTIFF\n    GIF\n    PNG\n    JPEG\n    TIFF\n  \n  \n    nearest neighbor\n    bilinear\n    bicubic\n  \n  nearest neighbor\n  \n    \n      GRAY_INDEX\n      GridSampleDimension[-9.999999933815813E36,-9.999999933815813E36]\n      \n        -9.999999933815813E36\n        -9.999999933815813E36\n      \n    \n  \n  \n    EPSG:26713\n  \n  \n    EPSG:26713\n  \n\n"

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response containing coverage. inline_response_200_1

Example data

Content-Type: application/json
{coverage={abstract=Digital elevation model for the Spearfish region.

sfdem is a Tagged Image File Format with Geographic information, defaultInterpolationMethod=nearest neighbor, description=Generated from sfdem, dimensions={coverageDimension=[{description=GridSampleDimension[-9.999999933815813E36,-9.999999933815813E36], name=GRAY_INDEX, range={max=-9.999999933815813E36, min=-9.999999933815813E36}}]}, enabled=true, grid={@dimension=2, crs=EPSG:26713, range={high=634 477, low=0 0}, transform={scaleX=30, scaleY=-30, shearX=0, shearY=0, translateX=589995, translateY=4927995}}, interpolationMethods={string=[nearest neighbor, bilinear, bicubic]}, keywords={string=[WCS, sfdem, sfdem]}, latLonBoundingBox={crs=EPSG:4326, maxx=-103.62940739432703, maxy=44.5016011535299, minx=-103.87108701853181, miny=44.370187074132616}, metadata={entry={$=sfdem_sfdem, @key=dirName}}, name=sfdem, namespace={href=http://localhost:/geoserver/restng/namespaces/sf.json, name=sf}, nativeBoundingBox={crs={$=EPSG:26713, @class=projected}, maxx=609000, maxy=4928010, minx=589980, miny=4913700}, nativeCRS={$=PROJCS["NAD27 / UTM zone 13N", 
  GEOGCS["NAD27", 
    DATUM["North American Datum 1927", 
      SPHEROID["Clarke 1866", 6378206.4, 294.9786982138982, AUTHORITY["EPSG","7008"]], 
      TOWGS84[2.478, 149.752, 197.726, 0.526, -0.498, 0.501, 0.685], 
      AUTHORITY["EPSG","6267"]], 
    PRIMEM["Greenwich", 0.0, AUTHORITY["EPSG","8901"]], 
    UNIT["degree", 0.017453292519943295], 
    AXIS["Geodetic longitude", EAST], 
    AXIS["Geodetic latitude", NORTH], 
    AUTHORITY["EPSG","4267"]], 
  PROJECTION["Transverse_Mercator"], 
  PARAMETER["central_meridian", -105.0], 
  PARAMETER["latitude_of_origin", 0.0], 
  PARAMETER["scale_factor", 0.9996], 
  PARAMETER["false_easting", 500000.0], 
  PARAMETER["false_northing", 0.0], 
  UNIT["m", 1.0], 
  AXIS["Easting", EAST], 
  AXIS["Northing", NORTH], 
  AUTHORITY["EPSG","26713"]], @class=projected}, nativeFormat=GeoTIFF, nativeName=sfdem, requestSRS={string=[EPSG:26713]}, responseSRS={string=[EPSG:26713]}, srs=EPSG:26713, store={@class=coverageStore, href=http://localhost:/geoserver/restng/workspaces/sf/coveragestores/sfdem.json, name=sf:sfdem}, supportedFormats={string=[ARCGRID, IMAGEMOSAIC, GTOPO30, GEOTIFF, GIF, PNG, JPEG, TIFF]}, title=Spearfish elevation}}

Example data

Content-Type: application/xml

  sfdem
  sfdem
  
    sf
    
  
  Spearfish elevation
  Generated from sfdem
  Digital elevation model for the Spearfish region.

sfdem is a Tagged Image File Format with Geographic information
  
    WCS
    sfdem
    sfdem
    type\@language=fr\;\@vocabulary=test\;
  
  PROJCS["NAD27 / UTM zone 13N",
  GEOGCS["NAD27",
    DATUM["North American Datum 1927",
      SPHEROID["Clarke 1866", 6378206.4, 294.9786982138982, AUTHORITY["EPSG","7008"]],
      TOWGS84[2.478, 149.752, 197.726, 0.526, -0.498, 0.501, 0.685],
      AUTHORITY["EPSG","6267"]],
    PRIMEM["Greenwich", 0.0, AUTHORITY["EPSG","8901"]],
    UNIT["degree", 0.017453292519943295],
    AXIS["Geodetic longitude", EAST],
    AXIS["Geodetic latitude", NORTH],
    AUTHORITY["EPSG","4267"]],
  PROJECTION["Transverse_Mercator", AUTHORITY["EPSG","9807"]],
  PARAMETER["central_meridian", -105.0],
  PARAMETER["latitude_of_origin", 0.0],
  PARAMETER["scale_factor", 0.9996],
  PARAMETER["false_easting", 500000.0],
  PARAMETER["false_northing", 0.0],
  UNIT["m", 1.0],
  AXIS["Easting", EAST],
  AXIS["Northing", NORTH],
  AUTHORITY["EPSG","26713"]]
  EPSG:26713
  
    589980.0
    609000.0
    4913700.0
    4928010.0
    EPSG:26713
  
  
    -103.87108701853181
    -103.62940739432703
    44.370187074132616
    44.5016011535299
    EPSG:4326
  
  true
  
    
      
        false
      
    
    10
    
      
        false
        
      
    
    true
    sfdem_sfdem
  
  
    sf:sfdem
    
  
  GeoTIFF
  
    
      0 0
      634 477
    
    
      30.0
      -30.0
      0.0
      0.0
      589995.0
      4927995.0
    
    EPSG:26713
  
  
    ARCGRID
    IMAGEMOSAIC
    GTOPO30
    GEOTIFF
    GIF
    PNG
    JPEG
    TIFF
  
  
    nearest neighbor
    bilinear
    bicubic
  
  nearest neighbor
  
    
      GRAY_INDEX
      GridSampleDimension[-9.999999933815813E36,-9.999999933815813E36]
      
        -9.999999933815813E36
        -9.999999933815813E36
      
    
  
  
    EPSG:26713
  
  
    EPSG:26713
  


Up
get /workspaces/{workspace}/coveragestores/{store}/coverages
(getWorkspaceCoverageStore)
Get the coverages available for the provided workspace and data store.

Path parameters

workspace (required)
Path Parameter — The name of the workspace
store (required)
Path Parameter — The name of the coverage data store

Query parameters

list (optional)
Query Parameter — If the list parameter value is equal to "all" all the coverages available in the data source (even the non-published ones) will be returned.

Return type

inline_response_200

Example data

Content-Type: application/json
"{\n  \"coverages\": {\n    \"coverage\": [\n      {\n        \"name\": \"sfdem\",\n        \"href\": \"http://localhost:/geoserver/restng/workspaces/sf/coverages/sfdem.json\"\n      }\n    ]\n  }\n}\n"

Example data

Content-Type: text/xml
"\n  \n    sfdem\n    \n  \n\n"

Produces

This API call produces the following media types according to the Accept request header; the media type will be conveyed by the Content-Type response header.

Responses

200

Successful response containing the list of coverages. inline_response_200

Example data

Content-Type: application/json
{
  "coverages": {
    "coverage": [
      {
        "name": "sfdem",
        "href": "http://localhost:/geoserver/restng/workspaces/sf/coverages/sfdem.json"
      }
    ]
  }
}

Example data

Content-Type: text/xml

  
    sfdem
    
  


Up
post /workspaces/{workspace}/coverages/{coverage}
(postCoverage)
Invalid. Use POST on the coverages endpoint to add a new coverage, or PUT on an individual coverage to edit it.

Responses

405

Method not allowed.

Up
post /workspaces/{workspace}/coverages
(postCoverageStore)
Create a new coverage, the coverage definition needs to reference a store.

Path parameters

workspace (required)
Path Parameter — The name of the workspace

Request body

coverage CoverageInfo (required)
Body Parameter — The body of the coverage to POST

Responses

201

The coverage was successfully created.

Up
post /workspaces/{workspace}/coveragestores/{store}/coverages/{coverage}
(postWorkspaceCoverage)
Invalid. Use POST on the coverages endpoint to add a new coverage, or PUT on an individual coverage to edit it.

Responses

405

Method not allowed.

Up
post /workspaces/{workspace}/coveragestores/{store}/coverages
(postWorkspaceCoverageStore)
Create a new coverage, the underlying data store must exist.

Path parameters

workspace (required)
Path Parameter — The name of the workspace
store (required)
Path Parameter — The name of the coverage data store

Request body

coverage CoverageInfo (required)
Body Parameter — The body of the coverage to POST

Responses

201

The coverage was successfully created.

Up
put /workspaces/{workspace}/coverages/{coverage}
(putCoverage)
Invalid. Use POST for adding a new coverage, or PUT on an individual coverage to edit that type.

Responses

405

Method not allowed.

Up
put /workspaces/{workspace}/coverages
(putCoverageStore)
Invalid. Use POST for adding a new coverage, or PUT on an individual coverage to edit that type.

Responses

405

Method not allowed.

Up
put /workspaces/{workspace}/coveragestores/{store}/coverages/{coverage}
(putWorkspaceCoverage)
Update an individual coverage

Path parameters

workspace (required)
Path Parameter — The name of the workspace
store (required)
Path Parameter — The name of the coverage data store
coverage (required)
Path Parameter — The name of the coverage

Consumes

This API call consumes the following media types via the Content-Type request header:

Request body

coverage CoverageInfo (required)
Body Parameter — The body of the coverage to PUT

Query parameters

calculate (optional)
Query Parameter — Comma-separated list of optional fields to calculate. Optional fields include: "nativebbox", "latlonbbox".

Responses

200

The coverage was successfully updated.

Up
put /workspaces/{workspace}/coveragestores/{store}/coverages
(putWorkspaceCoverageStore)
Invalid. Use POST for adding a new coverage, or PUT on an individual coverage to edit that type.

Responses

405

Method not allowed.

Models

[ Jump to Methods ]

Table of Contents

  1. CoverageInfo -
  2. CoverageInfo_attributes -
  3. CoverageInfo_attributes_attribute -
  4. CoverageInfo_dataLinks -
  5. CoverageInfo_dataLinks_metadataLink -
  6. CoverageInfo_dimensions -
  7. CoverageInfo_dimensions_coverageDimension -
  8. CoverageInfo_dimensions_range -
  9. CoverageInfo_grid -
  10. CoverageInfo_grid_interpolationMethods -
  11. CoverageInfo_grid_range -
  12. CoverageInfo_grid_transform -
  13. CoverageInfo_keywords -
  14. CoverageInfo_latLonBoundingBox -
  15. CoverageInfo_metadatalinks -
  16. CoverageInfo_metadatalinks_metadataLink -
  17. CoverageInfo_namespace -
  18. CoverageInfo_nativeBoundingBox -
  19. CoverageInfo_responseSRS -
  20. CoverageInfo_store -
  21. MetadataEntry - entry
  22. inline_response_200 -
  23. inline_response_200_1 -
  24. inline_response_200_coverages -
  25. inline_response_200_coverages_coverage -

CoverageInfo - Up

name (optional)
String The name of the resource. This name corresponds to the "published" name of the resource.
nativeName (optional)
String The native name of the resource. This name corresponds to the physical resource that feature type is derived from -- a shapefile name, a database table, etc...
namespace (optional)
title (optional)
String The title of the resource. This is usually something that is meant to be displayed in a user interface.
abstract (optional)
String A description of the resource. This is usually something that is meant to be displayed in a user interface.
defaultInterpolationMethod (optional)
String Default resampling (interpolation) method that will be used for this coverage.
keywords (optional)
metadatalinks (optional)
dataLinks (optional)
nativeCRS (optional)
String The native coordinate reference system object of the resource.
srs (optional)
String Returns the identifier of coordinate reference system of the resource.
nativeBoundingBox (optional)
latLonBoundingBox (optional)
metadata (optional)
array[MetadataEntry] A list of key/value metadata pairs.
store (optional)
cqlFilter (optional)
String The ECQL string used as default feature type filter
maxFeatures (optional)
Integer A cap on the number of features that a query against this type can return.
numDecimals (optional)
BigDecimal The number of decimal places to use when encoding floating point numbers from data of this feature type.
responseSRS (optional)
overridingServiceSRS (optional)
Boolean True if this feature type info is overriding the WFS global SRS list
skipNumberMatched (optional)
Boolean True if this feature type info is overriding the counting of numberMatched.
circularArcPresent (optional)
linearizationTolerance (optional)
BigDecimal Tolerance used to linearize this feature type, as an absolute value expressed in the geometries own CRS
attributes (optional)
dimensions (optional)
grid (optional)

CoverageInfo_attributes - Up

Wrapper for the derived set of attributes for the feature type.
attribute (optional)
array[CoverageInfo_attributes_attribute] The derived set of attributes for the feature type.

CoverageInfo_attributes_attribute - Up

A single attribute
name (optional)
String Name of the attribute.
minOccurs (optional)
Integer Minimum number of occurrences of the attribute.
maxOccurs (optional)
Integer Maximum number of occurrences of the attribute.
nillable (optional)
Boolean Flag indicating if null is an acceptable value for the attribute.
binding (optional)
String The java class that values of this attribute are bound to.
length (optional)
Integer Returns the length of this attribute. It's usually non null only for string and numeric types"

CoverageInfo_dataLinks - Up

Wraps a collection of data links for the resource.
metadataLink (optional)
array[CoverageInfo_dataLinks_metadataLink] A collection of data links for the resource.

CoverageInfo_dataLinks_metadataLink - Up

type (optional)
String The MIME type
content (optional)
String The link URL

CoverageInfo_dimensions - Up

raster dimensions
coverageDimension (optional)

CoverageInfo_dimensions_coverageDimension - Up

raster dimension
description (optional)
String description of the raster dimension
name (optional)
String name of the dimension
range (optional)

CoverageInfo_dimensions_range - Up

dimension range
max (optional)
BigDecimal max range value
min (optional)
BigDecimal min range value

CoverageInfo_grid - Up

contains information about how to translate from the raster plan to a coordinate reference system
dimension (optional)
String cardinality of the raster plan
crs (optional)
String target coordinate system
range (optional)
transform (optional)
interpolationMethods (optional)

CoverageInfo_grid_interpolationMethods - Up

available interpolations methods for this coverage
string (optional)

CoverageInfo_grid_range - Up

range of the raster plan
high (optional)
String max range values
low (optional)
String min range values

CoverageInfo_grid_transform - Up

transformation definition
scaleX (optional)
BigDecimal scale value to apply in X
scaleY (optional)
BigDecimal scale value to apply in Y
shearX (optional)
BigDecimal shear value to apply in X
shearY (optional)
BigDecimal shear value to apply in Y
translateX (optional)
BigDecimal translation to apply in X
translatexY (optional)
BigDecimal translation to apply in Y

CoverageInfo_keywords - Up

A collection of keywords associated with the resource.
string (optional)
array[String] List of keyword values with internationalization and vocabulary

CoverageInfo_latLonBoundingBox - Up

The bounds of the resource in lat / lon. This value represents a "fixed value" and is not calculated on the underlying dataset.
minx (optional)
BigDecimal The min x coordinate
maxx (optional)
BigDecimal The max x coordinate
miny (optional)
BigDecimal The min y coordinate
maxy (optional)
BigDecimal The max y coordinate
crs (optional)
String The coordinate reference system object of the bounding box.

CoverageInfo_metadatalinks - Up

Wraps a collection of metadata links for the resource.
metadataLink (optional)
array[CoverageInfo_metadatalinks_metadataLink] A collection of metadata links for the resource.

CoverageInfo_metadatalinks_metadataLink - Up

type (optional)
String The MIME type
metadataType (optional)
String The type of metadata, e.g. "FGDC"
content (optional)
String The link URL

CoverageInfo_namespace - Up

The namespace URI of the resource. Example would be an application schema namespace URI.
name (optional)
String The name of the namespace.
href (optional)
String URL to the namespace.

CoverageInfo_nativeBoundingBox - Up

Returns the bounds of the resource in its declared CRS.
minx (optional)
BigDecimal The min x coordinate
maxx (optional)
BigDecimal The max x coordinate
miny (optional)
BigDecimal The min y coordinate
maxy (optional)
BigDecimal The max y coordinate
crs (optional)
String The coordinate reference system object of the bounding box.

CoverageInfo_responseSRS - Up

The SRSs that the WFS service will advertise in the capabilities document for this feature type (overriding the global WFS settings).
string (optional)
String The value of the srs

CoverageInfo_store - Up

The store the resource is a part of.
@class (optional)
String The class of the store
name (optional)
String The name of the store
href (optional)
String URL to the data store

MetadataEntry - entry Up

@key (optional)
String Key used for metadata entry, additional keys are added over time
Enum:
regionateStrategy
regionateFeatureLimit
cacheAgeMax
cachingEnabled
regionateAttribute
indexingEnabled
dirName
$ (optional)
String Text value for provided key Valid text depends on key used. Example {'@key'='cachingEnabled','$'='true'}.

inline_response_200 - Up

coverages (optional)

inline_response_200_1 - Up

featureType (optional)

inline_response_200_coverages - Up

coverage (optional)

inline_response_200_coverages_coverage - Up

name (optional)
String The Name
link (optional)
String The URL