skills.rest
CHENHUI-X
CHENHUI-XCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

maps

Geocode places, find nearby POIs, and compute routes via OpenStreetMap and OSRM.

Updated Jul 3, 2026
Search Tags:#routing#geocoding#poi#directions#openstreetmap#osrm#nearby search
One-click install
npx skills add https://github.com/CHENHUI-X/toolbox --skill maps-chenhui-x
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/CHENHUI-X/toolbox/tree/main/official-skills/productivity/maps
Command: npx skills add https://github.com/CHENHUI-X/toolbox --skill maps-chenhui-x

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It answers location-based questions—where a place is, what's nearby, how far apart two points are, and how to get between them—without requiring API keys or paid map services. ## Core Features & Use Cases - Geocoding & Reverse Geocoding: Convert place names to coordinates and coordinates back to full addresses using Nominatim. - Nearby POI Search: Find restaurants, hospitals, pharmacies, hotels, and 40+ other categories around coordinates or a named place via the Overpass API, with distance, opening hours, and clickable map links. - Routing & Directions: Compute driving, walking, or cycling distance, travel time, and turn-by-turn directions between two places using OSRM. - Use Case: A user sends a location pin in a chat and asks for nearby cafes; extract the latitude and longitude, run the nearby command with the cafe category, and return a numbered list with distances and tap-to-open map links. ## Quick Start Ask the assistant to find restaurants near Times Square or to get walking directions from your hotel to a conference center.

Frequently Asked Questions about maps

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

FAQPage Schema
How do I find nearby restaurants or places using OpenStreetMap?▼

Use the nearby command with coordinates or a --near place name plus a category like restaurant, cafe, or hospital. It queries the Overpass API and returns results sorted by distance with addresses, opening hours, and clickable Google Maps links.

How do I geocode an address without a Google Maps API key?▼

Use the search command, which calls the free Nominatim geocoding service from OpenStreetMap. It returns latitude, longitude, display name, bounding box, and importance score with no API key or registration required.

Does this maps tool require any Python packages or API keys?▼

No. The script uses only the Python 3.8+ standard library (urllib, json, math) and free public APIs: Nominatim, Overpass, OSRM, and TimeAPI.io. No pip installs or API keys are needed.

Why is my Overpass API nearby search slow or failing?▼

Public Overpass servers can be rate-limited or overloaded during peak hours. The script automatically retries and falls back between two mirrors (overpass-api.de and overpass.kumi.systems), so transient failures usually resolve on retry.

What are the limitations of OSRM routing for directions?▼

OSRM routing coverage is best for Europe and North America and may be incomplete elsewhere. It supports driving, walking, and cycling profiles, and Nominatim geocoding is limited to one request per second per its terms of service.

Related Skills

Explore More Personal & Entrepreneur Skills→
trohitgtrohitg
356

location-skill

Retrieve real-time GPS location data from an Android device.

Community
Basic
tangzheng202202tangzheng202202
1

find-nearby

Identify nearby places from OpenStreetMap using Overpass and Nominatim, outputting JSON with distances and coordinates.

Community
Advanced
JYeswakJYeswak

maps-local-intel

Resolves place and local-service queries into ranked candidates with sourced addresses and hours.

Community
Intermediate
amo-tech-aiamo-tech-ai
2

mde-maps

Manages Google Maps Platform APIs for location search, routing, and directions.

Community
Advanced