Snapshot of googlemaps/google-maps-services-python: 5.0k★, Python, Backend. Python client library for Google Maps API Web Services
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
[!IMPORTANT]
Legacy APIs End of Sale & Newer Client Libraries
Several APIs supported by this library are in Legacy status:
Places API (Legacy): This product is in Legacy status. As of October 2026, Places API (Legacy) can no longer be enabled for new Google Cloud projects. Existing projects remain fully supported. For new features and improved performance, migrate to Places API (New).
Directions API (Legacy): This product is in Legacy status. As of October 2026, Directions API (Legacy) can no longer be enabled for new Google Cloud projects. Existing projects remain fully supported. For new features and improved performance, migrate to the Routes API.
Distance Matrix API (Legacy): This product is in Legacy status. As of October 2026, Distance Matrix API (Legacy) can no longer be enabled for new Google Cloud projects. Existing projects remain fully supported. For new features and improved performance, migrate to the Routes API.
For our newer APIs, see the Google Maps Platform APIs in the Cloud Client Libraries for Python (overview):
Places API (New)
Routes API
Address Validation API
Datasets API
The new APIs will not be added to this client library.
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:
Elevation API
Geocoding API
Geolocation API
Time Zone API
Roads API
Maps Static API
Address Validation API
As well as the following legacy APIs:
Directions API (Legacy)
Distance Matrix API (Legacy)
Places API (Legacy)
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:
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
reverse_geocode_result = gmaps.reverse_geocode((40.714224, -73.961452))
# Request directions via public transit
now = datetime.now()
directions_result = gmaps.directions("Sydney Town Hall",
"Parramatta, NSW",
mode="transit",
departure_time=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
address_descriptor_result = gmaps.reverse_geocode((40.714224, -73.961452), enable_address_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.
Documentation for the google-maps-services-python library
Getting started
Get Started with Google Maps Platform
Generating/restricting an API key
Authenticating with a client ID
API docs
Google Maps Platform web services
Directions API
Distance Matrix API
Elevation API
Geocoding API
Geolocation API
Time Zone API
Roads API
Places API
Maps Static API
Terms of Service
This library uses Google Maps Platform services. Use of Google Maps Platform services through this library is subject to the Google Maps Platform Terms of Service.
This library is not a Google Maps Platform Core Service. Therefore, the Google Maps Platform Terms of Service (e.g. Technical Support Services, Service Level Agreements, and Deprecation Policy) do not apply to the code in this library.
European Economic Area (EEA) developers
If your billing address is in the European Economic Area, effective on 8 July 2025, the Google Maps Platform EEA Terms of Service will apply to your use of the Services. Functionality varies by region. Learn more.
Support
This library is offered via an open source license. It is not governed by the Google Maps Platform Support Technical Support Services Guidelines, the SLA, or the Deprecation Policy (however, any Google Maps Platform services used by the library remain subject to the Google Maps Platform Terms of Service).
This library adheres to semantic versioning to indicate when backwards-incompatible changes are introduced. Accordingly, while the library is in version 0.x, backwards-incompatible changes may be introduced at any time.
If you find a bug, or have a feature request, please file an issue on GitHub. If you would like to get answers to technical questions from other Google Maps Platform developers, ask through one of our developer community channels. If you'd like to contribute, please check the Contributing guide.
You can also discuss this library on our Discord server.
How active is development on googlemaps/google-maps-services-python?
The most recent commit recorded on googlemaps/google-maps-services-python was 1 month ago, based on the GitHub push timestamp. The repository has 1.4k forks — one of the better signals of community interest.
How does googlemaps/google-maps-services-python compare to other Backend projects?
googlemaps/google-maps-services-python is tracked by TopGit in the Backend category, with 5.0k GitHub stars and written in Python. Browse the Backend topic page on TopGit to compare it against similar projects by stars and activity.
How many stars does googlemaps/google-maps-services-python have?
googlemaps/google-maps-services-python has 5.0k GitHub stars — refresh the page for the live number, or check github.com/googlemaps/google-maps-services-python. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is googlemaps/google-maps-services-python open source?
Yes — googlemaps/google-maps-services-python ships under the Apache-2.0 license, which makes its source code freely readable (and, depending on license terms, forkable and reusable). Source: github.com/googlemaps/google-maps-services-python.
What is googlemaps/google-maps-services-python?
googlemaps/google-maps-services-python (googlemaps/google-maps-services-python) is a Python project on GitHub. From the project's own README: Python client library for Google Maps API Web Services
Where do I read more about googlemaps/google-maps-services-python?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/googlemaps/google-maps-services-python is the definitive source.
Read full README in the tab above.
Is google-maps-services-python worth your time?
ChatGPT, Claude and Perplexity can all read this page. Ask one of them what it makes of google-maps-services-python.