maps

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

115|9|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill maps-atlasomnia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/productivity/maps
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill maps-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It answers location questions—where a place is, what is nearby, how far apart two points are, and what timezone a spot is in—without requiring any API key or paid map service. ## 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, hotels, and 40+ other categories around coordinates or an address via the Overpass API, with distances and clickable map links. - Routing and Timezones: Compute driving, walking, or cycling distance and turn-by-turn directions with OSRM, plus timezone lookup for any coordinate. - Use Case: A user sends a location pin in chat and asks for nearby cafes; the skill runs the nearby command with those coordinates and returns a ranked list with distances and tap-to-open map links. ## Quick Start Ask the assistant to find coffee shops near an address or landmark, for example: find cafes within one kilometer of Times Square.

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 OpenStreetMap Overpass API, which is free and requires no API key, returning names, distances, and map links.

How to geocode an address to coordinates in Python without dependencies?

The search command geocodes any place name through the Nominatim API using only the Python standard library. It returns latitude, longitude, display name, bounding box, and an importance score for up to five matches.

Does OpenStreetMap routing support walking and cycling directions?

Yes, the distance and directions commands support driving, walking, and cycling modes via OSRM profiles. Walking and cycling use the foot and bike profiles, returning road distance, duration, and turn-by-turn steps.

What are the rate limits and limitations of Nominatim and Overpass?

Nominatim allows a maximum of one request per second, which the script enforces automatically. Overpass can be slow at peak hours, so the script falls back between two public mirrors, and OSRM routing coverage is best in Europe and North America.

Why does a nearby search return no results for my category?

The category must be one of the 46 supported values such as restaurant, pharmacy, or hotel, and the radius must cover actual OSM-tagged places. Sparsely mapped areas or a too-small radius commonly produce empty results.