goplaces

goplaces is a specialized CLI utility designed to bridge the gap between complex Google Places API (New) endpoints and terminal-based workflows. It is engineered for developers and power users who need to perform geospatial queries, verify location data, or automate place discovery without building a full-stack application. Whether you are conducting local market research, gathering venue information for an application, or building automated scouting scripts, goplaces provides a robust and streamlined interface to Google’s extensive location database.

• Perform text-based location searches with precise filters for availability (open-now), ratings, and result limits.

• Resolve unstructured addresses or location names into concrete Place IDs and geographic coordinates.

• Retrieve comprehensive place details, including business hours, address components, and optional customer review content.

• Bias search results based on specific latitude and longitude coordinates with custom radius parameters.

• Output data in either a clean, human-readable terminal format or raw JSON, facilitating integration with automation tools, data pipelines, and shell scripts.

• Support for pagination via page tokens to handle large result sets efficiently.

• Requires a valid GOOGLE_PLACES_API_KEY environment variable to operate.

• Supports optional proxy or testing via the GOOGLE_PLACES_BASE_URL configuration setting.

• Disables ANSI colors automatically with the --no-color flag or NO_COLOR environment variable, ensuring compatibility with CI/CD logs and non-interactive environments.

• Handles standard API price-level mapping (0-4) and strictly enforces type filtering as specified by the Google Places API documentation.

• Users can install the tool easily via Homebrew on macOS and Linux systems, making it a portable addition to any command-line toolkit.