goplaces

goplaces wraps the Google Places API (New) in a streamlined CLI experience:Set your GOOGLE_PLACES_API_KEY environment variable.Run a command — search, resolve, or details — with your query and any filters.Results are printed in a human-friendly format with ANSI color, or in raw JSON when --json is passed.Use pagination tokens to page through large result sets, or pipe JSON output directly into other tools.

Text Search — Find places by keyword with filters for open status, minimum rating, price level, type, and result limit.Location Bias — Constrain or bias searches by latitude, longitude, and radius for geographically relevant results.Place Resolution — Resolve ambiguous location names (e.g. "Soho, London") to canonical Place IDs with ranked candidates.Place Details & Reviews — Fetch rich place details and user reviews for any Place ID using goplaces details <place_id> --reviews.Pagination Support — Page through results seamlessly using --page-token for large search queries.Script-Friendly JSON Output — Toggle --json for clean, structured JSON suitable for downstream scripting and automation.Color Control — Disable ANSI color via --no-color flag or the standard NO_COLOR environment variable.

Google Places API Key — Required. Authenticates all requests to the Google Places API (New). Set as the GOOGLE_PLACES_API_KEY environment variable. Obtain a key from the Google Cloud Console with the Places API (New) enabled.Base URL Override — (optional) Set GOOGLE_PLACES_BASE_URL to point requests at a proxy or test endpoint instead of the live Google Places API.

Local Business Discovery — Quickly find highly-rated, open coffee shops, restaurants, or services near a specific coordinate without opening a browser.Data Enrichment Scripts — Feed a list of place names through goplaces resolve and details to enrich datasets with structured Google Places data via JSON output.Review Monitoring — Pull the latest reviews for a venue directly from the terminal for sentiment analysis or reporting pipelines.Geocoding & ID Resolution — Resolve human-readable location names to canonical Place IDs for use in mapping or other API integrations.