maps

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

Updated Aug 21, 2026
One-click install
npx skills add https://github.com/TylerSimons1127/vibe --skill maps-tylersimons1127
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/TylerSimons1127/vibe/tree/main/skills/productivity/maps
Command: npx skills add https://github.com/TylerSimons1127/vibe --skill maps-tylersimons1127

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It answers location questions—where a place is, what's nearby, how far apart two places are, and how to get between them—without requiring any 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 an address via the Overpass API, with distance, opening hours, and clickable Google Maps 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 Telegram location pin and asks for nearby cafes; extract the latitude and longitude, run the nearby command with the cafe category, and reply with a numbered list of names, distances, and tap-to-open map links. ## Quick Start Ask the agent to find coffee shops near Times Square and it will run the maps script to return a list with distances and map links.

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?▼

Run the nearby command with coordinates or a --near address and a category like restaurant, cafe, or hospital. It queries the Overpass API and returns names, addresses, distances, opening hours, and clickable Google Maps links sorted by distance.

How to geocode an address to coordinates without an API key?▼

Use the search command with a place name or address, which queries Nominatim, OpenStreetMap's free geocoder. It returns latitude, longitude, display name, bounding box, and importance score with no API key required.

Does this maps tool require installing Python packages?▼

No, the maps_client.py script uses only the Python standard library (urllib, json, math) and requires Python 3.8 or higher. There are no pip installs or external dependencies needed.

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

Yes, the directions command supports driving, walking, and cycling modes via OSRM routing profiles. It returns numbered turn-by-turn steps with instruction, distance, duration, road name, and maneuver type.

What are the limitations of OpenStreetMap routing and POI search?▼

OSRM routing coverage is best for Europe and North America, and Nominatim enforces a 1 request per second rate limit. Overpass can be slow at peak hours, though the script automatically falls back between mirrors.