maps

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

1|Updated Jun 19, 2026
One-click install
npx skills add https://github.com/Lento47/arcana-community --skill maps-lento47
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/Lento47/arcana-community/tree/main/skills/productivity/maps
Command: npx skills add https://github.com/Lento47/arcana-community --skill maps-lento47

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 points 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 a named place via the Overpass API, with distance sorting 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. - Timezone & Area Lookup: Get timezone info for coordinates and bounding boxes for named areas to scope geographic searches. - 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 agent to find coffee shops near a specific address or landmark, and it will run the maps script to return a distance-sorted list with 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 place name and a category such as restaurant, cafe, or hospital. It queries the Overpass API and returns results sorted by distance with names, addresses, and Google Maps links.

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

Use the search command with a place name or address, which queries the free Nominatim service. It returns latitude, longitude, display name, bounding box, and an 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, so no pip installs are needed. All HTTP calls to Nominatim, Overpass, OSRM, and TimeAPI.io are made with urllib.

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

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

Why is the nearby search sometimes slow or failing?▼

The Overpass API can be slow during peak hours, so the script automatically falls back between two public mirrors. Nominatim requests are also rate-limited to one per second to comply with its terms of service.

What are the limitations of OSRM routing coverage?▼

OSRM routing coverage is best for Europe and North America and may be incomplete elsewhere. The distance and directions commands also require the destination to be passed with the --to flag rather than positionally.