goplaces

Query Google Places by name with filters, pagination, and JSON output.

Updated Apr 5, 2026
One-click install
npx skills add https://github.com/dingdyan/openclaw-workspace-v2 --skill goplaces-dingdyan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: goplaces
Source: https://github.com/dingdyan/openclaw-workspace-v2/tree/main/skills/goplaces
Command: npx skills add https://github.com/dingdyan/openclaw-workspace-v2 --skill goplaces-dingdyan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you quickly search for real-world places and retrieve structured place information without manually wrangling Google Places API requests.

Core Features & Use Cases

  • Text search with filtering: Search for places by text query and narrow results using options like open-now, minimum rating, paging, and location bias (lat/lng + radius).
  • Place resolution and details: Resolve a human-readable place string to canonical place identifiers, then fetch details including optional review data.
  • Machine-friendly JSON output: Use JSON output for automation and scripting while still supporting readable, human-friendly output by default.

Quick Start

Run: goplaces search "coffee" --open-now --min-rating 4 --limit 5

Frequently Asked Questions about goplaces

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for nearby places using Google Places API and get JSON output?

To search nearby places and get JSON output, use the goplaces CLI to query Google Places by text. Apply filters like open-now or location bias, and enable JSON output for automated workflows to retrieve structured place data.

Can I filter Google Places text search results by rating and location bias?

Yes, you can filter Google Places text search results using minimum rating, open-now status, and location bias. Specify coordinates and a radius to narrow results, returning searchable places that match your specific criteria.

How do I resolve a place name to a canonical ID and fetch place details?

You can resolve a human-readable place string to canonical place identifiers, then fetch place details. The process queries Google Places to retrieve structured metadata, including optional review data for downstream use.

What do I need to set up before running a Google Places lookup from the command line?

Before running a Google Places lookup, you need a valid GOOGLE_PLACES_API_KEY environment variable. The goplaces CLI uses this key to authenticate requests, with an optional base URL override for custom endpoints.

Does the goplaces CLI support pagination for large Google Places search results?

Yes, the goplaces CLI supports pagination for Google Places text searches. You can retrieve large sets of searchable results across multiple pages, fetching structured place information sequentially for automation.

What is the best way to automate Google Places API requests without manual wrangling?

The best way to automate Google Places API requests is using a CLI tool that supports JSON output. It queries place names, applies text search filters, and returns structured data directly for scripting and automated workflows.