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.