Metadata-Version: 2.1
Name: streetviewdownloader
Version: 0.2.6.dev0
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://gitlab.com/christophfink/streetviewdownloader/
Project-URL: Change log, https://gitlab.com/christophfink/streetviewdownloader/-/blob/main/CHANGELOG.md
Project-URL: Bug tracker, https://gitlab.com/christophfink/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

# 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://gitlab.com/christoph.fink/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
