maps

Geocode addresses, find nearby places, and compute routes using OpenStreetMap data.

33|1|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/infinition/LaRuche --skill maps-infinition
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/infinition/LaRuche/tree/main/laruche/skills/maps
Command: npx skills add https://github.com/infinition/LaRuche --skill maps-infinition

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It answers everyday location questions—where a place is, what is around it, how far away something is, and how to get there—without requiring any API key, account, or paid map service. ## Core Features & Use Cases - Geocoding and Reverse Geocoding: Convert place names or addresses into coordinates and coordinates back into structured addresses via Nominatim. - Nearby POI Search: Find restaurants, pharmacies, hotels, and 43 other categories of places around coordinates or a named location using the Overpass API, with distance, opening hours, and tap-to-open map links. - Routing and Distance: Compute road distance, travel time, and turn-by-turn directions between two places for driving, walking, or cycling via OSRM, plus timezone lookup for any coordinate. - Use Case: A user shares their coordinates and asks for nearby cafes that are open now; the skill returns a distance-sorted list with hours, phone numbers, and directions links. ## Quick Start Ask the assistant to find coffee shops near a specific address or to compute the driving time between two cities, and it will run the bundled maps script and return the results.

Frequently Asked Questions about maps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I geocode an address without an API key?▼

Run the bundled maps_client.py script with the search command followed by the place name or address. It queries OpenStreetMap's Nominatim service, which is free and requires no key, and returns coordinates as JSON.

How do I find nearby restaurants or pharmacies by coordinates?▼

Use the nearby command with latitude and longitude plus a category such as restaurant or pharmacy. It queries the Overpass API and returns a distance-sorted list with names, addresses, opening hours, and map links.

Does this maps tool require installing Python packages?▼

No. The script uses only the Python 3.8+ standard library, so there is nothing to install. It communicates with Nominatim, Overpass, OSRM, and TimeAPI.io over plain HTTP.

Why does the nearby search return an Overpass mirrors failed error?▼

Both public Overpass servers timed out, which happens at peak hours. Wait and retry once, or fall back to the search and reverse commands, which use Nominatim and are unaffected by Overpass outages.

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

OSRM routing coverage is strongest in Europe and North America, so routes elsewhere may be inaccurate. Opening hours are volunteer-contributed and can be stale, so they should not be treated as guaranteed.