Jump to

• Request
• Response
• Examples

Get Raster Data in Image Format 1

get

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

Query the raster data of the specified GeoRaster Object and return the result in a standard web image format for display.

The query parameter "format" and "thumbnail" are used to specify the returned image format. You can also specify the crop window, the band numbers, the pyramid level and image processing method as the query parameters.

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

• IPMethod: string
  Specify the image processing method.

  Allowed Values: [ "stretch", "piecewisestretch", "normalize", "equalize" ]
• bandNumbers: string
  Specify the band numbers to retrieve.

  Examples

  Select an example List Range

• cropWin: array[number]
  Minimum Number of Items: 4

  Maximum Number of Items: 4

  The cropping window of the returned image. The coordinates of the cropping window are in cell space coordinates, that is, row and column numbers of the upper-left and lower-right corner of the cropping window in the raster data. Cannot co-exist with thumbnail parameter.

  Examples

  Select an example

• format: string
  Specify the format of the returned image: JPEG, GIF, PNG, or BMP. For the truecolor and grayscale images, it defaults to JPEG. For the pseudocolor images, it defaults to PNG.

  Allowed Values: [ "JPEG", "GIF", "PNG", "BMP" ]

  Example:

  JPEG

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

  Examples

  Select an example 0

• thumbnail: boolean
  Boolean value to specify whether return a thumbnail image.

There's no request body for this operation.

Back to Top

Response

Supported Media Types

• image/png
• image/jpeg
• image/bmp
• image/gif

200 Response

Return the output raster data in binary stream.

Body ()

Root Schema : schema

Type: string(binary)

401 Response

Authentication information is missing or invalid

Headers

• WWW_Authenticate:

Back to Top

Examples

The following is an example on how to request a thumbnail image from a GeoRaster Object by submitting a GET request using cURL.

curl -X GET "https://localhost:8080/oraclespatial/georaster/v1/datasource1/raster_image/image/rasterImage?format=JPEG&thumbnail=true" -H "Cookie: JSESSIONID=<jsessionid_value>"

Back to Top