maps

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

5|2|Updated May 26, 2026
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill maps-perasyudha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/productivity/maps
Command: npx skills add https://github.com/perasyudha/Nyxora --skill maps-perasyudha

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 points are, and how to get between them—without requiring any API keys or paid map services. ## Core Features & Use Cases - Geocoding & 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 a named place via the Overpass API, with distance, opening hours, and clickable map links. - Routing & Directions: Compute driving, walking, or cycling distance, travel time, and turn-by-turn directions between two places using OSRM. - Use Case: A user sends a location pin in chat and asks for nearby cafes; extract the coordinates and run the nearby command to return a ranked 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 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 place name 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?

Run the search command with a place name or address; it calls the Nominatim geocoding service using only the Python standard library. Results include latitude, longitude, bounding box, and an importance score.

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 respectively, returning distance, duration, and turn-by-turn steps.

Why is Overpass API nearby search sometimes slow or failing?

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

What are the limitations of Nominatim geocoding rate limits?

Nominatim's terms of service allow a maximum of one request per second, which the script enforces automatically with a built-in delay. Ambiguous queries like bare zip codes may return wrong results globally, so include a country or state.