Get Raster Data in Image Format 2

post

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

Query and/or process the raster data of the specified GeoRaster Object and return the results in a standard web image format for display. Additional processing can be specified in the rendering options to get the best rendering image.

Only the "format" and "thumbnail" parameter are allowed in the query parameter, all the rendering or operation parameters should be specified in the request body.

Request

Path Parameters
Query Parameters
  • 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
  • Boolean value to specify whether return a thumbnail image.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
parameters for returning an image
Show Source
Nested Schema : get_data_param
Type: object
operations that return data on the fly
Show Source
  • memoryParam
    the memory usage parameter
  • Allowed Values: [ "affinetransform", "getbitmapmasksubset", "getrasterdata", "getrastersubset", "rectify", "reproject", "warp", "equalize", "filter", "normalize", "piecewisestretch", "stretch", "classify", "diff", "findcells", "normalize", "picewisestretch", "stretch", "classify", "diff", "findcells", "over", "rastermathop", "getmosaicsubset" ]
    the operation name
  • opParam
Nested Schema : rendering_param
Type: object
client side rendering options
Show Source
  • colormap
    an array of colormap entries
  • grayscale
    an array of grayscale entries
  • Allowed Values: [ "none", "stretch", "piecewisestretch", "normalize", "equalize" ]
    the Rendering Image Processing Method. Note that for the data that is returned from the server-side raster operations such as affinetransform, getrasterdata, getrastersubset, rectify, reproject and warp, the image rendering process should use the statistics stored in the GeoRaster Object. If there is no statistics set in the GeoRaster Object metadata, the statistics of the returned data is used in the image processing. When IPMethod is not specified but the data is not in the rendering range (for example, not 8bit), normalization is applied to the rendered image.
  • mask
    an array specifying the layers to apply the mask, if there is no mask in that layer, it is ignored.
  • nodataMapping
    an array of nodata mapping entries
Nested Schema : memoryParam
Type: object
the memory usage parameter
Show Source
Nested Schema : opParam
Match One Schema
Show Source
Nested Schema : sdo_geor_op_param
Match One Schema
Show Source
Nested Schema : sdo_geor_ip_op_param
Match One Schema
Show Source
Nested Schema : sdo_geor_ra_op_param
Match One Schema
Show Source
Nested Schema : sdo_geor_aggr_op_param
Match One Schema
Show Source
Nested Schema : op_affinetransform_param
Type: object
Show Source
Nested Schema : op_getbitmapmasksubset_param
Match One Schema
Show Source
Nested Schema : op_getrasterdata_param
Type: object
Show Source
Nested Schema : op_getrastersubset_param
Match One Schema
Show Source
Nested Schema : op_rectify_param
Type: object
Show Source
Nested Schema : op_reproject_param
Match One Schema
Show Source
Nested Schema : op_warp_param
Type: object
Show Source
Nested Schema : sdo_number_array
Type: array
Show Source
Nested Schema : op_getbitmapmasksubset_param_1
Type: object
Show Source
Nested Schema : op_getbitmapmasksubset_param_2
Type: object
Show Source
Nested Schema : sdo_geometry
Type: object
Show Source
Nested Schema : op_getrastersubset_param_1
Type: object
Show Source
Nested Schema : op_getrastersubset_param_2
Type: object
Show Source
Nested Schema : sdo_georaster
Type: object
Show Source
Nested Schema : op_reproject_param_1
Type: object
Show Source
Nested Schema : op_reproject_param_2
Type: object
Show Source
Nested Schema : sdo_geor_srs
Type: object
Show Source
Nested Schema : sdo_geor_gcpgeoreftype
Type: object
Show Source
Nested Schema : sdo_geor_gcp_collection
Type: array
Show Source
Nested Schema : sdo_geor_gcp
Type: object
Show Source
Nested Schema : op_equalize_param
Match One Schema
Show Source
Nested Schema : op_filter_param
Match One Schema
Show Source
Nested Schema : op_normalize_param
Match One Schema
Show Source
Nested Schema : op_piecewisestretch_param
Match One Schema
Show Source
Nested Schema : op_stretch_param
Match One Schema
Show Source
Nested Schema : op_equalize_param_1
Type: object
Show Source
Nested Schema : op_equalize_param_2
Type: object
Show Source
Nested Schema : op_filter_param_1
Type: object
Show Source
Nested Schema : op_filter_param_2
Type: object
Show Source
Nested Schema : op_normalize_param_1
Type: object
Show Source
Nested Schema : op_normalize_param_2
Type: object
Show Source
Nested Schema : op_piecewisestretch_param_1
Type: object
Show Source
Nested Schema : op_piecewisestretch_param_2
Type: object
Show Source
Nested Schema : sdo_number_arrayset
Type: array
Show Source
Nested Schema : op_stretch_param_1
Type: object
Show Source
Nested Schema : op_stretch_param_2
Type: object
Show Source
Nested Schema : op_classify_param
Match One Schema
Show Source
Nested Schema : op_diff_param
Match One Schema
Show Source
Nested Schema : op_findcells_param
Match One Schema
Show Source
Nested Schema : op_over_param
Match One Schema
Show Source
Nested Schema : op_rastermathop_param
Match One Schema
Show Source
Nested Schema : op_classify_param_1
Type: object
Show Source
Nested Schema : op_classify_param_2
Type: object
Show Source
Nested Schema : op_diff_param_1
Type: object
Show Source
Nested Schema : op_diff_param_2
Type: object
Show Source
Nested Schema : op_findcells_param_1
Type: object
Show Source
Nested Schema : op_findcells_param_2
Type: object
Show Source
Nested Schema : op_over_param_1
Type: object
Show Source
Nested Schema : op_over_param_2
Type: object
Show Source
Nested Schema : op_rastermathop_param_1
Type: object
Show Source
Nested Schema : op_rastermathop_param_2
Type: object
Show Source
Nested Schema : op_rastermathop_param_3
Type: object
Show Source
Nested Schema : op_rastermathop_param_4
Type: object
Show Source
Nested Schema : sdo_string2_array
Type: array
Show Source
Nested Schema : op_getmosaicsubset_param
Match One Schema
Show Source
Nested Schema : op_getmosaicsubset_param_1
Type: object
Show Source
Nested Schema : op_getmosaicsubset_param_2
Type: object
Show Source
Nested Schema : sdo_geor_histogram_array
Type: array
Show Source
Nested Schema : sdo_geor_histogram
Type: object
Show Source
Nested Schema : colormap
Type: array
an array of colormap entries
Show Source
Nested Schema : grayscale
Type: array
an array of grayscale entries
Show Source
Nested Schema : mask
Type: array
an array specifying the layers to apply the mask, if there is no mask in that layer, it is ignored.
Show Source
Nested Schema : nodataMapping
Type: array
an array of nodata mapping entries
Show Source
Nested Schema : items
Type: object
colormap entry
Show Source
Nested Schema : items
Type: object
grayscale entry
Show Source
Nested Schema : items
Type: object
Define the mask mapping
Show Source
Nested Schema : items
Type: object
nodata mapping entry
Show Source
Examples

Back to Top

Response

Supported Media Types

200 Response

Return the output raster image in binary stream
Body ()
Root Schema : schema
Type: string(binary)

401 Response

Authentication information is missing or invalid
Headers
Back to Top

Examples

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

curl -X POST -d @request.json http://localhost:8080/oraclespatial/georaster/v1/datasource1/raster_image/image/rasterImage?format=JPEG" -H "Cookie: JSESSIONID=<jsessionid_value>"

The following is an example of request.json for the request body:

{
  "renderOps": {
    "IPMethod": "normalize"
  },
  "rasterOps": {
    "opName": "reproject",
    "opParam": {
      "outSRID": 4326,
      "resampleParam": "resampling=bilinear",
      "pyramidLevel": 1,
      "cropArea": [
        100,
        100,
        200,
        200
      ],
      "bandNumber": "0-2",
      "storageParam": "celldepth=16bit_u"
    }
  }
}
Back to Top