skills.rest
Junkfooooood
JunkfoooooodCOMMUNITY
Explore all skills by this author →
GitHub

maps

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

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

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 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, pharmacies, 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 a chat and asks for nearby cafes; extract the latitude and longitude, run the nearby command with the cafe category, and reply with a numbered list of names, distances, and tap-to-open map links. ## Quick Start Ask the assistant to find coffee shops near a specific 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 place name and a category such as restaurant or cafe. It queries the OpenStreetMap Overpass API, which is free and requires no API key, returning names, distances, and map links.

How do I geocode an address to coordinates in Python?▼

Run the search command with a place name or address, and it returns latitude, longitude, display name, and bounding box from the Nominatim geocoding service. The script uses only the Python standard library, so no packages need to be installed.

Does this maps tool require any API keys or paid services?▼

No. It relies entirely on free open data sources: OpenStreetMap/Nominatim for geocoding, Overpass API for POI search, OSRM for routing, and TimeAPI.io for timezones. None of these require registration or API keys.

What Python dependencies are needed to run the maps script?▼

None beyond Python 3.8 or later. The script uses only standard library modules such as urllib, json, and argparse, so there is nothing to install with pip.

Why does geocoding or POI search sometimes fail or run slowly?▼

Nominatim enforces a one-request-per-second rate limit, which the script handles automatically. Overpass API can be slow at peak hours, so the script falls back between two public mirrors; routing coverage via OSRM is also best in Europe and North America.

Can I search multiple POI categories in one query?▼

Yes. Pass the --category flag multiple times, for example --category restaurant --category bar, and results are merged, deduplicated by OSM identity, and sorted by distance from the search point.

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
refly-airefly-ai
199

google-maps

Geocode addresses, search places by type, and retrieve directions via Google Maps.

Official
Intermediate
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