maps

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

6|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill maps-yakeworld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/yakeworld/Synthos/tree/main/skills/extended/external-automation/automation-skills/productivity/maps
Command: npx skills add https://github.com/yakeworld/Synthos --skill maps-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? It answers location-based questions—coordinates for a place, addresses from coordinates, nearby restaurants or hospitals, travel distances, turn-by-turn directions, and timezones—without requiring any API key or paid service. ## Core Features & Use Cases - Geocoding & Reverse Geocoding: Convert place names to coordinates and coordinates to full addresses using Nominatim. - Nearby POI Search: Find 46 categories of places (restaurants, pharmacies, hotels, etc.) around coordinates or a named location via the Overpass API, with distance, opening hours, and clickable map links. - Routing & Timezones: Compute driving/walking/cycling distance and turn-by-turn directions with OSRM, plus timezone lookup for any coordinate. - 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, and return a numbered list with distances and tap-to-open map links. ## Quick Start Ask the assistant to find coffee shops near Times Square using the maps skill's nearby command with the cafe category.

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 using OpenStreetMap in Python?

Run the search command with a place name, for example search "Eiffel Tower". It calls the Nominatim API and returns latitude, longitude, display name, bounding box, and importance score as JSON.

Does this maps tool require installing Python packages?

No. The client script uses only the Python 3.8+ standard library (urllib, json, argparse), so there are no pip installs or external dependencies. It works out of the box on Linux, macOS, and Windows.

Why does a zip code search return ambiguous or wrong results?

Zip codes alone are globally ambiguous, so include the country or state in the query, such as "90210, California, USA". The skill flags ambiguous input and asks for additional context rather than returning incorrect coordinates.

What are the limitations of OSRM routing and Overpass queries?

OSRM routing coverage is best for Europe and North America, and Overpass can be slow at peak hours, though the script automatically falls back between mirrors. Nominatim also enforces a 1 request per second rate limit, handled automatically.