goplaces

goplaces is a Go-based command-line interface and client library designed for interacting with the Google Places API (New) and the Google Routes API. It provides developers with a typed Go client and a single-binary CLI to perform place searches, location resolution, autocomplete suggestions, fetching place details and photos, and executing route-aware queries. The tool is intended for users who need to find and process place information, directions, and related data within their Go applications or via the terminal.

The CLI supports commands such as text search, nearby search, autocomplete, place details, photo retrieval, location resolution, route sampling, and directions. Users can search for places by parameters including text, type, rating, price, open state, and location bias. The CLI outputs human-readable results by default, with an option for stable JSON output using a flag. Global flags are available for API key management, timeouts, color settings, and endpoint overrides. The directions feature provides information such as distance, duration, warnings, steps, units, and drive modifiers.

goplaces is distributed as a static binary and can be installed via Homebrew, the Go toolchain, or by downloading release archives. Both the CLI and the Go client require a Google Places API key, and enabling the relevant APIs in Google Cloud is necessary for operation. The Go package mirrors the CLI's workflows, providing typed request and response structures, deterministic field masks to control requested data, and support for context management. The client allows injection of custom HTTP clients for advanced use cases like retries or tracing.

The project is licensed under the MIT License. Its architecture is organized around a small, explicit surface area, with a clear split between the CLI and the Go client, both sharing core implementation logic for place and route operations.