maps

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

1|Updated Jul 22, 2026
One-click install
npx skills add https://github.com/IceHeartGitH/Hermes-Agent-Android-Termux --skill maps-iceheartgith
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/IceHeartGitH/Hermes-Agent-Android-Termux/tree/main/custom-skills/productivity/maps
Command: npx skills add https://github.com/IceHeartGitH/Hermes-Agent-Android-Termux --skill maps-iceheartgith

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 two points are, and how to get between them—without requiring API keys or paid mapping services. ## Core Features & Use Cases - Geocoding & Reverse Geocoding: Convert place names to coordinates and coordinates 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 distance, opening hours, and clickable map links. - Routing & Timezones: Compute driving, walking, or cycling distance and turn-by-turn directions via OSRM, plus timezone lookup for any coordinate. - Use Case: A user sends a location pin in chat 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 assistant to find restaurants near Times Square using the maps skill's nearby command with a place name and category.

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

Run the search command with a place name or address; it uses the free Nominatim service from OpenStreetMap, which requires no API key. Results include latitude, longitude, display name, bounding box, and importance score.

Does this maps tool require installing Python packages?▼

No, it uses only the Python 3.8+ standard library, so no pip installs are needed. All HTTP requests to Nominatim, Overpass, OSRM, and TimeAPI.io are made with urllib from the stdlib.

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

Yes, the directions and distance commands support driving, walking, and cycling modes via OSRM profiles. Directions returns numbered turn-by-turn steps with road names, distances, and maneuver types.

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

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