maps

Convert place names and coordinates into geocoded JSON results.

Updated May 26, 2026
One-click install
npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill maps-ruiyangruiyi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: maps
Source: https://github.com/ruiyangruiyi/hermes-agent/tree/main/skills/productivity/maps
Command: npx skills add https://github.com/ruiyangruiyi/hermes-agent --skill maps-ruiyangruiyi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Maps helps you turn place names and coordinates into actionable location information like addresses, nearby points of interest, travel time, directions, and timezones without needing paid APIs.

Core Features & Use Cases

  • Geocoding & Reverse Geocoding: Convert a place name to coordinates and convert coordinates back to a human-readable address.
  • Nearby POIs & Area Search: Find restaurants, hospitals, pharmacies, hotels, and many other categories near a point or within a bounding box.
  • Routing & Timezone Intelligence: Calculate travel distance/duration between two places, generate turn-by-turn directions, and fetch timezone info for coordinates.
  • Use Case: You want driving time from “Paris” to “Lyon” and the best nearby restaurants around the destination coordinates; you can complete both tasks in a structured, tool-driven way.

Quick Start

Ask: locate nearby cafes using the coordinates in the Telegram location pin, and return up to 10 results with distances.

Frequently Asked Questions about maps

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I geocode place names and find nearby points of interest using OpenStreetMap data?

You can geocode place names and find nearby points of interest using OpenStreetMap data by leveraging Nominatim for coordinate lookup and Overpass for category-based POI search. This process returns structured JSON results containing addresses and locations.

Can I calculate driving distance and generate turn-by-turn directions without paid routing APIs?

You can calculate driving distance and generate turn-by-turn directions without paid routing APIs by using OSRM endpoints. It computes travel duration and provides step-by-step routing instructions between two coordinates or named places.

How does reverse geocoding convert latitude and longitude coordinates into a human-readable address?

Reverse geocoding converts latitude and longitude coordinates into a human-readable address by querying the Nominatim service with validated coordinate inputs. It processes the location data and returns a structured address format for agent consumption.

Do I need external Python packages to query Overpass and OSRM endpoints for map routing tasks?

You do not need external Python packages to query Overpass and OSRM endpoints for map routing tasks. The implementation relies exclusively on Python standard library modules to interact with these OpenStreetMap services and output structured JSON.

What is the best way to lookup timezone information for specific geographic coordinates?

The best way to lookup timezone information for specific geographic coordinates is to use TimeAPI endpoints. By passing validated latitude and longitude inputs, it retrieves the exact timezone data for the requested location.

Can I search for specific POI categories like hospitals or hotels within a defined bounding box?

You can search for specific POI categories like hospitals or hotels within a defined bounding box using Overpass API queries. It filters OpenStreetMap data based on your category parameters and returns matching locations in structured JSON.