google-streetview

google_streetview

Richard Wen
[e-mail]

• Documentation

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

Note: Google changed StreetView API pricing and a billing plan may be required (checked March 5, 2019).

Install

• Install Python
• Install google_streetview via pip

pip install google_streetview

For the latest developer version, see Developer Install.

Usage

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'
results.download_links('downloads')

For more usage details, see the Documentation.

Contributions

• Reports for issues and suggestions can be made using the issue submission
• Code contributions are submitted via pull requests

See CONTRIBUTING.rst for more details.

Implementation

The package google_streetview uses the following components:

Component	Purpose
Google Street View Image API	API for Google Street View images
google_streetview.api	Module for interfacing with Google Street View Image API using requests
requests	Download and get URLs from Google Street View Image API

  
  Google Street View Image API     <-- API for Street View Images
               |
      google_streetview.api        <-- URL Request with query string
               |
            request                <-- Download URLs and images

For more information, see NOTES.rst.