Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rrwen/google_streetview
A command line tool and module for Google Street View Image API
https://github.com/rrwen/google_streetview
address api city cli command google image interface line location map module panorama photo road route street streetview tool view
Last synced: 3 months ago
JSON representation
A command line tool and module for Google Street View Image API
- Host: GitHub
- URL: https://github.com/rrwen/google_streetview
- Owner: rrwen
- License: mit
- Created: 2017-06-06T04:31:06.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2019-03-06T00:01:47.000Z (over 5 years ago)
- Last Synced: 2024-07-20T20:03:48.669Z (4 months ago)
- Topics: address, api, city, cli, command, google, image, interface, line, location, map, module, panorama, photo, road, route, street, streetview, tool, view
- Language: Python
- Homepage: https://rrwen.github.io/google_streetview
- Size: 1.9 MB
- Stars: 97
- Watchers: 7
- Forks: 25
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.rst
- License: LICENSE
Awesome Lists containing this project
README
# google_streetview
Richard Wen
[email protected]
* [Documentation](https://rrwen.github.io/google_streetview)
A command line tool and module for Google Street View Image API.
[](https://badge.fury.io/py/google-streetview)
[](https://travis-ci.org/rrwen/google_streetview)
[](https://coveralls.io/github/rrwen/google_streetview?branch=master)
[](https://github.com/google_streetview/stargazers)
[](https://github.com/rrwen/google_streetview/blob/master/LICENSE)
[](https://donorbox.org/rrwen)
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=NQNSAHK5X46D2)
[](https://twitter.com/intent/tweet?text=A%20command%20line%20tool%20and%20module%20for%20Google%20Street%20View%20Image%20API:%20https://github.com/rrwen/google_streetview%20%23python%20%23pip)
**Note**: Google changed [StreetView API pricing](https://developers.google.com/maps/documentation/streetview/usage-and-billing) and a billing plan may be required (checked March 5, 2019).
## Install
1. Install [Python](https://www.python.org/downloads/)
2. Install [google_streetview](https://pypi.python.org/pypi/google-streetview) via `pip`
```
pip install google_streetview
```
For the latest developer version, see [Developer Install](https://github.com/rrwen/google_streetview/blob/master/NOTES.rst#developer-install).
## Usage
For help in the console:
```
google_streetview -h
```
Ensure that a [Google API developer key](https://developers.google.com/api-client-library/python/auth/api-keys) 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:
```python
# 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](https://rrwen.github.io/google_streetview).
## Contributions
1. Reports for issues and suggestions can be made using the [issue submission](https://github.com/rrwen/google_streetview/issues)
2. Code contributions are submitted via [pull requests](https://github.com/rrwen/google_streetview/pulls)
See [CONTRIBUTING.rst](https://github.com/rrwen/google_streetview/blob/master/CONTRIBUTING.rst) for more details.
## Implementation
The package [google_streetview](https://pypi.python.org/pypi/google-streetview) uses the following components:
| Component | Purpose |
|----------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------|
| [Google Street View Image API](https://developers.google.com/maps/documentation/streetview) | API for Google Street View images |
| [google_streetview.api](https://github.com/rrwen/google_streetview/blob/master/google_streetview/api.py) | Module for interfacing with Google Street View Image API using requests |
| [requests](https://pypi.python.org/pypi/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](https://github.com/rrwen/google_streetview/blob/master/NOTES.rst).