gmaps-cli

Lightweight CLI for Google Maps via Grounding Lite. Runs on Bun.

Install

bun install -g gmaps-cli

Setup

1. Enable Maps Grounding Lite in your Google Cloud Console
2. Create an API key
3. Set the environment variable:

export GOOGLE_MAPS_API_KEY=your-api-key

Usage

Search for places

gmaps places "coffee shops in Sydney"
gmaps places "petrol stations" --near "-33.8688,151.2093" --radius 2000
gmaps places "restaurants" --limit 5 --language en --region AU

Flag	Description	Default
--near <lat,lng>	Bias results to location	—
--radius <meters>	Search radius (requires --near)	5000
--limit <n>	Max results	10
--language <code>	Language (ISO 639-1)	en
--region <code>	Region bias (ISO 3166-1)	—

Compute a route

gmaps route "JFK Airport" "Manhattan"
gmaps route "Sydney" "Melbourne" --mode drive
gmaps route "Central Park" "Brooklyn Bridge" --mode walk

Flag	Description	Default
--mode <mode>	drive or walk	drive

Output

Both commands output JSON to stdout:

gmaps places "coffee" | jq '.summary'
gmaps route "A" "B" | jq '.route.duration'

License

MIT