maps

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Answering location questions — where a place is, what's nearby, how far apart two points are, or what timezone a coordinate falls in — normally requires paid mapping APIs and API keys. This Skill provides geocoding, POI search, routing, and timezone lookups using free OpenStreetMap data sources with no API key and no dependencies beyond the Python standard library. ## 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 clickable Google Maps links in results. - Routing & Directions: Compute driving, walking, or cycling distance and travel time between two places, plus turn-by-turn navigation steps via OSRM. - 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 tap-to-open map links. ## Quick Start Ask the agent to find coffee shops near Times Square and it will run the maps script's nearby command and return a list with 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 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 Overpass API against OpenStreetMap data and returns names, distances, opening hours, and clickable map links with no API key required.

How to geocode an address to coordinates in Python without installing packages?▼

Run the search command with a place name, which calls the Nominatim API using only the Python standard library. It returns latitude, longitude, display name, bounding box, and an importance score for the top matches.

Does OpenStreetMap routing support walking and cycling directions?▼

Yes, the distance and directions commands accept a --mode flag with driving, walking, or cycling, mapped to OSRM profiles. Routing coverage is best for Europe and North America.

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

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

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 resolve to the wrong country, so include a state or country for better accuracy.