maps

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

Updated Aug 19, 2026
One-click install
npx skills add https://github.com/swcstudiospace/aimeecodes --skill maps-swcstudiospace
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/swcstudiospace/aimeecodes/tree/main/.aimee/skills/maps
Command: npx skills add https://github.com/swcstudiospace/aimeecodes --skill maps-swcstudiospace

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 places are, and how to get between them—without requiring API keys or paid map services. ## Core Features & Use Cases - Geocoding and 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 distances and clickable map links. - Routing and Timezones: Compute driving, walking, or cycling distances and turn-by-turn directions via OSRM, plus timezone lookups for any coordinate. - Use Case: A user sends a location pin in chat and asks for nearby cafes; extract the latitude and longitude, run the nearby command with the cafe category, and return a numbered list with distances and tap-to-open map links. ## Quick Start Ask the agent to find coffee shops near a named place, for example: find cafes within 1500 meters of Times Square, New York.

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 a --near place name plus a category such as restaurant, cafe, or hospital. It queries the Overpass API and returns results sorted by distance with names, addresses, and clickable Google Maps links.

How do I geocode an address without a Google Maps API key?▼

Use the search command, which calls the free Nominatim geocoding service from OpenStreetMap. It returns latitude, longitude, display name, bounding box, and an importance score, with no API key required.

Does this maps tool require any Python packages or API keys?▼

No. The script uses only the Python 3.8+ standard library (urllib, json, argparse) and free public endpoints: Nominatim, Overpass API, OSRM, and TimeAPI.io. No pip installs or API keys are needed.

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

Yes. The directions command accepts an origin, a --to destination, and a --mode of driving, walking, or cycling. It uses OSRM to return numbered turn-by-turn steps with distances, durations, and road names.

Why is OpenStreetMap nearby search sometimes slow or incomplete?▼

The Overpass API can be slow during peak hours, so the script automatically falls back between two public mirrors. OSM data is community-maintained, so opening hours and some POIs may be missing or outdated; verify time-sensitive details with a web search.