定向影像表用于定义影像集合的元数据。 它用作将影像添加至定向影像数据集地理处理工具的输入。
在以下情况下，定向影像表可用于添加影像：
- 影像文件格式是 JPEG 或 JPG 以外的受支持的影像格式。
- 影像元数据与影像文件分开存储。
- 影像元数据需要预处理，然后才能添加到定向影像数据集。
- 需要使用 CameraOrientation 字段，该字段可用于改善影像到地面和地面到影像转换，同时支持使用 omega、phi、kappa；偏航角、俯仰角、滚动；以及局部切平面定义的影像方向。
如果在定向影像表中任何可选字段的值对于所有影像是相同的，则可以在定向影像数据集属性中为所有影像定义默认值。 例如，如果所有影像使用同一高程源，则该高程源可以定义为一个定向影像数据集属性并且可以从定向影像表中移除。
定向影像表字段
下面列出了支持的定向影像表字段。 在定向影像表中定义的参数优先于定向影像数据集属性中的任何重复定义。 定向影像表中的其他字段可以包含在输出定向影像数据集中，前提是在将图像添加至定向影像数据集工具中选中包含输入表中的所有字段。
定向影像表中支持的字段
| 字段名 | 字段类型 | 数据类型 | 描述 |
|---|---|---|---|
X | 必填 | 数值 | 地面坐标系中照相机位置的 x 坐标。 单位为在 SRS 字段中定义的坐标系单位。 |
Y | 必填 | 数值 | 地面坐标系中照相机位置的 y 坐标。 单位为在 SRS 字段中定义的坐标系单位。 |
Z | 可选 | 数值 | 照相机位置在地面坐标系中的 z 坐标。 z 坐标单位必须与 x 和 y 坐标单位一致。 |
SRS | 必填 | 数值 | 与采用 WKID 形式的照相机位置关联的坐标系。 |
ImagePath | 必填 | 字符串 | 图像文件的路径。 此值可以是本地路径或可通过 Web 访问的 URL。 影像格式可以为 JPEG、JPG 或 TIF。 对于存储在云中的影像，还支持 MRF 格式。 |
Name | 可选 | 字符串 | 用于识别影像的别名。 |
AcquisitionDate | 可选 | 日期 | 影像的采集日期。 还可以包含影像采集时间。 |
CameraHeading | 可选 | 数值 | 围绕照相机 z 轴的一次旋转的照相机方向。 值以度为单位。 朝向值沿正顺时针方向测量，其中北向定义为 0 度。 当方向未知时，将使用 -999。 |
CameraPitch | 可选 | 数值 | 围绕照相机 x 轴的二次旋转的照相机方向，沿正逆时针方向。 值以度为单位。 当照相机正对地面时，俯仰角为 0 度。 有效的俯仰角值范围介于 0 到 180 度之间，其中 180 度表示照相机垂直朝上，90 度表示照相机朝向为水平。 |
CameraRoll | 可选 | 数值 | 围绕照相机 z 轴的最终旋转的照相机方向，沿正顺时针方向。 值以度为单位。 有效值范围介于 -90 到 90 之间。 |
CameraHeight | 可选 | 数值 | 照相机在地面上方的高度（高程源）。 单位为米。 照相机高度用于确定影像的可见范围，值越大，生成的视图范围越大。 该值必须大于 0。 |
HorizontalFieldOfView | 可选 | 数值 | 照相机沿水平方向的范围。 单位为度，有效值介于 0 到 360 度之间。 |
VerticalFieldOfView | 可选 | 数值 | 照相机沿垂直方向的范围。 单位为度，有效值介于 0 和 180 之间。 |
NearDistance | 可选 | 数值 | 影像相对于照相机位置的最近可用距离。 单位为米。 |
FarDistance | 可选 | 数值 | 影像相对于照相机位置的最远可用距离。 此值用于确定影像覆盖区的范围，该范围用于确定单击地图时是否返回影像，并用于创建可选覆盖区要素。 单位为米。 此值必须大于 0。 |
CameraOrientation | 可选 | 字符串 | 将详细的照相机方向参数存储为管道分离的字符串。 字段可支持更准确的影像到地面和地面到影像转换。 |
OrientedImageryType | 可选 | 字符串 | 从以下类型中指定影像类型：
|
ImageRotation | 可选 | 数值 | 采集影像时照相机相对于场景的方向，以度为单位。 该值将添加到 CameraRoll。 有效值的范围为 -360 到 360。 |
ElevationSource | 可选 | 字符串 | 采用 JSON 字符串形式的高程源，将用于计算地面到影像转换。 高程源可以为数字高程模型 (DEM) 或常量值。 可将动态影像服务或切片影像服务用作数字高程模型。 VerticalMeasurementUnit 值将用作常量高程的单位。 例如，如果使用的是 DEM，则高程源如下： {“url”:<dem_url>,”rasterFunction”:,”lod”:} 如果 DEM 是动态影像服务，则可以提供 rasterFunction，如果 DEM 是切片影像服务，则可以提供细节层次。 如果使用的是常量高程，则高程源如下： {“constantElevation”:<elevation_value>} |