# Street Smart Plugin

## User Guide

The Street Smart plugin enables the integration of CycloMedia's Cyclorama images into QGIS. An additional window displays these images and synchronizes with the QGIS canvas.

With the Street Smart plugin for QGIS, users can:

- Add the recording locations of Cycloramas as a WFS layer in QGIS.
- Create QGIS features based on measurements taken in Cycloramas.
- Show QGIS vector layers as overlays in the Cycloramas.

To utilize all the plugin's features, users must have the necessary credentials for accessing, CycloMedia images. These credentials should be entered in the login tab of the settings window.

## Toolbar

The plugin adds several commands to QGIS, accessible from the plugin menu. Many of these commands are also available in the plugin toolbar.

Buttons added to the toolbar by the plugin.

Commands added by the Street Smart plugin.

## Add Atlas Recording WFS

This button adds a WFS layer to the current project with the currently valid CycloMedia recordings. The valid recordings are filtered using the following criteria:

>     expiredAt is null

The layer is placed at the top of the legend and is named ‘CycloMedia Recordings’. Note that no account is taken for any layers with the same name. This button is always enabled.

## Select Cyclorama Point

This button allows you to select a recording on the canvas. The cyclorama of the selected recording is displayed in the viewer. If the viewer is not open, it will be opened; if it is already open, the plugin shows the cyclorama in the same window. A cone on the canvas map indicates the viewing direction in the cyclorama. This button is enabled if a recording layer is added to the project.

The panorama viewer uses the coordinate system of the map canvas. If the QGIS coordinate system changes, the viewer's CRS remains in the previous CRS until a new panorama is selected in QGIS. Walking through different cycloramas in the viewer keeps the CRS in its previous state.

## Add an Overlay to the Cyclorama Window

This button transfers data from the visible layers around the cone to the viewer. This button is only enabled when a viewer window is open.

Viewer with vector layers as overlays.

The features displayed are within 30 meters of the current Cyclorama. As long as the overlay button is checked, QGIS will send features within the query distance around the cone to the viewer. Users can control the visibility of layers in the viewer.

If a layer that was not visible in QGIS should be sent to the viewer, the user must first make it visible. By toggling the overlay button, the additional layer is sent to the viewer.

## Create a Measurement

This button is a toggle. When checked, and if an editable layer is selected, measurements made in the viewer are transferred to QGIS and added as features in the selected layer.

The measurement functionality allows users to copy objects from the images into a QGIS layer, regardless of whether the layer refers to a database or is a scratch layer.

When the measurement toggle is on, the appropriate measurement type is displayed in the cyclorama window depending on the layer type: for a point layer, it shows the location type; for a polyline layer, the distance type; and for a polygon layer, the surface type.

View when a point layer is selected in measurement mode.

View when a polyline layer is selected in measurement mode.

View when a polygon layer is selected in measurement mode.

Users can draw in the cyclorama, and the points are transferred to the QGIS layer. For a point layer, this happens after the first point; for line and area layers, 2 or 3 points must be indicated, respectively.

A point selected in the Cyclorama viewer is added to the QGIS layer.

As long as new points are entered in the cyclorama window, the drawn object is updated. A new object is started by clicking on the measurement type in the cyclorama window. The objects are stored in the QGIS layer in the standard QGIS way.

Clicking on the measurement type confirms the first point and prepares QGIS for another point feature.

## Settings

This button displays a dialog window where data such as username, password, and URLs can be set.

Window for setting username and password.

Window for setting URLs for the StreetSmart API and proxy.

Window settings for filtering the Cyclorama points. The default setting is no filter. Enable this option and use the slider to adjust the filter distance in meters for:

- Latitude (X)
- Longitude (Y)
- Height (Z)