An oriented imagery layer is a type of feature layer for visualizing oriented imagery in the context of a map or a 3D scene.
An oriented imagery feature service or an oriented imagery dataset is visualized on the map or scene as an oriented imagery layer. When added to the map, each point in the layer indicates the camera location where an image was acquired. The attributes of the points include the path to the stored image, and the key metadata required to visualize the image in the oriented imagery viewer.
There may be an optional oriented imagery footprint layer that indicates the areas on the map where the oriented imagery layer has coverage. In this case, the data source for the layer will change how the layer appears in the Contents pane.
If the data source for the layer is an oriented imagery dataset, the footprint feature name can be added as the Footprint Item property in the oriented imagery dataset (assuming the footprint feature class and the oriented imagery dataset are in the same geodatabase). When an oriented imagery dataset with a Footprint Item property is added to the map, the oriented imagery layer and oriented imagery footprint layer are added to the Contents pane as two separate layers.
Alternately, if the data source is a feature service in ArcGIS Online or ArcGIS Enterprise, both the footprint feature layer and oriented imagery layer are sublayers of the same feature service. When that feature service is added to the map, the oriented imagery feature layer and oriented imagery footprints feature layer are added to the Contents pane as a group layer.
Layer attribute table and properties
The layer inherits the attributes and properties of the source oriented imagery dataset, or oriented imagery feature service, that is added to the map. You can edit or add attributes to an editable feature class by interacting with the layer attribute table.
The oriented imagery layer properties Maximum Distance, Coverage Percentage, Camera Heading, Camera Pitch, Camera Roll, Camera Height, Horizontal Field Of View, Vertical Field Of View, Near Distance, Far Distance, and Image Rotation can be edited on the layer instance. Editing the oriented imagery layer properties will not impact the source data properties.
Note:
If a field is not defined in the attribute table, the values defined for that field in the oriented imagery dataset property will be applied. However, when a value is explicitly defined in the attribute table, it is prioritized. For example, if a value for the Camera Pitch field is defined in the attribute table, this value is used instead of the value defined for the Camera Pitch field in the oriented imagery dataset property.
Oriented imagery layer ribbon
When an oriented imagery layer is selected in the Contents pane, the Oriented Imagery Layer ribbon is displayed.
Note:
To view the oriented imagery layer ribbon, you must select the oriented imagery layer only. Selecting the group layer or oriented imagery footprint layer does not display the Oriented Imagery Layer ribbon.
Explore Images tool
To visualize oriented images in the oriented imagery viewer, select the Explore Images tool from the Oriented Imagery Layer ribbon. Click any point in the map or scene to select it. A red cross appears at the selected location on the map to mark the selection.
If there are images in the oriented imagery layer that depict the selected location, the best available image will be loaded in the oriented imagery viewer. The red cross is seen at the best estimate for the location in the image.
Note:
The best image for the location is based on the distance of the camera from the selected location, the camera heading (direction), and the obliquity (camera pitch).
If there are no images to depict the selected location, a message conveying the same appears in the viewer. If an accompanying footprint layer is available, use it as a reference to see where on the map the oriented imagery is located and available. You can use the Navigation and Image Gallery tools in the oriented imagery viewer to explore other images of the selected map location.
Show the Current Footprint, Footprints, and Camera Locations tools
There are three graphics layers that you can view for an understanding of how the images in the oriented imagery relate to the map, namely, Current Footprint, Footprints, and Camera Locations. To view a graphical layer, select the relevant button from the Oriented Imagery Layer ribbon. To hide a graphical layer, click the selected button again.
When selected, Current Footprint displays the current footprint of the image as a red polygon in the map. In a scene, the current footprint will be displayed as a 3D frustum. If you zoom or pan in the oriented imagery viewer, the footprint dynamically updates to highlight the areas on the map that are visible in the image.
When selected, Footprints displays the coverage footprints in blue for all the images that contain the selected point (marked by a red cross ) in the map or scene.
When selected, Camera Locations displays the locations of all the camera feature points that contain the selected point in blue in the map or scene.
Note:
The Current Footprint, Footprints, and Camera Locations graphics layers cannot be accessed from the Contents pane, and their symbology cannot be modified.
Additional tools
The following are additional tools available to better understand oriented imagery:
- The Map-Image Location tool performs image-to-ground and ground-to-image transformations, identifying the same location in map space and in image space (oriented imagery viewer). If you select the tool and click the image, the corresponding location on the map will be identified with a red diamond. If you click the map, the corresponding location in the image will be identified with a red diamond.
- Click the Reset button to remove any oriented imagery graphics layers from the map and refresh the oriented imagery viewer.
Oriented imagery viewer
Oriented images are displayed in the oriented imagery viewer. The viewer includes tools that support exploring and managing images in an oriented imagery layer.
Select the Explore Images tool and click the map or scene for the best available image of the location to be loaded (assuming the oriented imagery layer has coverage in that location). The red cross is seen at the best estimate for the location in the image.
Explore additional images in the oriented imagery viewer
To explore additional images in the oriented imagery viewer, do the following:
- Select the Navigation tool to explore the images that contain the selected location on the map using a compass.
The selected location is visualized as a red cross in the center of the Navigation tool and on the map. Camera location for images that include the selected map location are shown as points on the tool, arranged based on their distance and heading relative to the red cross . The tool is divided into four quadrants (north, south, east, and west); each quadrant is divided into three segments that show the relative distance of each camera location from the selected location on the map.
For the current image in the oriented imagery viewer, the camera location and heading relative to the red cross are shown in red. Additional camera locations depicting the selected map location are shown in blue. To view a different image of the selected map location, click a blue dot, or click a tool segment to view the best image from that segment (segments with images are shown in white; segments without images are gray).
- Select Image Gallery to explore a carousel of low-resolution thumbnails of all images that depict the selected map location. Click a thumbnail to view the full-resolution image in the oriented imagery viewer.
Note:
The Image Gallery is supported only for image formats that are internally tiled, such as MRF or COG. The Image Gallery is not supported for JPEG images. If the image format is not supported by Image Gallery, the tool will be unavailable.
Image Enhancement
Select the Image Enhancement button to adjust brightness, contrast, and sharpness of the image in the oriented imagery viewer using interactive sliders. New settings will be maintained for subsequent images loaded in the oriented imagery viewer. Use the Reset button to reset to the original values at any time.
Note:
Image enhancement is not supported for 360-degree images, and the Image enhancement tool is unavailable for 360-degree images.
Pop-up
Click the Pop-up button to view the pop-up for the image in the oriented imagery viewer. Refer to Configure pop-ups for details on configuring pop-ups for feature layers.