Get Image Information

Overview

The 'Get Image Information' collects and returns detailed information about the supplied image file, covering contained format, dimensions, EXIF data + more.

Image file formats supported: 

  • PNG
  • JPG / JPEG

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 'Get Image Information' flow action parameters are detailed below:

  • File Content: A Base64 encoded representation of the image

Advanced Parameters

The advanced 'Get Image Information' 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 'Get Image Information' 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

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk