maps

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

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/raulisai/eva02 --skill maps-raulisai
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/raulisai/eva02/tree/main/apps/eva-core/src/skills/productivity/maps
Command: npx skills add https://github.com/raulisai/eva02 --skill maps-raulisai

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 any paid API keys or third-party SDKs. ## Core Features & Use Cases - Geocoding & Reverse Geocoding: Convert place names to coordinates and coordinates back to full addresses using Nominatim. - Nearby POI Search: Query 46 categories (restaurants, hospitals, pharmacies, hotels, etc.) around coordinates or a named place via the Overpass API, with distance sorting and clickable Google Maps links. - Routing & Timezones: Compute driving/walking/cycling distances, turn-by-turn directions via OSRM, and timezone lookups for any coordinate. - Use Case: A user sends a Telegram location pin and asks for nearby cafes; extract the latitude/longitude and run the nearby command to return a ranked list with 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 POIs without a Google Maps API key?

Use the nearby command with coordinates or a --near place name and a category like restaurant or cafe. It queries the free Overpass API from OpenStreetMap and returns results sorted by distance with clickable Google Maps links.

How do I geocode an address using only Python stdlib?

Run the search command with a place name, which calls the Nominatim API and returns latitude, longitude, display name, and bounding box. The script uses only urllib from the standard library, so no pip installs are needed.

Does this maps tool require an API key or paid account?

No API key is required. It uses free public services: Nominatim for geocoding, Overpass API for POI search, OSRM for routing, and TimeAPI.io for timezones. Nominatim's 1 request/second rate limit is handled automatically.

What travel modes does OSRM routing support for directions?

The distance and directions commands support driving, walking, and cycling modes, mapped to OSRM profiles. Routing coverage is best for Europe and North America, and results include distance, duration, and step-by-step maneuvers.

Why does a nearby POI search sometimes fail or run slowly?

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