Data Capture Tools available in the Oriented Imagery Widget enables users to create new features directly in the image space - ideal for inspection workflows. Users can mark assets and capture useful data from images displayed in the oriented imagery viewer.
How it works
Users can capture data from images, such as broken traffic lights, misplaced fire hydrants, or potholes. Features created in the viewer are stored in an external feature layer. These features can be brought back into the viewer as image overlays and visualized on the map as regular features.
Requirements
- Schema Requirements: The digitization feature layers must have:
- ImageGeometry: A Blob type field storing image pixel coordinates of new features.
- OIObjectID: A string field storing the Object ID reference of the image where the feature was created.
- Editing Enabled: Feature layers must have editing enabled in the layer settings.
- Access: Users must have access to edit the layer, meaning it should be shared with them.
Note:
- Feature layers used for data capture must be added to the same web map or web scene as the Oriented Imagery layer.
- External layers do not have explicit properties connecting them to the Oriented Imagery layer.
- One Oriented Imagery layer can have multiple digitized layers, but each digitized layer is mapped to only one Oriented Imagery layer.
Users can incorporate OrientedImageryLayers into their chosen WebMap that includes the digitizable layers used for data capture. Below is an example of an OrientedImageryLayer added to WebMap.
// create an instance of the webmap in mapview
const map = new WebMap({
basemap: "hybrid",
portalItem: {
id: "2fa457d973b1401d90cceccd31c64c0b"
}
});
const view = new MapView({
map,
container: "viewDiv"
});
Users can also add their preferred OrientedImageryLayers onto the WebMap at run time, or have it saved in the parent WebMap itself.
// create an instance of an oriented imagery layer and add it to scene
const layer = new OrientedImageryLayer({
portalItem: {
id: "174fd61f470944848c948659e2e98869"
}
});
map.layers.add(layer);
// zoom to the full extent of the layer when layer is loaded
// set the oriented imagery layer to be used with an oriented imagery viewer
view.whenLayerView(layer).then(() => {
view.goTo(layer.fullExtent);
orientedImageryViewer.layer = layer;
});
The oriented imagery viewer widget allows users to explore their oriented images from the Oriented Imagery layers. Users can click on a scene to view the best image in their collection depicting that location. They can then view assets from multiple directions, and enhance contrast, brightness and sharpening to better see these images.
// create a new instance of the oriented imagery viewer widget
const orientedImageryViewer = new OrientedImageryViewer({
view,
disabled: false,
container: "oi-container"
});
Once the widget is loaded, click on the map where features are visible to display the most suitable image for the selected location.
The Image overlays tool available in the Oriented Imagery viewer enable users to visualize and overlay map features that intersect with the image’s footprint within the viewer. 'imageOverlaysOpened' indicates whether the image overlays tab in the viewer is open. Once opened users can toggle between the two available options to overlay camera locations or map features in the loaded image.
// set imageOverlaysOpened property to true; to open the image overlay panel in the widget
orientedImageryViewer.imageOverlaysOpened = true;
'dataCaptureEnabled' indicates whether the data capture tools are enabled in the oriented imagery viewer for digitization.
When set to true , the data capture (edit) option will be visible on the digitizable overlaid feature layers available in the image overlays tab.
On clicking the data capture option, the digitization tools will appear at the bottom of the viewer once the overlay tab is closed.
// set dataCaptureEnabled property to true; to enable the data capture tools in the widget
orientedImageryViewer.dataCaptureEnabled = true;
Select the draw tool (point, polyline, or polygon) to begin digitizing features in the image space. Save these features to the chosen feature layer in the overlays tab by clicking the save button. The saved features will be added to the respective feature layer and displayed in the map view.