maps

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It answers location-based questions—where a place is, what is 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, hotels, and 40+ other categories around coordinates or an address via the Overpass API, with distances and clickable map links. - Routing & Timezones: Get driving/walking/cycling distances, turn-by-turn directions via OSRM, and 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 numbered list of cafes with distances and tap-to-open map links. ## Quick Start Use the maps skill to find coffee shops within 1500 meters of the location pin I just sent you.

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 without a Google Maps API key?▼

Use the nearby command with coordinates or a --near address and a category like restaurant or cafe. It queries the OpenStreetMap Overpass API, which is free and requires no API key, returning names, distances, and map links.

How to geocode an address to coordinates in Python without dependencies?▼

Run the search command with a place name or address; it calls the Nominatim geocoding service using only Python's standard library urllib. Results include latitude, longitude, display name, bounding box, and importance score.

Does OpenStreetMap routing support walking and cycling directions?▼

Yes, the distance and directions commands support driving, walking, and cycling modes via OSRM profiles. Routing coverage is best for Europe and North America, and directions return numbered turn-by-turn steps.

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

Public Overpass servers can be rate-limited or slow during peak hours. The script automatically falls back between mirrors (overpass-api.de to overpass.kumi.systems) and retries transient HTTP errors before failing.

What are the limitations of Nominatim geocoding?▼

Nominatim's terms of service limit usage to one request per second, which the script enforces automatically. Ambiguous queries like bare zip codes may return wrong global results, so include a country or state for precision.