API reference - Ricoh Theta

camera._getMetadata command response on successful completion

Definitions
Type object

Example:

{
    "results": {
        "exif": {
            "ApertureValue": 0.0,
            "BrightnessValue": 0.0,
            "ColorSpace": 1.0,
            "Compression": 6.0,
            "Copyright": "",
            "DateTime": "2024:05:13 13:15:34",
            "ExifVersion": "0231",
            "ExposureBiasValue": 0.0,
            "ExposureProgram": 2.0,
            "ExposureTime": 0.03333333333333333,
            "FNumber": 2.4,
            "Flash": 32.0,
            "FocalLength": 1.37,
            "GPSLatitude": 35.59204166666667,
            "GPSLatitudeRef": "N",
            "GPSLongitude": 139.55558055555557,
            "GPSLongitudeRef": "E",
            "ImageDescription": "",
            "ImageLength": 2752.0,
            "ImageWidth": 5504.0,
            "Make": "RICOH",
            "Model": "RICOH THETA X ",
            "Orientation": 1.0,
            "PhotographicSensitivity": 200.0,
            "Software": "RICOH THETA X Ver 2.50.2",
            "WhiteBalance": 0.0
        },
        "xmp": {
            "CroppedAreaImageHeightPixels": 2752,
            "CroppedAreaImageWidthPixels": 5504,
            "CroppedAreaLeftPixels": 0,
            "CroppedAreaTopPixels": 0,
            "FullPanoHeightPixels": 2752,
            "FullPanoWidthPixels": 5504,
            "ProjectionType": "equirectangular",
            "UsePanoramaViewer": true
        }
    },
    "name": "camera._getMetadata",
    "state": "done"
}
Property Type Required Description
name const yes Executed command name
state const yes Command execution status
results object yes -

name

Definitions
Type const

Description: Executed command name

Specific value: "camera._getMetadata"

state

Definitions
Type const

Description: Command execution status

Specific value: "done"

results

Definitions
Type object
Property Type Required Description
exif object yes EXIF information
xmp object yes Photo Sphere XMP metadata in JSON format

exif

Definitions
Type object

Description: EXIF information

Property Type Required Description
ApertureValue number yes Aperture value
BrightnessValue number yes Brightness value
ColorSpace integer yes Color space
Compression integer yes Compression format
Copyright string yes Copyright notice to the image
DateTime string yes Time created or updated
ExifVersion string yes EXIF Support version
ExposureBiasValue number yes Exposure compensation value
ExposureProgram integer yes Exposure program
ExposureTime number yes Exposure time
Flash integer yes Flash exposure
FNumber number yes F number
FocalLength number yes Focal length
GPSLatitude number yes Latitude
GPSLatitudeRef enum (of string) yes Indicates whether the latitude is north or south latitude
GPSLongitude number yes Longitude
GPSLongitudeRef enum (of string) yes Indicates whether the longitude is east or west longitude
ImageDescription string yes Title or name
ImageLength integer yes Height (pixel)
ImageWidth integer yes Width (pixel)
Make string yes Theta manufacturer
Model string yes Theta model
Orientation integer yes Image orientation
PhotographicSensitivity integer yes Shooting sensitivity
Software string yes The name and version of the firmware of Theta
WhiteBalance integer yes White balance

ApertureValue

Definitions
Type number

Description: Aperture value

BrightnessValue

Definitions
Type number

Description: Brightness value

ColorSpace

Definitions
Type integer

Description: Color space

Compression

Definitions
Type integer

Description: Compression format

Definitions
Type string

Description: Copyright notice to the image

DateTime

Definitions
Type string

Description: Time created or updated

Restrictions
Must match regular expression ^[0-9]{4}:[0-9]{2}:[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}$ Test

ExifVersion

Definitions
Type string

Description: EXIF Support version

ExposureBiasValue

Definitions
Type number

Description: Exposure compensation value

ExposureProgram

Definitions
Type integer

Description: Exposure program

ExposureTime

Definitions
Type number

Description: Exposure time

Flash

Definitions
Type integer

Description: Flash exposure

FNumber

Definitions
Type number

Description: F number

FocalLength

Definitions
Type number

Description: Focal length

GPSLatitude

Definitions
Type number

Description: Latitude

Restrictions
Minimum ≥ 0
Maximum ≤ 90

GPSLatitudeRef

Definitions
Type enum (of string)

Description: Indicates whether the latitude is north or south latitude

Must be one of:

GPSLongitude

Definitions
Type number

Description: Longitude

Restrictions
Minimum ≥ 0
Maximum ≤ 180

GPSLongitudeRef

Definitions
Type enum (of string)

Description: Indicates whether the longitude is east or west longitude

Must be one of:

ImageDescription

Definitions
Type string

Description: Title or name

ImageLength

Definitions
Type integer

Description: Height (pixel)

ImageWidth

Definitions
Type integer

Description: Width (pixel)

Make

Definitions
Type string

Description: Theta manufacturer

Model

Definitions
Type string

Description: Theta model

Orientation

Definitions
Type integer

Description: Image orientation

PhotographicSensitivity

Definitions
Type integer

Description: Shooting sensitivity

Software

Definitions
Type string

Description: The name and version of the firmware of Theta

WhiteBalance

Definitions
Type integer

Description: White balance

xmp

Definitions
Type object

Description: Photo Sphere XMP metadata in JSON format

Property Type Required Description
CroppedAreaImageHeightPixels integer yes Height of actual image (pixel)
CroppedAreaImageWidthPixels integer yes Width of actual image (pixel)
CroppedAreaLeftPixels integer yes Width (pixel) from the panoramic image of the actual image
CroppedAreaTopPixels integer yes Height (pixel) from the panoramic image of the actual image
FullPanoHeightPixels integer yes Height (pixel) when the actual image size is based on a panoramic image
FullPanoWidthPixels integer yes Width (pixel) when the actual image size is based on a panoramic image
ProjectionType const yes Projection type. Google currently only supports equirectangular.
UsePanoramaViewer boolean yes Whether to display using the panorama viewer

CroppedAreaImageHeightPixels

Definitions
Type integer

Description: Height of actual image (pixel)

CroppedAreaImageWidthPixels

Definitions
Type integer

Description: Width of actual image (pixel)

CroppedAreaLeftPixels

Definitions
Type integer

Description: Width (pixel) from the panoramic image of the actual image

CroppedAreaTopPixels

Definitions
Type integer

Description: Height (pixel) from the panoramic image of the actual image

FullPanoHeightPixels

Definitions
Type integer

Description: Height (pixel) when the actual image size is based on a panoramic image

FullPanoWidthPixels

Definitions
Type integer

Description: Width (pixel) when the actual image size is based on a panoramic image

ProjectionType

Definitions
Type const

Description: Projection type. Google currently only supports equirectangular.

Specific value: "equirectangular"

UsePanoramaViewer

Definitions
Type boolean

Description: Whether to display using the panorama viewer