places-search

Find venues near a location using progressive radius expansion and Google Places queries.

Updated Dec 1, 2025
One-click install
npx skills add https://github.com/Black-Sugar-21/Public-BlackSugar21 --skill places-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: places-search
Source: https://github.com/Black-Sugar-21/Public-BlackSugar21/tree/main/.claude/skills/places-search
Command: npx skills add https://github.com/Black-Sugar-21/Public-BlackSugar21 --skill places-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps locate venues efficiently by combining a progressive-radius search strategy with Google Places, enabling fast discovery around a location even with sparse results.

Core Features & Use Cases

  • Progressive radius search with computedMinR and multi-step radius expansion to cover larger areas efficiently.
  • Fuzzy matching across three levels to align Gemini results with Google Places data.
  • Parallel category-aware or category-agnostic queries with controlled loadMore expansion and paging.
  • City override via forward geocoding to search in a mentioned city instead of the device GPS.
  • Photo retrieval, distance estimates, and travel time to improve user experience.

Quick Start

Search for venues around a city or coordinates using progressive-radius expansion and fuzzy matching.

Frequently Asked Questions about places-search

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

FAQPage Schema
How do I search for venues using Google Places when the initial area has sparse results?

Google Places search handles sparse results by progressively expanding the search radius in multiple steps, querying broader areas in parallel until sufficient venues are found.

What is progressive radius search and how does it help with geocoding?

Progressive radius search starts with a computed minimum radius and systematically expands outward. This geocoding approach efficiently discovers venues near a target location without wasting queries on overly broad initial areas.

How do I match user queries with Google Places data when names don't align exactly?

Fuzzy matching aligns user queries with Google Places data across three levels, ensuring accurate venue matches even when the input names differ from the official listings.

Can I override device GPS to search for places in a specific city?

Yes, you can use city override via forward geocoding to search in a mentioned city instead of device GPS, maintaining the location context across paginated loadMore results.

Does the Google Places search support paginated results and parallel queries?

Yes, the search supports parallel category-aware or category-agnostic queries with controlled loadMore expansion, providing paginated results that include photo retrieval, distance estimates, and travel time.

What configuration is required to run a progressive radius place search?

You need configured RC parameters and helper utilities for distance calculations to run the search, ensuring the progressive radius expansion and paging function correctly across queries.