Overview
The 'Image - Extract Metadata' collects and returns detailed information about the supplied image file, covering contained format, dimensions, EXIF data + more.
The Image file formats supported can be split into two categories:
Formats where detailed information will be extracted:
|
|
Formats where only basic information will be extracted i.e image format, filesize, height, width, orientation and bits per pixel:
|
|
Example Flow
Please refer to example solutions:
Credit Count
This action consumes 1 credit per operation.
Note, different Encodian actions can consume different number credits. Please always check the action specific documentation and read What is an Encodian Action for a full description of how credits are consumed.
Default Parameters
The default 'Image - Extract Metadata' flow action parameters are detailed below:
- File Content: A Base64 encoded representation of the image
Advanced Parameters
The advanced 'Image - Extract Metadata' flow action parameters are detailed below:
- Simplified Lat/Long Format: Return the Latitude and Longitude as a formatted string e.g., '45° 26’ 21 N'
Return Parameters
The 'Image - Extract Metadata' flow action returns the following data.
Action Specific Return Values
- Image Format - The file format of the image
- File Size (MBs) - The size of the supplied image in MBs
- Width - The width of the image (Pixels)
- Height - The height of the image (Pixels)
- Orientation - The orientation of the image
- Bits per Pixel - The image bits per pixel count
- Horizontal Resolution - The horizontal image resolution (DPI)
- Vertical Resolution - The vertical image resolution (DPI)
- Has EXIF Data - Confirms whether the image contains EXIF Data
- EXIF Data (JSON) - Image EXIF Data provided as a JSON string
-
Has XMP Data - Confirms whether the image contains XMP Data
The 'EXIF Data (JSON)' value provides a JSON string containing the values of all the contained EXIF tags. The JSON string can be parsed using the following schema:
{
"type": "object",
"properties": {
"apertureValue": {
"type": "number"
},
"artist": {
"type": "string"
},
"bodySerialNumber": {
"type": "string"
},
"brightnessValue": {
"type": "number"
},
"cameraOwnerName": {
"type": "string"
},
"colorSpace": {
"type": "string"
},
"compressedBitsPerPixel": {
"type": "integer"
},
"compression": {
"type": "integer"
},
"contrast": {
"type": "string"
},
"customRendered": {
"type": "string"
},
"dateTime": {
"type": "string"
},
"dateTimeDigitized": {
"type": "string"
},
"dateTimeOriginal": {
"type": "string"
},
"digitalZoomRatio": {
"type": "integer"
},
"exposureBiasValue": {
"type": "integer"
},
"exposureIndex": {
"type": "integer"
},
"exposureMode": {
"type": "string"
},
"exposureProgram": {
"type": "string"
},
"exposureTime": {
"type": "number"
},
"fileSource": {
"type": "string"
},
"flash": {
"type": "string"
},
"flashEnergy": {
"type": "integer"
},
"fNumber": {
"type": "number"
},
"focalLength": {
"type": "number"
},
"focalLengthIn35MmFilm": {
"type": "integer"
},
"focalPlaneXResolution": {
"type": "integer"
},
"focalPlaneYResolution": {
"type": "integer"
},
"gainControl": {
"type": "string"
},
"gamma": {
"type": "integer"
},
"gpsAltitude": {
"type": "number"
},
"gpsAltitudeRef": {
"type": "string"
},
"gpsDateStamp": {
"type": "string"
},
"gpsDestBearing": {
"type": "number"
},
"gpsDestBearingRef": {
"type": "string"
},
"gpsDestDistance": {
"type": "integer"
},
"gpsDestDistanceRef": {
"type": "string"
},
"gpsDestLatitudeRef": {
"type": "string"
},
"gpsDestLongitudeRef": {
"type": "string"
},
"gpsDifferential": {
"type": "integer"
},
"gpsDop": {
"type": "integer"
},
"gpsImgDirection": {
"type": "number"
},
"gpsImgDirectionRef": {
"type": "string"
},
"gpsLatitude": {
"type": "string"
},
"gpsLatitudeRef": {
"type": "string"
},
"gpsLongitude": {
"type": "string"
},
"gpsLongitudeRef": {
"type": "string"
},
"gpsMapDatum": {},
"gpsMeasureMode": {},
"gpsSatellites": {},
"gpsSpeed": {
"type": "integer"
},
"gpsSpeedRef": {
"type": "string"
},
"gpsStatus": {
"type": "string"
},
"gpsTrack": {
"type": "string"
},
"gpsTrackRef": {
"type": "string"
},
"imageUniqueId": {
"type": "string"
},
"isBigEndian": {
"type": "boolean"
},
"isoSpeed": {
"type": "integer"
},
"isoSpeedLatitudeYyy": {
"type": "integer"
},
"isoSpeedLatitudeZzz": {
"type": "integer"
},
"lensMake": {
"type": "string"
},
"lensModel": {
"type": "string"
},
"lensSerialNumber": {
"type": "string"
},
"lightSource": {
"type": "string"
},
"make": {
"type": "string"
},
"maxApertureValue": {
"type": "integer"
},
"meteringMode": {
"type": "string"
},
"model": {
"type": "string"
},
"orientation": {
"type": "string"
},
"photographicSensitivity": {
"type": "integer"
},
"pixelXDimension": {
"type": "integer"
},
"pixelYDimension": {
"type": "integer"
},
"recommendedExposureIndex": {
"type": "integer"
},
"relatedSoundFile": {},
"saturation": {
"type": "string"
},
"sceneCaptureType": {
"type": "string"
},
"sensingMethod": {
"type": "string"
},
"sensitivityType": {
"type": "integer"
},
"sharpness": {
"type": "integer"
},
"shutterSpeedValue": {
"type": "number"
},
"spectralSensitivity": {
"type": "string"
},
"standardOutputSensitivity": {
"type": "integer"
},
"subjectDistance": {
"type": "integer"
},
"subjectDistanceRange": {
"type": "string"
},
"subsecTime": {
"type": "string"
},
"subsecTimeDigitized": {
"type": "string"
},
"subsecTimeOriginal": {
"type": "string"
},
"userComment": {
"type": "string"
},
"whiteBalance": {
"type": "string"
}
}
}
Standard Return Values
- Filename - The filename provided
- FileContent - A base64 string representation of the archive (.zip) file
- OperationId - The unique ID assigned to this operation
- HttpStatusCode - The HTTP Status code for the response
- HttpStatusMessage - The HTTP Status message for the response
- Errors - An array of error messages should an error occur
- Operation Status - Indicates whether the operation has been completed, has been queued or has failed
2 Comments