google-places-api

Use when working with Google Places API - place search, place details, autocomplete, place photos, or location-based queries. Also use when integrating Google Maps place data, nearby search, or address validation.

Model	Source
sonnet	pack: google-apis

Full Reference

┏━ 🔧 google-places-api ━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Use when working with Google Places API - plac… ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Google Places API (New)

Places API (New) v1 — the current actively-developed version. Legacy Places API is deprecated (no new project enrollment since March 2025). Field masks are mandatory on all requests.

Quick Reference

Item	Value
Base URL	https://places.googleapis.com
Auth	X-Goog-Api-Key: YOUR_KEY header
Field mask	X-Goog-FieldMask: field1,field2 — required
Python	pip install google-maps-places
Node.js	npm install @googlemaps/places

Endpoints

Operation	Method	Endpoint
Text Search	POST	/v1/places:searchText
Nearby Search	POST	/v1/places:searchNearby
Place Details	GET	/v1/places/{placeId}
Autocomplete	POST	/v1/places:autocomplete
Place Photos	GET	/v1/{photoName}/media

Reference Index

I want to…	File
Authentication, API key setup, client libraries, legacy migration	reference/auth-setup.md
Field masks, billing tiers, prefix rules	reference/field-masks.md
Text Search, Nearby Search, place types	reference/search.md
Place Details, fetching by Place ID	reference/details.md
Autocomplete, session tokens, billing optimization	reference/autocomplete.md
Place Photos, two-step photo fetch	reference/photos.md
Reviews, AI generative summaries, atmosphere fields	reference/reviews.md
Pricing tables, rate limits, error codes, retry logic, Maps JS API	reference/pricing-errors.md

Usage: Read the reference file matching your current task from the index above. Each file is self-contained with code examples and inline gotchas.