Oriented imagery table

An oriented imagery table defines metadata for a collection of images. It is used as an input to the Add Images To Oriented Images Dataset geoprocessing tool.

The oriented imagery table can be used for adding images in the following instances:

  • The image file format is a supported image format other than JPEG or JPG.
  • The image metadata is stored separately from the image files.
  • The image metadata needs preprocessing before being added to the oriented imagery dataset.
  • You want to use the CameraOrientation field, which is useful for improving the image-to-ground and ground-to-image transformations and also supports image orientations that are defined using omega, phi, kappa; yaw, pitch, roll; and a local tangent plane.

If any of the optional fields in the oriented imagery table has the same value for all images, a default value for all the images can be defined in the oriented imagery dataset properties. For example, if all images use the same elevation source, it can be defined as an oriented imagery dataset property and removed from the oriented imagery table.

Oriented imagery table fields

The supported oriented imagery table fields are listed below. A parameter defined in the oriented imagery table takes precedence over any duplicate definition in the oriented imagery dataset properties. Additional fields in the oriented imagery table can be included in the output oriented imagery dataset if Include all fields from input table is checked in the Add Images To Oriented Imagery Dataset tool.

Supported fields in the oriented imagery table

Field nameField typeData typeDescription

X

Required

Numeric

The x-coordinate of the camera location in the ground coordinate system. The units are in the coordinate system units defined in the SRS field.

Y

Required

Numeric

The y-coordinate of the camera location in the ground coordinate system. The units are in the coordinate system units defined in the SRS field.

Z

Optional

Numeric

The z-coordinate of the camera location in the ground coordinate system. The z-coordinate units must be consistent with the x- and y- coordinate units.

SRS

Required

Numeric

The coordinate system associated with the camera location as a WKID.

ImagePath

Required

String

The path to the image file. This can be a local path or a web-accessible URL. Images can be in JPEG, JPG, or TIF format. For images stored in the cloud, the MRF format is also supported.

Name

Optional

String

An alias name that identifies the image.

AcquisitionDate

Optional

Date

The date when the image was collected. The time of the image collection can also be included.

CameraHeading

Optional

Numeric

The camera orientation of the first rotation around the z-axis of the camera. The value is in degrees. The heading values are measured in positive clockwise direction, where north is defined as 0 degrees. -999 is used when the orientation is unknown.

CameraPitch

Optional

Numeric

The camera orientation of the second rotation around the x-axis of the camera in the positive counterclockwise direction. The value is in degrees. The pitch is 0 degrees when the camera is facing straight down to the ground. The valid range of pitch value is from 0 to 180 degrees, with 180 degrees for a camera facing straight up, and 90 degrees for a camera facing horizontally.

CameraRoll

Optional

Numeric

The camera orientation of the final rotation around the z-axis of the camera in the positive clockwise direction. The value is in degrees. Valid values range from -90 to 90.

CameraHeight

Optional

Numeric

The height of the camera above the ground (elevation source). The units are in meters. Camera height is used to determine the visible extent of the image in which large values result in a greater view extent. Values must be greater than 0.

HorizontalFieldOfView

Optional

Numeric

The camera’s scope in a horizontal direction. The units are in degrees, and valid values range from 0 to 360.

VerticalFieldOfView

Optional

Numeric

The camera’s scope in the vertical direction. The units are in degrees, and valid values range from 0 to 180.

NearDistance

Optional

Numeric

The nearest usable distance of the imagery from the camera position. The units are in meters.

FarDistance

Optional

Numeric

The farthest usable distance of the imagery from the camera position. This value is used to determine the extent of the image footprint, which is used to determine whether an image is returned when you click the map, and for creating optional footprint features. The units are in meters. This value must be greater than 0.

CameraOrientation

Optional

String

Stores detailed camera orientation parameters as a pipe-separated string. This field provides support for more accurate image-to-ground and ground-to-image transformations.

OrientedImageryType

Optional

String

Specifies the imagery type from the following:

  • Horizontal—Images where the exposure is parallel to the ground and looking to the horizon.
  • Oblique—Images where the exposure is at an angle to the ground, typically at about 45 degrees so the sides of objects can be seen.
  • Nadir—Images where the exposure is perpendicular to the ground and looking straight down. Only the top of objects can be seen.
  • 360—Images taken using specialized cameras that provide 360-degree spherical surround views.
  • Inspection—Close-up images of assets (less than 5 meters from the camera).

ImageRotation

Optional

Numeric

The orientation of the camera in degrees relative to the scene when the image was captured. The value is added to CameraRoll. The valid values range from -360 to 360.

ElevationSource

Optional

String

The source of elevation as a JSON string that will be used to compute ground-to-image transformations. The elevation source can be a digital elevation model (DEM) or a constant value. A dynamic image service or a tile image service can be used as the digital elevation model. The VerticalMeasurementUnit value will be used as the unit for constant elevation.

For example, if a DEM is used, the following is the elevation source:

{“url”:<dem_url>,”rasterFunction”:,”lod”:}

A rasterFunction can be provided if the DEM is a dynamic image service and level of detail can be provided if the DEM is a tile image service.

If constant elevation is used, the following is the elevation source:

{“constantElevation”:<elevation_value>}