Skip to main content

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

Project description


  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:

# 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.

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.3.tar.gz (7.6 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