Get image metadata
GET/:script_id/metadata
Get metadata about an image given an IPE resource ID, function name, and parameters.
Request
Path Parameters
script ID
Query Parameters
The function to process
The function parameters if required. Note these are always prepended by a p=
query string param since they are dynamic based on the selected function
Responses
- 200
- 400
- 401
- 404
Success
- application/json
- Schema
- Example (from schema)
Schema
imageMetadata object
Image Metadata
ImageMetadata Version
X Index of the first tile
Y Index of the first tile
Exclusive x Index of the last tile. (numTilesX=maxTileX-minTileX)
Exclusive y Index of the last tile. (numTilesY=maxTileY-minTileY)
Number of pixels per tile in the X dimension
Number of pixels per tile in the Y dimension
Number of bands/layers in the image
Possible values: [BINARY
, BYTE
, SHORT
, UNSIGNED_SHORT
, INTEGER
, UNSIGNED_INTEGER
, LONG
, UNSIGNED_LONG
, FLOAT
, DOUBLE
]
The data type of the pixels
X Index of the first pixel
Y Index of the first pixel
Exclusive x index of the last pixel. (width=maxPixelX-minPixelX)
Exclusive y Index of the last pixel. (height=maxPixelY-minPixelY)
The pixel X index of the first pixel in the first tile.
The pixel Y index of the first pixel in the first tile.
spatialTransform object
Describes how image pixel coordinates relate to real world coordinates in some well-known spatial reference system. The 6 Double values represent the 6 parameters in an affine transform which transform pixel coordinates into map coordinates.
Possible values: [EPSG
, IDEAL
, UNDEFINED
]
The type of spatial reference system.
The spatial reference system identifier expressed as a string corresponding to the spatialReferenceSystemType.
affine objectrequired
The affine transform.
The scale factor in the x direction (one of the 6 affine transform parameters).
The scale factor in the y direction (one of the 6 affine transform parameters).
The translation factor in the x direction (one of the 6 affine transform parameters).
The translation factor in the y direction (one of the 6 affine transform parameters).
The shear factor in the x direction (one of the 6 affine transform parameters). Note that this parameter is usually 0 since geospatial images do not usually have rotation once rectified to a map projection.
The shear factor in the y direction (one of the 6 affine transform parameters). Note that this parameter is usually 0 since geospatial images do not usually have rotation once rectified to a map projection.
sourceMetadata object
Source image collect metadata
Possible values: non-empty
Possible values: [WV03
, WV02
, WV01
, LG01
, LG02
, LG03
, LG04
]
Possible values: [Forward
, Reverse
]
sunAzimuth object
sunElevation object
satelliteAzimuth object
targetAzimuth object
satelliteElevation object
offNadirAngle object
bandMetadata object
property name* CollectBandMetadata
Possible values: [pan
, blue
, green
, red
, nir1
, coastal
, yellow
, red_edge
, red_edge1
, red_edge2
, nir2
, s1
, s2
, s3
, s4
, s5
, s6
, s7
, s8
, dem
, alpha
, undefined
]
bandsetMetadata object
property name* CollectBandsetMetadata
Possible values: [PAN
, PAN_WITH_ALPHA
, RGB
, RGBA
, RGBN
, BGR
, BGRA
, BGRN
, WORLDVIEW_8_BAND
, WORLDVIEW_SWIR
, LEGION_8_BAND
, UNSPECIFIED
]
Band Color Interpretation
Possible values: [pan
, blue
, green
, red
, nir1
, coastal
, yellow
, red_edge
, red_edge1
, red_edge2
, nir2
, s1
, s2
, s3
, s4
, s5
, s6
, s7
, s8
, dem
, alpha
, undefined
]
bands object
Image band names
{
"imageMetadata": {
"version": "1.1",
"minTileX": 0,
"minTileY": -1,
"maxTileX": 201,
"maxTileY": 212,
"tileSizeX": 256,
"tileSizeY": 256,
"numBands": 8,
"dataType": "UNSIGNED_SHORT",
"minPixelX": 0,
"minPixelY": -1,
"maxPixelX": 51654,
"maxPixelY": 54276,
"tileOffsetX": 0,
"tileOffsetY": 0
},
"spatialTransform": {
"spatialReferenceSystemType": "EPSG",
"spatialReferenceSystemIdentifier": "EPSG:4326",
"affine": {
"scaleX": 0.000006325,
"scaleY": 0.000006325,
"translateX": -112.35,
"translateY": 33.526,
"shearX": 0,
"shearY": 0
}
},
"sourceMetadata": {
"collectId": "string",
"imageBoundsWGS84": "string",
"vehicleName": "WV03",
"vendorName": "string",
"vendorDatasetIdentifier": "string",
"firstLineTime": "string",
"scanDirection": "Forward",
"dsaOrderMirrorFlag": true,
"theoreticalLowDN": 0,
"theoreticalHighDN": 0,
"sunAzimuth": {
"min": 0,
"max": 0,
"mean": 0
},
"sunElevation": {
"min": 0,
"max": 0,
"mean": 0
},
"satelliteAzimuth": {
"min": 0,
"max": 0,
"mean": 0
},
"targetAzimuth": {
"min": 0,
"max": 0,
"mean": 0
},
"satelliteElevation": {
"min": 0,
"max": 0,
"mean": 0
},
"offNadirAngle": {
"min": 0,
"max": 0,
"mean": 0
},
"cloudCover": 0,
"bandMetadata": {},
"bandsetMetadata": {}
},
"bands": {
"empty": true
}
}
Script was found but parameters were invalid
- application/json
- Schema
- Example (from schema)
Schema
status objectrequired
parameters objectrequired
{
"type": "string",
"title": "string",
"status": {
"statusCode": 0,
"reasonPhrase": "string"
},
"detail": "string",
"parameters": {}
}
Unauthorized
- application/json
- Schema
- Example (from schema)
Schema
status objectrequired
parameters objectrequired
{
"type": "string",
"title": "string",
"status": {
"statusCode": 0,
"reasonPhrase": "string"
},
"detail": "string",
"parameters": {}
}
Script not found
- application/json
- Schema
- Example (from schema)
Schema
status objectrequired
parameters objectrequired
{
"type": "string",
"title": "string",
"status": {
"statusCode": 0,
"reasonPhrase": "string"
},
"detail": "string",
"parameters": {}
}