find-nearby

Locate nearby amenities from OpenStreetMap using Python, Nominatim, and Overpass API.

Updated Apr 19, 2026

Search Tags:#maps #json-output #geocoding #location-based #openstreetmap #find-nearby #overpass

Ready to run

npx skills add https://github.com/gqf2008/hermez-ai --skill find-nearby-gqf2008

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: find-nearby
Source: https://github.com/gqf2008/hermez-ai/tree/main/skills/leisure/find-nearby
Command: npx skills add https://github.com/gqf2008/hermez-ai --skill find-nearby-gqf2008

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Locate nearby amenities (restaurants, cafes, bars, pharmacies, and more) around a given location using OpenStreetMap data without API keys.

Core Features & Use Cases

Geocoding by address: Convert addresses, cities, or ZIP codes to coordinates when needed.
Nearby search by radius: Find multiple types of places within a defined radius and sort by distance.
Output flexibility: Return human-friendly text or machine-readable JSON with fields such as name, type, distance, coordinates, and map links.
Works with coordinates, addresses, cities, ZIP codes, or Telegram location pins; returns distance and directions URLs.

Quick Start

Provide a location and one or more place types, then run the script to retrieve nearby places within a chosen radius.

Frequently Asked Questions about find-nearby

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

FAQPage Schema

How do I find nearby places using OpenStreetMap without an API key?▼

You can find nearby places using OpenStreetMap data without an API key by providing a location and place types. The tool uses Nominatim for geocoding and the Overpass API to search within a configurable radius, returning sorted results.

Can I search for nearby amenities using a street address or ZIP code instead of coordinates?▼

Yes, you can search using a street address or ZIP code. The geocoding feature converts addresses, cities, or ZIP codes into geographic coordinates automatically, enabling location-based nearby searches without needing manual coordinate input.

What types of nearby amenities can I locate around a given location?▼

You can locate various amenities around a given location, including restaurants, cafes, bars, pharmacies, and more. The nearby search queries OpenStreetMap data to find multiple place types within your defined radius and sorts them by distance.

Does the nearby search output include distance and map links for quick navigation?▼

Yes, the output includes distance and Google Maps links for quick navigation. Results contain fields like name, type, distance, coordinates, and directions URLs, and can be returned as human-friendly text or machine-readable JSON.

Can I use Telegram location pins to find nearby places with OpenStreetMap?▼

Yes, Telegram location pins are supported as input. The tool accepts coordinates, addresses, cities, ZIP codes, or Telegram location pins to locate nearby amenities and returns distance and directions URLs for your search.

What are the limitations of using Overpass API for location-based geocoding searches?▼

The tool relies on the Overpass API for nearby searches and Nominatim for geocoding. Being free and keyless, it is subject to OpenStreetMap rate limits and data freshness, meaning search results depend on community-contributed map data availability.