maps

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

1|Updated Jun 24, 2026
One-click install
npx skills add https://github.com/maopujie10-sys/Bailongma --skill maps-maopujie10-sys
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/maopujie10-sys/Bailongma/tree/main/skills/hermes-skills/productivity/maps
Command: npx skills add https://github.com/maopujie10-sys/Bailongma --skill maps-maopujie10-sys

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It answers location-based questions—geocoding addresses, finding nearby places, computing travel distances, and getting directions—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, pharmacies, and 40+ other categories around coordinates or a named place via the Overpass API. - Routing & Directions: Compute driving, walking, or cycling distances, travel times, and turn-by-turn directions with 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 reply with a numbered list including distances and clickable 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 names, distances, and map 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 from coordinates?

Run the nearby command with latitude, longitude, and a category such as restaurant or cafe, optionally setting a radius in meters. Results include name, address, distance, and a clickable Google Maps link for each place.

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

Use the search command with any place name or address; it queries OpenStreetMap's Nominatim service, which is free and requires no API key. It returns latitude, longitude, display name, and bounding box.

Does this maps tool require installing Python packages?

No, the client script uses only the Python 3.8+ standard library, so no pip installs are needed. It calls public HTTP APIs (Nominatim, Overpass, OSRM, TimeAPI.io) directly.

What routing modes are supported for distance and directions?

The distance and directions commands support driving, walking, and cycling modes via OSRM. Driving is the default; routing coverage is best for Europe and North America.

Why is a nearby search slow or failing sometimes?

The Overpass API can be slow during peak hours. The script automatically falls back between mirrors (overpass-api.de to overpass.kumi.systems), and Nominatim requests are rate-limited to 1 per second per its terms of service.