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

1. Install Python
2. 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

1. Reports for issues and suggestions can be made using the issue submission
2. 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.