Skip to main content

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

Project description

# google_streetview

Richard Wen

* [Documentation](

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

[![pypi version](](
[![Build Status](](
[![Coverage Status](](
[![GitHub license](](
[![Donarbox Donate](](
[![PayPal Donate](](

**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'

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](

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