# Street Smart plugin

## Installation

To install the QGIS Street Smart plugin, you have two options: directly through the plugin window or using the ZIP file installation method.

Option 1: Direct Installation through the Plugin Window

In the Plugins menu, select the "Manage and Install Plugins..." option. Search for "StreetSmart" in the plugin window and click "Install" to directly install the plugin.

Search for "StreetSmart" and install directly from the plugin window.

Option 2: Install from ZIP File

In the Plugins menu, select the "Manage and Install Plugins..." option, then choose the "Install from ZIP" option and navigate to the folder where the ZIP file is located.

Select the "Install from ZIP" option and navigate to the folder where the ZIP file is located.

Once the plugin is installed, verify that it is enabled. The plugin can be found in the Installed Plugins tab. Ensure the checkbox next to the StreetSmart plugin is checked.

Enable the plugin in the Installed Plugins tab.

Finally, restart QGIS to ensure all the functionality of the plugin is available.

## Prerequisites

Currently, the plugin only works on Windows 10 and 11. There are two versions of the plugin:

1. StreetSmart Plugin Version 3.0.8.120: This version works with QGIS versions that support Python 3.9. The supported QGIS versions are 3.20.0 to 3.37.0.
2. StreetSmart Plugin Version 3.0.6: This version works with QGIS versions that support Python versions up to 3.7. The supported QGIS versions are 3.6.0 to 3.19.0.

To use the StreetSmart plugin, three Python modules must be available in the QGIS environment: `cefpython3`, `geojson`, and `shapely`. An administrator can install these modules. If they are not already installed, the plugin will install them upon its first run. The user must have the necessary permissions to install these modules.

The module `cefpython3` requires Python version 2.7 or any version between 3.4 and 3.9, inclusive. On Windows, this is not an issue because a valid Python version is installed with QGIS, and the plugin helps to manage these modules.

The plugin uses the StreetSmart API. Therefore, to view CycloMedia imagery, a license from CycloMedia is required.

## Proxy Server

The plugin can be used behind a proxy server. Once installed, the plugin must have access to the following URIs:

- unpkg.com

- cdnjs.cloudflare.com

- atlas.cyclomedia.com

- atlas1.cyclomedia.com

- atlas2.cyclomedia.com

- atlas3.cyclomedia.com

- atlas4.cyclomedia.com

- streetsmart.cyclomedia.com