Skip to main content

A command line tool and module for Google Street View Image API.

Project description

.. image::
.. image::
.. image::
.. image::
.. image::
.. image::
.. image::


1. Install `Python <>`_
2. Install `google_streetview <>`_ via ``pip``


pip install google_streetview

For the latest developer version, see `Developer Install`_.


For help in the console::

google_streetview -h

Ensure that a `Google API developer key <>`_ is set::

google_streetview -s key="your_dev_key"

Search street view for latitude and longitude ``46.414382,10.013988``::

google_streetview "46.414382,10.013988"

Save images to a directory::

google_streetview --location="46.414382,10.013988" --save_downloads=downloads

Obtain a 360 panorama by rotating the camera ``heading`` given a 90 degree field of vision ``fov``::

google_streetview --location="46.414382,10.013988" --fov=90 --heading=0;90;180;270

Use as a Python module:

.. code-block:: python

# Import google_streetview for the api module
import google_streetview.api

# Define parameters for street view api
params = [{
'size': '600x300', # max 640x640 pixels
'location': '46.414382,10.013988',
'heading': '151.78',
'pitch': '-0.76',
'key': 'your_dev_key'

# Create a results object
results = google_streetview.api.results(params)

# Download images to directory 'downloads'

For more usage details, see the `Documentation <>`_.


Report Contributions

Reports for issues and suggestions can be made using the `issue submission <>`_ interface.

When possible, ensure that your submission is:

* **Descriptive**: has informative title, explanations, and screenshots
* **Specific**: has details of environment (such as operating system and hardware) and software used
* **Reproducible**: has steps, code, and examples to reproduce the issue

Code Contributions

Code contributions are submitted via `pull requests <>`_:

1. Ensure that you pass the `Tests`_
2. Create a new `pull request <>`_
3. Provide an explanation of the changes

A template of the code contribution explanation is provided below:


## Purpose

The purpose can mention goals that include fixes to bugs, addition of features, and other improvements, etc.

## Description

The description is a short summary of the changes made such as improved speeds, implementation

## Changes

The changes are a list of general edits made to the files and their respective components.
* `file_path1`:
* `function_module_etc`: changed loop to map
* `function_module_etc`: changed variable value
* `file_path2`:
* `function_module_etc`: changed loop to map
* `function_module_etc`: changed variable value

## Notes

The notes provide any additional text that do not fit into the above sections.

For more information, see `Developer Install`_ and `Implementation`_.

Developer Notes

Developer Install

Install the latest developer version with ``pip`` from github::

pip install git+

Install from ``git`` cloned source:

1. Ensure `git <>`_ is installed
2. Clone into current path
3. Install via ``pip``


git clone
cd google_streetview
pip install . -I


1. Clone into current path ``git clone``
2. Enter into folder ``cd google_streetview``
3. Ensure `unittest <>`_ is available
4. Set your `Google API developer key <>`_
5. Run tests
6. Reset config file to defaults
7. Please note that this will use up 16 requests from your quota


pip install . -I
python -m google_streetview -s key=your_dev_key
python -m unittest
python -m google_streetview -d

Documentation Maintenance

1. Ensure `sphinx <>`_ is installed ``pip install -U sphinx``
2. Update the documentation in ``docs/``


pip install . -I
sphinx-build -b html docs/source docs

Upload to github

1. Ensure `git <>`_ is installed
2. Add all files and commit changes
3. Push to github


git add .
git commit -a -m "Generic update"
git push

Upload to PyPi

1. Ensure `twine <>`_ is installed ``pip install twine``
2. Ensure `sphinx <>`_ is installed ``pip install -U sphinx``
3. Run tests and check for OK status
4. Delete ``dist`` directory
5. Update the version ``google_streetview/``
6. Update the documentation in ``docs/``
7. Create source distribution
8. Upload to `PyPi <>`_


pip install . -I
python -m google_streetview -s key=your_dev_key
python -m unittest
python -m google_streetview -d
sphinx-build -b html docs/source docs
python sdist
twine upload dist/*

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

google_streetview-1.1.6.tar.gz (8.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page