# Google Maps Query

> Query current Google Maps Platform geocoding, Places, and Routes APIs from a thin JSON CLI using an environment-supplied API key and explicit billable-call execution. Use when a user needs place IDs, coordinates, place details, text search, or route distance and duration from Google Maps data.

- Skill: `batteryshark/google-maps-query` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds@latest add batteryshark/google-maps-query`
- Raw SKILL.md: https://api.skillmd.com/api/skills/batteryshark/google-maps-query/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: batteryshark (https://skillmd.com/u/batteryshark)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/batteryshark/google-maps-query

---


# Google Maps Query

Use `bin/google-maps-query`. Calls may incur Google Cloud charges and transmit the supplied locations to Google.

## Workflow

1. Read [references/setup-and-privacy.md](references/setup-and-privacy.md).
2. Select the narrowest command.
3. Show the user the query and confirm that a billable external call is intended unless their request already explicitly authorizes it.
4. Run with `--execute`.
5. Treat returned data as time-sensitive and retain place IDs for unambiguous follow-up calls.

Never print or persist `GOOGLE_MAPS_API_KEY`.