Vibeleaderboard
← Back to Tools
Index / tool

goplaces

github.com/openclaw/goplaces
Visit goplaces.sh
Category
Developer Tools
Rank
No. 1338Tools index

Previous survey · No. 1346 ·

Pricing
Open Source
Type
TOOL
Builder
openclaw
GitHub
252 stars
Latest release
v0.4.9
Date

About

Modern Google Places CLI written in Go — search, autocomplete, and fetch place details from the terminal.

What it does

goplaces turns place discovery and route questions into compact terminal output or structured JSON. It handles text and nearby searches, suggestions, details, photos, location resolution, directions, and searches around sampled route waypoints. Go programs can use the same workflows through typed requests and responses.

Why it's ranked here

This is a focused, practical wrapper around otherwise fiddly Google API requests. Human-readable output serves exploration, while JSON and typed Go interfaces support automation. Route sampling, field-mask handling, input validation, and terminal-safe errors give it more depth than a thin command wrapper.

What's good

The human and machine output modes make one tool useful for inspection, shell pipelines, and agents. Search filters cover place type, opening state, rating, price, locale, and geographic bias. Route search samples a computed path, searches waypoints concurrently, and removes duplicate places across them. Endpoint overrides also support proxies and mock servers.

Tradeoffs

It requires a Google Cloud API key, enabled services, billing, and quota management. Route and directions workflows additionally require the Routes API. Its scope remains Google Places plus selected routing workflows, not broad Google Maps access. The required Go toolchain is unusually specific, although published binaries avoid that requirement.

How to use it well

Use it when a terminal workflow or Go service needs repeatable place lookup with predictable JSON. Start interactively with compact output, then switch to JSON for scripts or agents. Use route search for finding stops near a journey. Choose another tool when you need a visual map, broader mapping services, or a provider other than Google.

Technical notes+

README.md documents Homebrew, Go installation, release archives, API setup, and the CLI and library surfaces. go.mod declares Go 1.26.5 and a single direct dependency on github.com/alecthomas/kong. internal/cli/run.go builds typed requests, selects formatted or indented JSON output, maps validation failures to exit code 2, and sanitizes errors. internal/places/client.go applies a default ten-second HTTP timeout, sends API keys and field masks in headers, caps response reads at 1 MiB, and supports injectable HTTP clients and endpoint overrides. internal/places/route.go decodes route polylines, samples waypoints by distance, limits concurrent searches to four, cancels after the first error, and deduplicates results by place ID. internal/cli/cli_test.go exercises human and JSON output, request mapping, negative coordinates, mock endpoints, and unsafe terminal-text removal.

Observed

License
MIT
Primary language
Go
Interfaces
Command-line application and typed Go client library
Installation
Homebrew cask, Go install, and prebuilt archives with checksums
Platform support
Homebrew installation is documented for macOS and Linux
API coverage
Google Places API (New) plus selected Google Routes API workflows
Direct dependency
The Go module declares Kong as its single direct dependency
Testing structure
Repository text includes CLI tests using local HTTP test servers

Read from README.md, go.mod, Makefile, internal/cli/doc.go, internal/cli/run.go, internal/cli/root.go, internal/cli/color.go, internal/cli/route.go, internal/cli/render.go, internal/cli/version.go, internal/cli/cli_test.go, internal/places/photo.go, internal/places/route.go, internal/places/types.go, internal/places/client.go.

What it can do

  • Search for places by name or query

    Place name or search query → List of matching places with basic information

  • Autocomplete place names during typing

    Partial place name or address → Suggested place completions

  • Fetch detailed information about a specific place

    Place ID or selected place → Comprehensive place details including address, ratings, hours, contact info

  • Execute place operations from command line

    CLI commands with place search parameters → Terminal output with place data

Tags

google-placesgocliopenclawlocation

Tech Stack

Go

Comments (0)

No comments yet

Editorially curated, with community endorsements as a secondary signal. Corrections welcome.