maps

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

Updated Jul 7, 2026
One-click install
npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill maps-jamsdoescode
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/jamsdoescode/Erik-s-Portfolio/tree/main/openclicky/AppResources/OpenClicky/OpenClickyBundledSkills/maps
Command: npx skills add https://github.com/jamsdoescode/Erik-s-Portfolio --skill maps-jamsdoescode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It answers everyday location questions—where a place is, what is nearby, how far two points are, and what timezone a coordinate falls in—without requiring API keys or paid map services. ## Core Features & Use Cases - Geocoding and Reverse Geocoding: Convert place names to coordinates and coordinates to full addresses using Nominatim. - Nearby POI Search: Find restaurants, hospitals, pharmacies, and 40+ other categories around coordinates or an auto-geocoded place name, with distance, hours, and clickable map links. - Routing and Directions: Compute driving, walking, or cycling distance, travel time, and turn-by-turn directions via OSRM. - Use Case: A user sends a Telegram location pin and asks for nearby cafes; extract the latitude and longitude, run the nearby command with a radius, and reply with a numbered list of results including tap-to-open map links. ## Quick Start Ask the assistant to find coffee shops near a specific address or landmark and it will geocode the place and return nearby results with 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?▼

Use the nearby command with latitude and longitude plus a category, such as nearby 48.8584 2.2945 restaurant with an optional radius and limit. Results include name, address, distance in meters, and clickable Google Maps links.

How to geocode an address without a Google Maps API key?▼

Use the Nominatim search endpoint from OpenStreetMap, which is free and requires no API key. Send a GET request with the place name as the q parameter and receive latitude, longitude, display name, and bounding box.

Does this skill require an API key or paid account?▼

No API key is required. It uses free public services: Nominatim for geocoding, Overpass API for POI data, OSRM for routing, and TimeAPI.io for timezones, all callable with Python stdlib or curl.

Can I get walking or cycling directions between two places?▼

Yes, the directions command supports driving, walking, and cycling modes via OSRM. It returns numbered turn-by-turn steps with instruction, distance, duration, road name, and maneuver type.

What are the limitations of OpenStreetMap routing and POI data?▼

OSRM routing coverage is best for Europe and North America, and Overpass can be slow at peak hours though the script falls back between mirrors. Nominatim enforces a 1 request per second limit, and opening hours data is community-maintained so it may be outdated.