skills.rest
luckybbjason1
luckybbjason1COMMUNITY
Explore all skills by this author →
GitHub

maps

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

Updated Sep 9, 2026
Search Tags:#routing#timezone#geocoding#directions#nearby places#openstreetmap#poi search
One-click install
npx skills add https://github.com/luckybbjason1/trading --skill maps-luckybbjason1
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/luckybbjason1/trading/tree/main/.hermes/skills/productivity/maps
Command: npx skills add https://github.com/luckybbjason1/trading --skill maps-luckybbjason1

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It answers location-based questions—coordinates for a place, addresses from coordinates, nearby restaurants or hospitals, travel distances, turn-by-turn directions, and timezones—without requiring any API key or paid service. ## Core Features & Use Cases - Geocoding & Reverse Geocoding: Convert place names to coordinates and coordinates to full addresses using Nominatim. - Nearby POI Search: Find places across 46 categories (restaurants, pharmacies, hotels, ATMs, etc.) around coordinates or a named place, with distances and clickable Google Maps links. - Routing & Timezones: Compute driving/walking/cycling distance and duration, get turn-by-turn directions via OSRM, and look up timezone info for any coordinate. - Use Case: A user sends a Telegram location pin and asks for nearby cafes; extract the latitude and longitude from the message and run the nearby command to return a ranked list with distances and tap-to-open map links. ## Quick Start Ask the assistant to find coffee shops near Times Square using the maps skill's nearby command.

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 or cafe. It queries the Overpass API and returns results sorted by distance with names, addresses, and 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 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, argparse) and free public APIs: Nominatim, Overpass, OSRM, and TimeAPI.io. No pip installs or API keys are needed.

Can I get driving or walking directions between two places?▼

Yes, the directions command uses OSRM to return turn-by-turn steps with instruction, distance, duration, and road name. Modes include driving, walking, and cycling, specified with the --mode flag.

What are the limitations of OpenStreetMap-based routing and search?▼

Nominatim enforces a 1 request/second rate limit, OSRM routing coverage is best in Europe and North America, and Overpass can be slow at peak times. The script handles rate limiting and falls back between Overpass mirrors automatically.

Related Skills

Explore More Personal & Entrepreneur Skills→
lxh755818-botlxh755818-bot

find-nearby

Locate nearby places via OpenStreetMap using Overpass and Nominatim APIs.

Community
Basic
rickyanandarickyananda
1

maps

Resolve location queries into coordinates, addresses, routes, and travel times.

Community
Advanced
malue-aimalue-ai
36

local-places

Searches Google Places API via a local FastAPI server for addresses and details.

Official
Intermediate
HabitaNexusHabitaNexus
1

map-integration

Integrate Google Maps and Mapbox into Flutter applications with markers, routing, and geocoding.

Official
Advanced