skills.rest
xu1713
xu1713COMMUNITY
Explore all skills by this author →
GitHub

maps

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

Updated Jun 5, 2026
Search Tags:#routing#geocoding#poi#directions#openstreetmap#osrm#nearby search
One-click install
npx skills add https://github.com/xu1713/openhorse --skill maps-xu1713
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/xu1713/openhorse/tree/main/openhorse/openhorse/skills/productivity/maps
Command: npx skills add https://github.com/xu1713/openhorse --skill maps-xu1713

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It answers location-based questions—where a place is, what's nearby, how far apart two points are, and how to get between them—without requiring API keys or paid map services. ## Core Features & Use Cases - Geocoding & Reverse Geocoding: Convert place names to coordinates and coordinates 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 distance, hours, and clickable map links. - Routing & Directions: Compute driving, walking, or cycling distance, travel time, and turn-by-turn directions through OSRM. - Use Case: A user sends a location pin in chat and asks for nearby cafes; extract the latitude and longitude, run the nearby command, and return a numbered list with distances and tap-to-open map links. ## Quick Start Ask the assistant to find coffee shops near a specific address or landmark and it will run the maps script to return a list with distances and 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 to query the Overpass API for OpenStreetMap POIs. It supports 46 categories like restaurant, cafe, and hospital, returning names, distances, and map links with no API key required.

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

The search command geocodes free-text place names through the Nominatim API using only Python's standard library urllib. It returns latitude, longitude, display name, bounding box, and an importance score for up to five results.

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 road distance, duration, and step-by-step maneuvers.

Why is my Overpass API nearby 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 for zip codes?▼

Nominatim enforces a one-request-per-second rate limit, which the script handles automatically. A bare zip code can match ambiguous locations globally, so include the country or state in the query for accurate results.

Related Skills

Explore More Personal & Entrepreneur Skills→
vellum-aivellum-ai
1.2k

vellum-client-capabilities

Answers questions about Vellum client device capabilities and location access limitations.

Official
Basic
rickyanandarickyananda
1

maps

Resolve location queries into coordinates, addresses, routes, and travel times.

Community
Advanced
devopstalesdevopstales
1

local-pois

Fetch business details for POI IDs from a search API.

Community
Intermediate
HabitaNexusHabitaNexus
1

map-integration

Integrate Google Maps and Mapbox into Flutter applications with markers, routing, and geocoding.

Official
Advanced