Skip to content

rrwen/google_streetview

Repository files navigation

google_streetview

Richard Wen
rrwen.dev@gmail.com

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

pypi version Build Status Coverage Status Stars GitHub license Donarbox Donate PayPal Donate Twitter

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.