Metadata-Version: 2.1
Name: streetviewdownloader
Version: 0.2.6
Summary: A Python library and utility to download Google StreetView images
Author-email: Christoph Fink <christoph.fink@helsinki.fi>
License: GPL-3.0-or-later
Project-URL: Documentation, https://streetviewdownloader.readthedocs.io/
Project-URL: Repository, https://github.com/DigitalGeographyLab/streetviewdownloader/
Project-URL: Change log, https://github.com/DigitalGeographyLab/streetviewdownloader/blob/main/CHANGELOG.md
Project-URL: Bug tracker, https://github.com/DigitalGeographyLab/streetviewdownloader/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: ConfigArgParse
Requires-Dist: geopandas
Requires-Dist: numpy
Requires-Dist: pandas
Requires-Dist: pygeos
Requires-Dist: pyproj
Requires-Dist: pyrosm
Requires-Dist: pyxdg
Requires-Dist: requests
Requires-Dist: shapely
Provides-Extra: docs
Requires-Dist: contextily ; extra == 'docs'
Requires-Dist: ipycache ; extra == 'docs'
Requires-Dist: ipykernel ; extra == 'docs'
Requires-Dist: ipyleaflet ; extra == 'docs'
Requires-Dist: ipython ; extra == 'docs'
Requires-Dist: ipython-genutils ; extra == 'docs'
Requires-Dist: ipywidgets ; extra == 'docs'
Requires-Dist: nbsphinx ; extra == 'docs'
Requires-Dist: Sphinx ; extra == 'docs'
Requires-Dist: sphinx-rtd-theme ; extra == 'docs'
Requires-Dist: sphinxcontrib-applehelp ; extra == 'docs'
Requires-Dist: sphinxcontrib-devhelp ; extra == 'docs'
Requires-Dist: sphinxcontrib-htmlhelp ; extra == 'docs'
Requires-Dist: sphinxcontrib-jsmath ; extra == 'docs'
Requires-Dist: sphinxcontrib-qthelp ; extra == 'docs'
Requires-Dist: sphinxcontrib-serializinghtml ; extra == 'docs'

# streetviewdownloader

**Streetviewdownloader** is a Python>=3.9 library and utility to download images from Google’s StreetView Static API.

## Installation

**Streetviewdownloader** is available from PyPi:

```
pip install streetviewdownloader
```

Alternatively, it can be built from source:

```
git clone https://github.com/DigitalGeographyLab/streetviewdownloader
cd streetviewdownloader
pip install .
```

## Usage

### Command line tool

```
streetviewdownloader --api-key YOUR_API_KEY --url-signing-key YOUR_URL_SIGNING_KEY --extent "POLYGON((24.9791 60.2021, 24.9609 60.2002, 24.9642 60.1894, 24.9826 60.1867, 24.9879 60.1950, 24.9791 60.2021))" --output-directory "Hermanni"
```

All command line options can alternatively be specified in a configuration file saved to `${XDG_CONFIG_HOME}/streetviewdownloader.yaml` or `%APPDATA%\streetviewdownloader.yaml`, depending on your operating system.

### Library

Streetviewdownloader can also be used via its Python API. Find examples and API reference at https://streetviewdownloader.readthedocs.io
