googlemaps

Python client library for Google Maps API Web Services

https://github.com/googlemaps/google-maps-services-python

Science Score: 26.0%

This score indicates how likely this project is to be science-related based on various indicators:

○
CITATION.cff file
✓
codemeta.json file
Found codemeta.json file
✓
.zenodo.json file
Found .zenodo.json file
○
DOI references
○
Academic publication links
○
Committers with academic emails
○
Institutional organization owner
○
JOSS paper metadata
○
Scientific vocabulary similarity
Low similarity (15.2%) to scientific vocabulary

Keywords

client-library python

Keywords from Contributors

templates asyncio deep-neural-networks distributed apps tensors views closember nltk http-server

Last synced: 6 months ago · JSON representation

Repository

Python client library for Google Maps API Web Services

Basic Info

Host: GitHub
Owner: googlemaps
License: apache-2.0
Language: Python
Default Branch: master
Homepage:
Size: 1010 KB

Statistics

Stars: 4,804
Watchers: 187
Forks: 1,334
Open Issues: 69
Releases: 29

Topics

client-library python

Created over 11 years ago · Last pushed 12 months ago

Metadata Files

Readme Changelog License Code of conduct Codeowners Security Authors

Python Client for Google Maps Services

PyPI - Downloads GitHub contributors

Description

Use Python? Want to geocode something? Looking for directions? Maybe matrices of directions? This library brings the Google Maps Platform Web Services to your Python application.

The Python Client for Google Maps Services is a Python Client library for the following Google Maps APIs:

Directions API
Distance Matrix API
Elevation API
Geocoding API
Geolocation API
Time Zone API
Roads API
Places API
Maps Static API
Address Validation API

Keep in mind that the same terms and conditions apply to usage of the APIs when they're accessed through this library.

Support

This library is community supported. We're comfortable enough with the stability and features of the library that we want you to build real production applications on it. We will try to support, through Stack Overflow, the public and protected surface of the library and maintain backwards compatibility in the future; however, while the library is in version 0.x, we reserve the right to make backwards-incompatible changes. If we do remove some functionality (typically because better functionality exists or if the feature proved infeasible), our intention is to deprecate and give developers a year to update their code.

If you find a bug, or have a feature suggestion, please log an issue. If you'd like to contribute, please read contribute.

Requirements

Python 3.5 or later.
A Google Maps API key.

API Keys

Each Google Maps Web Service request requires an API key or client ID. API keys are generated in the 'Credentials' page of the 'APIs & Services' tab of Google Cloud console.

For even more information on getting started with Google Maps Platform and generating/restricting an API key, see Get Started with Google Maps Platform in our docs.

Important: This key should be kept secret on your server.

Installation

$ pip install -U googlemaps

Note that you will need requests 2.4.0 or higher if you want to specify connect/read timeouts.

Usage

This example uses the Geocoding API and the Directions API with an API key:

```python import googlemaps from datetime import datetime

gmaps = googlemaps.Client(key='Add Your Key here')

Geocoding an address

geocode_result = gmaps.geocode('1600 Amphitheatre Parkway, Mountain View, CA')

Look up an address with reverse geocoding

reversegeocoderesult = gmaps.reverse_geocode((40.714224, -73.961452))

Request directions via public transit

now = datetime.now() directionsresult = gmaps.directions("Sydney Town Hall", "Parramatta, NSW", mode="transit", departuretime=now)

Validate an address with address validation

addressvalidation_result = gmaps.addressvalidation(['1600 Amphitheatre Pk'], regionCode='US', locality='Mountain View', enableUspsCass=True)

Get an Address Descriptor of a location in the reverse geocoding response

addressdescriptorresult = gmaps.reversegeocode((40.714224, -73.961452), enableaddress_descriptor=True)

```

For more usage examples, check out the tests.

Features

Retry on Failure

Automatically retry when intermittent failures occur. That is, when any of the retriable 5xx errors are returned from the API.

Building the Project

# Installing nox
$ pip install nox

# Running tests
$ nox

# Generating documentation
$ nox -e docs

# Copy docs to gh-pages
$ nox -e docs && mv docs/_build/html generated_docs && git clean -Xdi && git checkout gh-pages

Documentation & resources

Documentation for the google-maps-services-python library

Getting started

API docs

Support

Owner

Name: Google Maps Platform
Login: googlemaps
Kind: organization

Website: https://developers.google.com/maps
Twitter: GMapsPlatform
Repositories: 73
Profile: https://github.com/googlemaps

Google Maps Platform is a set of APIs and SDKs for retrieving location-based data from Google and embedding Google Maps imagery into mobile apps and web pages.

GitHub Events

Total

Issues event: 5
Watch event: 276
Issue comment event: 14
Push event: 3
Pull request review event: 6
Pull request review comment event: 7
Pull request event: 4
Fork event: 56
Create event: 1

Last Year

Issues event: 5
Watch event: 276
Issue comment event: 14
Push event: 3
Pull request review event: 6
Pull request review comment event: 7
Pull request event: 4
Fork event: 56
Create event: 1

Committers

Last synced: 9 months ago

All Time

Total Commits: 408
Total Committers: 63
Avg Commits per committer: 6.476
Development Distribution Score (DDS): 0.777

Past Year

Commits: 1
Committers: 1
Avg Commits per committer: 1.0
Development Distribution Score (DDS): 0.0

Top Committers

Name	Email	Commits
Stephen McDonald	s**e@j**g	91
Justin Poehnelt	j**t@g**m	67
Chris Broadfoot	c**o@g**m	66
Brett Morgan	b**n@g**m	34
semantic-release-bot	s**t@m**t	24
Mark McDonald	m**d@g**m	13
Chris Arriola	c**a@g**m	12
Sam Thorogood	s**d@g**m	10
Dave Holmes	d**s@g**m	7
Matthew Wilkens	m**s@g**m	5
googlemaps-bot	g**t@g**m	4
Angela Yu	5****a	4
rbouchez	r**z@n**m	4
Cris Bettis	c**s@r**m	4
Ali	a**r@g**m	3
Chinmay Pai	c**i@g**m	3
Kerrick Staley	k**y@l**m	3
Luke Mahe	l**m@g**m	3
David Robles	d**s@h**m	2
anglarett	a**t@g**m	2
Pi Delport	p**t@g**m	2
Florian Demmer	f**r@g**m	2
Craig	T****n	2
Apostolos Spanos	a**n@g**m	2
Andreas Backx	a**s@b**g	1
Andrew Gomez	a**9@g**m	1
Andrew Naoum	a**w@n**m	1
Andy Klimczak	a**k@f**m	1
Sean Wohltman	s**n@g**m	1
Sondre Lillebø Gundersen	s**g@l**o	1
and 33 more...

Committer Domains (Top 20 + Academic)

google.com: 12 jupo.org: 1 martynus.net: 1 navagis.com: 1 ridecell.com: 1 lyft.com: 1 hearsaycorp.com: 1 backx.org: 1 naoum.com: 1 fastmail.com: 1 live.no: 1 jodal.no: 1 nycda.com: 1 iress.com: 1 twistbioscience.com: 1 pst.org: 1 vacasa.com: 1

Issues and Pull Requests

Last synced: 6 months ago

All Time

Total issues: 97
Total pull requests: 57
Average time to close issues: 5 months
Average time to close pull requests: about 2 months
Total issue authors: 86
Total pull request authors: 37
Average comments per issue: 1.97
Average comments per pull request: 1.77
Merged pull requests: 28
Bot issues: 0
Bot pull requests: 1

Past Year

Issues: 6
Pull requests: 3
Average time to close issues: N/A
Average time to close pull requests: 4 minutes
Issue authors: 6
Pull request authors: 2
Average comments per issue: 0.67
Average comments per pull request: 0.33
Merged pull requests: 0
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

R4113R (6)
jpoehnelt (3)
nnolan (2)
vijaygrg27 (2)
BugStopsHere (2)
FinnWoelm (2)
ChicagoDev (1)
wuhueicheng8699 (1)
wdhorton (1)
lujoselu98 (1)
tpchris1 (1)
ZenithX9271 (1)
t4chyon (1)
davidbeers (1)
BrunoCaimar (1)

Pull Request Authors

jpoehnelt (7)
googlemaps-bot (5)
anglarett (5)
anishcherukuthota (4)
wangela (3)
ThugPigeon653 (3)
wescpy (2)
morgandenning (2)
vsemionov (2)
il-santo (2)
AshishAshishA (2)
tcliff111 (2)
Xpshnik (2)
northtree (1)
jloffredo2 (1)

Top Labels

Issue Labels

triage me (58) type: feature request (38) type: bug (26) stale (9) priority: p3 (8) type: question (7) priority: p2 (6) type: docs (5) released (4) help wanted (3) priority: p4 (2) type: process (1) status: blocked (1)

Pull Request Labels

released (23) cla: yes (10) file-sync (6) automerge (3) cla: no (3) merge (2) dependencies (1)

Packages

Total packages: 5
Total downloads:
- pypi 2,065,831 last-month
Total docker downloads: 757,219,857

Total dependent packages: 26
(may contain duplicates)
Total dependent repositories: 3,487
(may contain duplicates)
Total versions: 79
Total maintainers: 4

pypi.org: googlemaps

Python client library for Google Maps Platform

Homepage: https://github.com/googlemaps/google-maps-services-python
Documentation: https://googlemaps.readthedocs.io/
License: Apache 2.0
Latest release: 4.10.0
published about 3 years ago

Versions: 50
Dependent Packages: 26
Dependent Repositories: 3,482
Downloads: 2,065,794 Last month
Docker Downloads: 757,219,857

Rankings

Docker downloads count: 0.1%

Dependent repos count: 0.2%

Downloads: 0.2%

Dependent packages count: 0.6%

Average: 0.6%

Stargazers count: 1.1%

Forks count: 1.2%

Maintainers (2)

googlemaps-bot devangela

Last synced: 6 months ago

proxy.golang.org: github.com/googlemaps/google-maps-services-python

Documentation: https://pkg.go.dev/github.com/googlemaps/google-maps-services-python#section-documentation
License: apache-2.0
Latest release: v4.10.0+incompatible
published about 3 years ago

Versions: 26
Dependent Packages: 0
Dependent Repositories: 0

Rankings

Dependent packages count: 7.0%

Average: 8.2%

Dependent repos count: 9.3%

Last synced: 6 months ago

pypi.org: googlemaps-nb

Python client library for Google Maps API Web Services

Homepage: https://github.com/googlemaps/google-maps-services-python
Documentation: https://googlemaps-nb.readthedocs.io/
License: Apache 2.0
Latest release: 2.5.1.dev0
published almost 8 years ago

Versions: 1
Dependent Packages: 0
Dependent Repositories: 1
Downloads: 20 Last month

Rankings

Stargazers count: 1.1%

Forks count: 1.2%

Dependent packages count: 7.4%

Average: 18.8%

Dependent repos count: 22.2%

Downloads: 62.0%

Maintainers (1)

nbrickell

Last synced: 6 months ago

conda-forge.org: googlemaps

Use Python? Want to geocode something? Looking for directions? Maybe matrices of directions? This library brings the Google Maps API Web Services to your Python application. Analytics

Homepage: https://github.com/googlemaps/google-maps-services-python
License: Apache-2.0
Latest release: 2.5.1
published over 3 years ago

Versions: 1
Dependent Packages: 0
Dependent Repositories: 3

Rankings

Forks count: 4.3%

Stargazers count: 5.9%

Dependent repos count: 18.1%

Average: 19.9%

Dependent packages count: 51.6%

Last synced: 6 months ago

pypi.org: googlemapsaleks57

Python client library for Google Maps API Web Services

Homepage: https://github.com/googlemaps/google-maps-services-python
Documentation: https://googlemapsaleks57.readthedocs.io/
License: Apache 2.0
Latest release: 3.0.2
published over 6 years ago

Versions: 1
Dependent Packages: 0
Dependent Repositories: 1
Downloads: 17 Last month

Rankings

Stargazers count: 1.1%

Forks count: 1.2%

Dependent packages count: 7.4%

Average: 21.2%

Dependent repos count: 22.2%

Downloads: 74.2%

Maintainers (1)

aleko279

Last synced: 6 months ago

Dependencies

.github/workflows/release.yml actions

actions/checkout v2 composite
actions/setup-python v1 composite
cycjimmy/semantic-release-action v2 composite

.github/workflows/test.yml actions

actions/checkout v3 composite
actions/setup-python v3 composite

.github/workflows/docs.yml actions

actions/checkout v3 composite
actions/setup-python v3 composite
peter-evans/create-pull-request v4 composite

googlemaps

Science Score: 26.0%

Keywords

Keywords from Contributors

Repository

Basic Info

Statistics

Topics

Metadata Files

README.md

Python Client for Google Maps Services

Description

Support

Requirements

API Keys

Installation

Usage

Geocoding an address

Look up an address with reverse geocoding

Request directions via public transit

Validate an address with address validation

Get an Address Descriptor of a location in the reverse geocoding response

Features

Retry on Failure

Building the Project

Documentation & resources

Getting started

API docs

Support

Owner

GitHub Events

Total

Last Year

Committers

All Time

Past Year

Top Committers

Committer Domains (Top 20 + Academic)

Issues and Pull Requests

All Time

Past Year

Top Authors

Issue Authors

Pull Request Authors

Top Labels

Issue Labels

Pull Request Labels

Packages

pypi.org: googlemaps

Rankings

Maintainers (2)

proxy.golang.org: github.com/googlemaps/google-maps-services-python

Rankings

pypi.org: googlemaps-nb

Rankings

Maintainers (1)

conda-forge.org: googlemaps

Rankings

pypi.org: googlemapsaleks57

Rankings

Maintainers (1)

Dependencies