Research
goplaces avatar

goplaces

Query Google Places for location data, reviews, and details via a powerful CLI tool.

Introduction

goplaces is a modern, high-performance command-line interface designed for seamless interaction with the Google Places API (New). It serves as a vital utility for users who need to perform rapid geospatial lookups, gather business intelligence, or retrieve structured location data directly from their terminal. Whether you are an automation engineer scripting data collection workflows or a power user managing location-based tasks, this tool provides a robust bridge to Google's extensive map infrastructure. By supporting both human-readable terminal output and machine-friendly JSON, it adapts effortlessly to various technical environments, from interactive personal assistance to headless data pipelines.

  • Perform sophisticated text searches for businesses, landmarks, and points of interest with filtering support for rating, opening status, and geographic biasing.

  • Retrieve comprehensive place details including contact information, reviews, price levels, and address resolution.

  • Export output in scriptable JSON format, enabling direct integration with other software agents, data processing scripts, or OpenClaw skill workflows.

  • Support for pagination tokens, allowing for deep exploration of search results across multiple API pages.

  • Customizable configuration via environment variables, including support for custom base URLs, facilitating local testing and proxying during development.

  • Requires a valid GOOGLE_PLACES_API_KEY to authenticate with the Google Cloud platform.

  • Respects common CLI conventions such as NO_COLOR for suppressing ANSI color output in CI/CD or logging environments.

  • Type filtering is limited to single parameters per request as defined by the underlying API constraints.

  • Price level indicators range from 0 (free) to 4 (very expensive), providing structured economic context for business search results.

  • Integration is highly recommended via the OpenClaw onboard flow to ensure proper credential management and skill path configuration.

Repository Stats

Stars
365,614
Forks
74,930
Open Issues
6,989
Language
TypeScript
Default Branch
main
Sync Status
Idle
Last Synced
Apr 28, 2026, 11:02 AM
View on GitHub