Tutorials
General
Robots
Meta data
Lots of files contain interesting information about their contents. Transloadit automatically extracts this meta information for any uploaded or processed files.
At the very minimum, each file will have the following information:
{ id: 'ae52b7f8c1b3426e8c29ea0a9daf8306'
, name: 'straw-apple.jpg'
, ext: 'jpg'
, size: 92230
, mime: 'image/jpeg'
, type: 'image'
, field: 'test_file'
, url: 'http://maynard.tmp.transloadit.com/upload/1324a798a99fce7f5f8289a95a74f02b.jpg'
, meta: {...}
}
| Key | Description |
|---|---|
| id | A unique random id we created to track this file internally. |
| name | The name of the file. We will change the extension used in this field if the file undergoes processing into a different format. |
| ext | The extension for the file. |
| size | The size of this file in bytes. |
| mime | The mime type we determined for this file. |
| type |
The abstract type this file is. Currently this can either be:
"image", "video", or null
|
| field | The name of the form field that was used to submit this file. |
| url | The url where you can access this file. This is either a url to your S3 bucket, or a temporary url on one of our servers. Temporary urls will expire after a few hours, so you need to make sure to move your files elsewhere if you aren't using a storage robot. |
| meta | Additional meta information we were able to extract for this file. See below. |
Image meta data
In addition to the information above, we try to extract the following
information from type = "image" files.
| Key | Description |
|---|---|
| width | The width of this image in pixel. |
| height | The height of this image in pixel. |
| date_recorded |
The date/time this image was taken. Format is:
YYYY/MM/DD HH:MM:SS TZ. For example:
"2010/06/30 22:16:06 GMT"
|
| date_file_created | The file system create time. |
| date_file_modified | The file system modified time. |
| title |
The title of this image: For example "Tree".
|
| keywords |
An array of keywords for this image. For example: ["tree", "nature"].
|
| description |
The description of this image: "This tree is very old.".
|
| location |
The location where this image was taken (usually the street). For example: "Zingster Str. 32".
|
| city |
The city where this image was taken. For example: "Berlin".
|
| state |
The state where this image was taken. For example: "Berlin".
|
| country |
The country where this image was taken. For example: "Germany".
|
| country_code |
The country code of the country where this image was taken. For example: : "de".
|
| aperture |
The aperture of this image. For example: 5.7.
|
| exposure_compensation |
The exposure compensation of this image. For example: "+4/3".
|
| exposure_mode |
The exposure mode of this image. For example: "Auto".
|
| exposure_time |
The exposure time of this image. For example: "1/30".
|
| flash |
The flash settings for this image. For example: "Off, Did not fire".
|
| focal_length |
The focal length of this image. For example: "55.0 mm".
|
| f_number |
The f-number of this image. For example: 5.6.
|
| iso |
The iso value of this image. For example: 800.
|
| light_value |
The light value of this image. For example: 6.9.
|
| metering_mode |
The metering mode of this image. For example: "Multi-segment".
|
| shutter_speed |
The shutter speed of this image. For example: "1/32".
|
| white_balance |
The white balance setting of this image. For example: "Manual".
|
| device_name |
The device name of the camera. For example: "iPhone 3GS".
|
| device_vendor |
The device vendor of the camera. For example: "Apple".
|
| device_software |
The device software version of the camera. For example: "3.1.2".
|
| latitude |
The latitude where this image was taken. For example: 52.5374.
|
| longitude |
The longitude where this image was taken. For example: 13.4034.
|
Video meta data
Files of type = "video" contain the following meta information:
| Key | Description |
|---|---|
| width | The width of this video in pixel. In case this video is meant to be displayed with a different display ratio than pixel ratio, this indicates the width you want to display the video at. |
| height | The height of this video in pixel. |
| framerate |
The framerate of this video. For example: 29.5.
|
| video_bitrate |
The video bitrate of this video. For example: 500000.
|
| video_codec |
The video codec of video. For example: "ffh264".
|
| audio_bitrate |
The audio bitrate of this video. For example: 128000.
|
| audio_samplerate |
The audio samplerate of this video. For example: 44100.
|
| audio_channels |
The number of audio channels in this video. For example: 2.
|
| audio_codec |
The audio codec of video. For example: "faad".
|
| seekable |
Whether or not this video format supports seeking. For example: true.
|
| date_recorded | See image meta data. |
| date_file_created | See image meta data. |
| date_file_modified | See image meta data. |
| device_name | See image meta data. |
| device_vendor | See image meta data. |
| device_software | See image meta data. |
| latitude | See image meta data. |
| longitude | See image meta data. |
