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 to add the images listed in the table to an oriented imagery dataset.
The oriented imagery table is a useful option for adding images in the following instances:
- The image file format is something other than JPEG/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 take advantage of the Camera Orientation attribute 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, that 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. Note that a parameter defined in the oriented imagery table will take 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.
Fields supported 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. |
SRS | Required | Numeric | The coordinate system associated with the camera location as 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 cloud, MRF formats are also supported. |
Name | Optional | String | An alias name to identify the image. |
AcquisitonDate | 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 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 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 horizon. |
CameraRoll | Optional | Numeric | The camera orientation of the final rotation around 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; large values will result in a greater view extent. Values should not be less 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. FarDistance is used to determine the extent of the image footprint, which is used to determine if an image is returned when you click the map, and for creating optional footprint features. The units are in meters. Far distance should be always greater than 0. |
CameraOrientation | Optional | String | Stores detailed camera orientation parameters as a pipe-separated string. The field provides support for more accurate image-to-ground and ground-to-image transformations. |
OrientedImageryType | Optional | String | Defines the imagery type:
|
ImageRotation | Optional | Numeric | The orientation of the camera in degrees relative to the scene when the image was captured. The rotation is added in addition to CameraRoll. The value can 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 if the DEM is tile image service. If constant elevation is used, the following is the elevation source: {“constantElevation”:<elevation_value>} |