SKILLbundledHermes Bundled Skills

Maps

Name: Maps
Author: Mibayy

Geocode, POIs, routes, timezones via OpenStreetMap/OSRM

mapsgeocodingplacesroutingdistancedirectionsnearbylocation

Last registry verification2026-08-18v1.2.0Mibayy

Open original source ↗اقرأ بالعربية

Plain meaning

What does it add to Hermes?

Geocode, POIs, routes, timezones via OpenStreetMap/OSRM

Maps is a skill related to extending the agent. It adds a capability or workflow to Hermes. The publisher description explains the intent, while granted permissions determine what it can actually do.

This plain-language explanation is based on the publisher description. The original text remains visible for verification.

Use it when

Use it when your goal in extending the agent is clear and you can limit it to the data and actions it actually needs.

Skip it when

Do not add it merely to experiment when Hermes already has a simpler path, or when you cannot review its source and permissions.

Who is it for?

Best for users who want a repeatable way of working inside Hermes.

Safe first test

Start with non-sensitive data and a small task whose result can be verified and reversed.

Original publisher description

Geocode, POIs, routes, timezones via OpenStreetMap/OSRM

✓

Data source

This entry was indexed from Hermes Bundled Skills. Our explanation interprets the type and domain without inventing a capability not present upstream.

Security review

The source is official or editorially reviewed, but you still need to review permissions and version compatibility.

Safe setup path

Inspect, install, then test.

01
Open the source
Match the publisher, license, and description to your need. Check the real update history.
02
Review permissions and secrets
Never paste a secret value into this site. Use environment-variable names and grant the smallest scope.
03
Copy setup only after review
The controls below copy text. They do not execute commands on your device.
04
Test with a non-sensitive task
Inspect the visible tools, then exclude write or delete tools you do not need.

Setup method

Already installed with Hermes.

This skill ships with Hermes and loads when the agent decides it is relevant. There is nothing to install; read the definition below so you know what it will do.

Open the official page ↗

The full skill definition

Exactly what Hermes loads when this skill runs.

Reproduced from the official documentation. Read it before enabling the skill: this text becomes the agent's instructions.

Geocode, POIs, routes, timezones via OpenStreetMap/OSRM.

Skill metadata

A lookup table. Do not read it all; find the row that applies to you.

Source	Bundled (installed by default)
Path	`skills/productivity/maps`
Version	`1.2.0`
Author	Mibayy
License	MIT
Platforms	linux, macos, windows
Tags	`maps`, `geocoding`, `places`, `routing`, `distance`, `directions`, `nearby`, `location`, `openstreetmap`, `nominatim`, `overpass`, `osrm`

Reference: full SKILL.md

Explains the idea itself. Read it slowly; the later sections build on it.

Location intelligence using free, open data sources. 8 commands, 44 POI categories, zero dependencies (Python stdlib only), no API key required.

Data sources: OpenStreetMap/Nominatim, Overpass API, OSRM, TimeAPI.io.

This skill supersedes the old find-nearby skill — all of find-nearby's functionality is covered by the nearby command below, with the same --near "<place>" shortcut and multi-category support.

When to Use

Explains the idea itself. Read it slowly; the later sections build on it.

User sends a Telegram location pin (latitude/longitude in the message) → nearby
User wants coordinates for a place name → search
User has coordinates and wants the address → reverse
User asks for nearby restaurants, hospitals, pharmacies, hotels, etc. → nearby
User wants driving/walking/cycling distance or travel time → distance
User wants turn-by-turn directions between two places → directions
User wants timezone information for a location → timezone
User wants to search for POIs within a geographic area → area + bbox

Prerequisites

Explains the idea itself. Read it slowly; the later sections build on it.

Python 3.8+ (stdlib only — no pip installs needed).

Script path: ~/.hermes/skills/maps/scripts/maps_client.py

Commands

Explains the idea itself. Read it slowly; the later sections build on it.

Shell1 line

MAPS=~/.hermes/skills/maps/scripts/maps_client.py

search — Geocode a place name

Shell2 lines

python3 $MAPS search "Eiffel Tower"
python3 $MAPS search "1600 Pennsylvania Ave, Washington DC"

Returns: lat, lon, display name, type, bounding box, importance score.

reverse — Coordinates to address

Shell1 line

python3 $MAPS reverse 48.8584 2.2945

Returns: full address breakdown (street, city, state, country, postcode).

nearby — Find places by category

Shell10 lines

# By coordinates (from a Telegram location pin, for example)
python3 $MAPS nearby 48.8584 2.2945 restaurant --limit 10
python3 $MAPS nearby 40.7128 -74.0060 hospital --radius 2000

# By address / city / zip / landmark — --near auto-geocodes
python3 $MAPS nearby --near "Times Square, New York" --category cafe
python3 $MAPS nearby --near "90210" --category pharmacy

# Multiple categories merged into one query
python3 $MAPS nearby --near "downtown austin" --category restaurant --category bar --limit 10

46 categories: restaurant, cafe, bar, hospital, pharmacy, hotel, guest_house, camp_site, supermarket, atm, gas_station, parking, museum, park, school, university, bank, police, fire_station, library, airport, train_station, bus_stop, church, mosque, synagogue, dentist, doctor, cinema, theatre, gym, swimming_pool, post_office, convenience_store, bakery, bookshop, laundry, car_wash, car_rental, bicycle_rental, taxi, veterinary, zoo, playground, stadium, nightclub.

Each result includes: name, address, lat/lon, distance_m, maps_url (clickable Google Maps link), directions_url (Google Maps directions from the search point), and promoted tags when available — cuisine, hours (opening_hours), phone, website.

distance — Travel distance and time

Shell3 lines

python3 $MAPS distance "Paris" --to "Lyon"
python3 $MAPS distance "New York" --to "Boston" --mode driving
python3 $MAPS distance "Big Ben" --to "Tower Bridge" --mode walking

Modes: driving (default), walking, cycling. Returns road distance, duration, and straight-line distance for comparison.

Shell2 lines

python3 $MAPS directions "Eiffel Tower" --to "Louvre Museum" --mode walking
python3 $MAPS directions "JFK Airport" --to "Times Square" --mode driving

Returns numbered steps with instruction, distance, duration, road name, and maneuver type (turn, depart, arrive, etc.).

timezone — Timezone for coordinates

Shell2 lines

python3 $MAPS timezone 48.8584 2.2945
python3 $MAPS timezone 35.6762 139.6503

Returns timezone name, UTC offset, and current local time.

area — Bounding box and area for a place

Shell2 lines

python3 $MAPS area "Manhattan, New York"
python3 $MAPS area "London"

Returns bounding box coordinates, width/height in km, and approximate area. Useful as input for the bbox command.

bbox — Search within a bounding box

Shell1 line

python3 $MAPS bbox 40.75 -74.00 40.77 -73.98 restaurant --limit 20

Finds POIs within a geographic rectangle. Use area first to get the bounding box coordinates for a named place.

Working With Telegram Location Pins

Explains the idea itself. Read it slowly; the later sections build on it.

When a user sends a location pin, the message contains latitude: and longitude: fields. Extract those and pass them straight to nearby:

Shell2 lines

# User sent a pin at 36.17, -115.14 and asked "find cafes nearby"
python3 $MAPS nearby 36.17 -115.14 cafe --radius 1500

Present results as a numbered list with names, distances, and the maps_url field so the user gets a tap-to-open link in chat. For "open now?" questions, check the hours field; if missing or unclear, verify with web_search since OSM hours are community-maintained and not always current.

Workflow Examples

Explains the idea itself. Read it slowly; the later sections build on it.

"Find Italian restaurants near the Colosseum":

nearby --near "Colosseum Rome" --category restaurant --radius 500 — one command, auto-geocoded

"What's near this location pin they sent?":

Extract lat/lon from the Telegram message
nearby LAT LON cafe --radius 1500

"How do I walk from hotel to conference center?":

directions "Hotel Name" --to "Conference Center" --mode walking

"What restaurants are in downtown Seattle?":

area "Downtown Seattle" → get bounding box
bbox S W N E restaurant --limit 30

Pitfalls

Explains the idea itself. Read it slowly; the later sections build on it.

Nominatim ToS: max 1 req/s (handled automatically by the script)
nearby requires lat/lon OR --near "<address>" — one of the two is needed
OSRM routing coverage is best for Europe and North America
Overpass API can be slow during peak hours; the script automatically falls back between mirrors (overpass-api.de → overpass.kumi.systems)
distance and directions use --to flag for the destination (not positional)
If a zip code alone gives ambiguous results globally, include country/state

Verification

Explains the idea itself. Read it slowly; the later sections build on it.

Shell5 lines

python3 ~/.hermes/skills/maps/scripts/maps_client.py search "Statue of Liberty"
# Should return lat ~40.689, lon ~-74.044

python3 ~/.hermes/skills/maps/scripts/maps_client.py nearby --near "Times Square" --category restaurant --limit 3
# Should return a list of restaurants within ~500m of Times Square

Maps

What does it add to Hermes?

Inspect, install, then test.

Already installed with Hermes.

Exactly what Hermes loads when this skill runs.

search — Geocode a place name

reverse — Coordinates to address

nearby — Find places by category

distance — Travel distance and time

directions — Turn-by-turn navigation

timezone — Timezone for coordinates

area — Bounding box and area for a place

bbox — Search within a bounding box