maps

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Answering location questions—where a place is, what is nearby, how far away something is, or what timezone it is in—normally requires juggling multiple mapping APIs and paid keys. This Skill provides geocoding, POI search, routing, and timezone lookups through free OpenStreetMap-based services with no API key and no pip installs. ## Core Features & Use Cases - Geocoding & Reverse Geocoding: Convert place names to coordinates and coordinates back to full address breakdowns via Nominatim. - Nearby POI Search: Find restaurants, hospitals, hotels, and 40+ other categories around coordinates or an address, with distance, opening hours, and tap-to-open 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, run the nearby command with the cafe category, and reply with a numbered list of names, distances, and clickable Google Maps links. ## Quick Start Use the maps skill to find restaurants near Times Square and show their 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?▼

Use the nearby command with coordinates or an address, for example: python maps_client.py nearby --near "Times Square" --category restaurant. It queries the Overpass API across 46 POI categories and returns names, distances, opening hours, and clickable map links.

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

Run python maps_client.py search "Eiffel Tower" to geocode any place name through 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 script uses only the Python 3.8+ standard library (urllib, json, argparse, math). There are no pip installs, no external dependencies, and no API keys needed for any of the eight commands.

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

Yes, the directions command uses OSRM to return turn-by-turn steps: python maps_client.py directions "JFK Airport" --to "Times Square" --mode driving. Modes include driving, walking, and cycling, with distance and duration per step.

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

OSRM routing coverage is best for Europe and North America, and Nominatim enforces a 1 request/second rate limit handled automatically. Opening hours are community-maintained and may be outdated, so verify 'open now' questions with a web search.