---
id: google-maps-places
version: "0.9.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# google-maps-places — Google Maps Places API client library

License: permissive · Maintenance: active · Downloads: 322.0K/mo

## What it is and what it does

This is Google's official Python client for the Places API (New), a managed service that provides programmatic access to place information, search results, and location data. It wraps the underlying gRPC and REST endpoints with a Pythonic interface, handling authentication, serialization, and error handling automatically through dependencies on google-api-core, google-auth, and protobuf.

The library is designed for applications that need to query places by name, location, type, or other criteria—such as finding nearby restaurants, verifying business details, or enriching location datasets. It requires a Google Cloud project with billing enabled and the Places API activated. The package is actively maintained, supports modern Python versions (3.10 and later), and carries no known security vulnerabilities.

Use it for:

- Search for places near a given coordinate or address and retrieve detailed information like opening hours, ratings, and contact details.
- Build a location-based discovery feature in a mobile or web app that queries nearby businesses, attractions, or services.
- Enrich user-submitted addresses or business data by looking up canonical place records and verifying existence.
- Integrate place autocomplete or place-details lookups into a form or search interface.
- Aggregate place metadata (photos, reviews, types) for analytics or reporting on a set of locations.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python client library for Google Maps Places API, providing access to place search, retrieval, and information endpoints through a managed Google Cloud service.

Yes, if you need programmatic access to Google Maps place data and are willing to set up a Google Cloud project with billing. The library is actively maintained, has low install friction, carries no known vulnerabilities, and is the official client for this API. The main cost is operational—API calls incur charges—not technical adoption.

## Install

pip install google-maps-places
uv add google-maps-places
poetry add google-maps-places

## Installing google-maps-places

Before you install: Low install friction with a pure-Python wheel distribution. Maintained actively with recent releases; last commit 2026-08-14. Requires Python 3.10 or later, which excludes older environments but aligns with current language support.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions, making it suitable for most projects that can comply with attribution and derivative-work disclosure requirements.

Quickstart:

pip install google-maps-places

from google.maps import places_v1

client = places_v1.PlacesClient()
# Use client to call Places API endpoints

Requires Google Cloud project with Places API enabled, valid authentication credentials, and billing configured.

Verify before relying:

- Specific API endpoints and methods available in version 0.9.0 beyond generic place search and retrieval.
- Rate limiting, quota, or per-request cost implications when calling the Places API through this client.
- Whether offline or cached place data is supported, or if all queries require live API calls.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 322.0K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

google maps places api client, place search and retrieval python, google places api integration, location data lookup library, places nearby search python, google cloud places client, google-cloud, geolocation, api-client

[View on SkillFed](https://skillfed.io/packages/google-maps-places) · [View on PyPI](https://pypi.org/project/google-maps-places/)