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 name | Field type | Data type | Description |
|---|---|---|---|
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:
|
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>} |