Jump to

• Request
• Response
• Examples

Get GeoRaster Object Cell Values

get

{server}/georaster/v1/{datasource}/{tableName}/{georasterColumnName}/{rdt}/{rid}/cellValues

Get the cell values of the specified GeoRaster Object at the specified location. If the interpolation method exists, the cell values is interpolated to the exact point.

Request

Path Parameters

• georasterColumnName(required): string
  The name of the GeoRaster Column

  Examples

  Select an example Column Name

• rdt(required): string
  The Raster Data Table (RDT) Name.

  Examples

  Select an example Raster Data Table

• rid(required): integer
  The Raster ID (RID) of the GeoRaster Object.

  Examples

  Select an example 1

• tableName(required): string
  The name of the table, could be prefixed with a schema name

  Examples

  Select an example Table name

Query Parameters

• bandNumber: integer
  Number of the physical band that contains the cells whose values are to be returned.

  Examples

  Select an example Band 0

• colNumbers(required): array[integer]
  Minimum Length: 1

  Numbers of the columns that contains the cells whose values are to be returned.

  Examples

  Select an example Column 8

• pyramidLevel: number
  Specify the pyramid level of the GeoRaster data.

  Examples

  Select an example 0

• rowNumbers(required): array[integer]
  Minimum Length: 1

  Numbers of the rows that contains the cells whose values are to be returned.

  Examples

  Select an example Row 5

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• application/json

200 Response

Return the raster cell values at the requested locations.

Body ()

Root Schema : rasterCellValueResponse

Type: object

Show Source

• cellValues(required): array cellValues
• links(required): array links
  links to self, the GeoRaster Object

{
    "type":"object",
    "required":[
        "cellValues",
        "links"
    ],
    "properties":{
        "cellValues":{
            "type":"array",
            "items":{
                "$ref":"#/components/schemas/numberArray"
            }
        },
        "links":{
            "type":"array",
            "description":"links to self, the GeoRaster Object",
            "items":{
                "$ref":"#/components/schemas/instanceLink"
            }
        }
    }
}

Nested Schema : cellValues

Type: array

Show Source

• Array of: array numberArray

{
    "type":"array",
    "items":{
        "$ref":"#/components/schemas/numberArray"
    }
}

Nested Schema : links

Type: array

links to self, the GeoRaster Object

Show Source

• Array of: string

{
    "type":"array",
    "description":"links to self, the GeoRaster Object",
    "items":{
        "$ref":"#/components/schemas/instanceLink"
    }
}

Nested Schema : numberArray

Type: array

Show Source

• Array of: number

{
    "type":"array",
    "items":{
        "type":"number"
    }
}

Examples

Select an example example1 example2

401 Response

Authentication information is missing or invalid

Headers

• WWW_Authenticate:

Back to Top

Examples

The following is an example on how to request cell values from a given GeoRaster Object by submitting a GET request using cURL.

curl -X GET "https://localhost:8080/oraclespatial/georaster/v1/datasource1/image_table/image/image_table_RDT1/1/cellValues?pyramidLevel=1&rowNumbers=10,45,100,45&colNumbers=10,110,150,215&bandNumber=1" -H "Cookie: JSESSIONID=<jsessionid_value>"

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

{
  "cellValues": [ 134, 146, 123, 116 ],
  "links": [{
    "rel" : "self",
    "href" : "https://localhost:8080/oraclespatial/georaster/v1/datasource1/image_table/image/image_table_RDT1/1/cellValues?pyramidLevel=1&rowNumbers=10,45,100,45&colNumbers=10,110,150,215&bandNumber=1"
   }]
}

Back to Top