Initiate a GeoRaster Object

put

{server}/georaster/v1/{datasource}/{tableName}/{georasterColumnName}

Update the GeoRaster table with an empty GeoRaster Object with the given raster data table (RDT) and raster ID (RID) name. It is assumed that the row already exists and the query through the q parameter must only return one row from the table.

Request

Path Parameters
Query Parameters
  • Query parameter in JSON format, see "Filtering in Queries" in ORDS documentation.
    Example: {"id":1}
    Example: {"AND":[{"state":"CA"},{"date":"10/02/2020"}]}
    Examples

Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
Examples

Back to Top

Response

Supported Media Types

200 Response

Return the empty GeoRaster Object
Body ()
Root Schema : georasterObjectResponse
Type: object
The json response of the information of the GeoRaster Object
Show Source
Nested Schema : sdogeormetadata
Type: object
GeoRaster Object metadata
Show Source
Nested Schema : spatialExent
Match All
Show Source
Nested Schema : rasterBandReferenceSystemType
Type: object
Show Source
Nested Schema : layerInfo
Type: array
Minimum Length: 1
Show Source
Nested Schema : objectDescriptionType
Type: object
Show Source
Nested Schema : rasterDescriptionType
Type: object
Show Source
Nested Schema : rasterSpatialReferenceSystemType
Type: object
Show Source
Nested Schema : rasterTemporalReferenceSystemType
Type: object
Show Source
Nested Schema : bandReference
Type: array
Show Source
Nested Schema : spatialResolution
Type: object
Show Source
Nested Schema : extentType
Type: object
Show Source
Nested Schema : segmentationDataType
Type: object
Show Source
Nested Schema : layerDescriptionType
Type: object
Show Source
Nested Schema : layerType
Type: object
Show Source
Nested Schema : subLayer
Type: array
Minimum Length: 0
Show Source
Nested Schema : binFunctionType
Type: object
Show Source
Nested Schema : colorMapType
Type: object
Show Source
Nested Schema : grayScaleType
Type: object
Show Source
Nested Schema : NODATAType
Type: object
Show Source
Nested Schema : scalingFunctionType
Type: object
Show Source
Nested Schema : statisticDatasetType
Type: object
Show Source
Nested Schema : binDefinition
Match One Schema
Show Source
Nested Schema : colors
Match One Schema
Show Source
Nested Schema : colors-oneOf[0]
Type: array
Minimum Length: 1
Show Source
Nested Schema : cellPseudoColorType
Type: object
Show Source
Nested Schema : grays
Match One Schema
Show Source
Nested Schema : grays-oneOf[0]
Type: array
Minimum Length: 1
Show Source
Nested Schema : cellGrayType
Type: object
Show Source
Nested Schema : ranges
Type: array
Show Source
Nested Schema : values
Type: array
Show Source
Nested Schema : histogramType
Type: object
Show Source
Nested Schema : rectangularWindowType
Type: object
Show Source
Nested Schema : counts
Match One Schema
Show Source
Nested Schema : counts-oneOf[0]
Type: array
Minimum Length: 1
Show Source
Nested Schema : cellCountType
Type: object
Show Source
Nested Schema : cellCoordinateType
Type: object
Show Source
Nested Schema : blockingDescriptionType
Type: object
Show Source
Nested Schema : cellDimensionSizeType
Type: object
Show Source
Nested Schema : pyramidDescriptionType
Type: object
Show Source
Nested Schema : maxLevel
Default Value: 0
Match All
Show Source
  • Minimum Value: 0
    Minimum Value: > false
Nested Schema : GCPGeoreferenceType
Type: object
Show Source
Nested Schema : rationalPolynomialType
Type: object
Show Source
Nested Schema : gcp
Type: array
Minimum Length: 0
Show Source
Nested Schema : GCPType
Type: object
Show Source
Nested Schema : polynomialType
Type: object
Show Source
Nested Schema : polynomialCoefficients
Type: array
Show Source

401 Response

Authentication information is missing or invalid
Headers
Back to Top

Examples

The following is an example on how to create an empty GeoRaster Object on data source datasource1, table image_table, column image where id column is equal to 14 by submitting a PUT request using cURL.

curl -v -X PUT -d @request_body.json "https://localhost:8080/oraclespatial/georaster/v1/datasource1/image_table/image?q={'id'=14}" -H "Cookie: JSESSIONID=<jsessionid_value>"

The following is an example of the request body for the above request.

{"rdt":"image_table_RDT1","rid":1}

The following shows an example of the response in JSON format for the above request.

 {
   "items" : [ {
     "rasterType" : 0,
     "spatialExtent" : null,
     "rasterDataTable" : "IMAGE_TABLE_RDT1",
     "rasterID" : 1,
     "links" : [ {
       "rel" : "self",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/IMAGE_TABLE/IMAGE/IMAGE_TABLE_RDT1/1"
     }, {
       "rel" : "metadata",
       "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/IMAGE_TABLE/IMAGE/IMAGE_TABLE_RDT1/1/metadata"
     } ]
   } ],
   "hasMore" : false,
   "totalResults" : 1,
   "links" : [ {
     "rel" : "canonical",
     "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/IMAGE_TABLE/IMAGE"
   }, {
     "rel" : "self",
     "href" : "http://localhost:8080/oraclespatial/georaster/v1/datasource1/IMAGE_TABLE/IMAGE?q={"ID":14}"
   } ]
 }
Back to Top