Karten Skill
Standortintelligenz mit freien, offenen Datenquellen. 8 Befehle, 44 POI-Kategorien, keine Abhängigkeiten (nur Python-Standardbibliothek), kein API-Schlüssel erforderlich.
Datenquellen: OpenStreetMap/Nominatim, Overpass API, OSRM, TimeAPI.io.
Dieses Skill ersetzt das alte find-nearby-Skill – alle Funktionen von find-nearby sind im folgenden nearby-Befehl enthalten, mit derselben --near "<ort>"-Abkürzung und Multi-Kategorie-Unterstützung.
Wann es verwendet werden sollte
- Der Benutzer sendet einen Telegram-Standortpin (Breiten-/Längengrad in der Nachricht) →
nearby - Der Benutzer möchte Koordinaten für einen Ortsnamen →
search - Der Benutzer hat Koordinaten und möchte die Adresse →
reverse - Der Benutzer fragt nach nahegelegenen Restaurants, Krankenhäusern, Apotheken, Hotels usw. →
nearby - Der Benutzer möchte Fahr-/Geh-/Radfahrstrecke oder Reisezeit →
distance - Der Benutzer möchte eine detaillierte Wegbeschreibung zwischen zwei Orten →
directions - Der Benutzer möchte Zeitzoneninformationen für einen Standort →
timezone - Der Benutzer möchte POIs innerhalb eines geografischen Gebiets suchen →
area+bbox
Voraussetzungen
Python 3.8+ (nur Standardbibliothek – keine pip-Installationen erforderlich).
Skriptpfad: ~/.hermes/skills/maps/scripts/maps_client.py
Befehle
MAPS=~/.hermes/skills/maps/scripts/maps_client.py
search — Ortsnamen geokodieren
python3 $MAPS search "Eiffelturm"
python3 $MAPS search "1600 Pennsylvania Ave, Washington DC"
Gibt zurück: lat, lon, Anzeigename, Typ, Begrenzungsrahmen, Relevanz-Score.
reverse — Koordinaten zu Adresse
python3 $MAPS reverse 48.8584 2.2945
Gibt zurück: vollständige Adressaufschlüsselung (Straße, Stadt, Bundesland, Staat, Postleitzahl).
nearby — Orte nach Kategorie finden
# Nach Koordinaten (z. B. von einem Telegram-Standortpin)
python3 $MAPS nearby 48.8584 2.2945 restaurant --limit 10
python3 $MAPS nearby 40.7128 -74.0060 hospital --radius 2000
# Nach Adresse / Stadt / PLZ / Wahrzeichen — --near automatisch geokodiert
python3 $MAPS nearby --near "Times Square, New York" --category cafe
python3 $MAPS nearby --near "90210" --category pharmacy
# Mehrere Kategorien in einer Abfrage zusammengefasst
python3 $MAPS nearby --near "Downtown Austin" --category restaurant --category bar --limit 10
46 Kategorien: 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.
Jedes Ergebnis enthält: name, address, lat/lon, distance_m, maps_url (klickbarer Google Maps-Link), directions_url (Google Maps-Route vom Suchpunkt) und, falls verfügbar, gepflegte Tags: cuisine, hours (Öffnungszeiten), phone, website.
distance — Reisestrecke und -zeit
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
Modi: driving (Standard), walking, cycling. Gibt Straßendistanz, Dauer und Luftlinie zum Vergleich zurück.
directions — Schritt-für-Schritt-Navigation
python3 $MAPS directions "Eiffelturm" --to "Louvre-Museum" --mode walking
python3 $MAPS directions "JFK Flughafen" --to "Times Square" --mode driving
Gibt nummerierte Schritte mit Anweisung, Distanz, Dauer, Straßenname und Manövertyp (Abbiegen, Abfahren, Ankommen usw.) zurück.
timezone — Zeitzone für Koordinaten
python3 $MAPS timezone 48.8584 2.2945
python3 $MAPS timezone 35.6762 139.6503
Gibt Zeitzonenname, UTC-Versatz und aktuelle Ortszeit zurück.
area — Begnungsrahmen und Fläche für einen Ort
python3 $MAPS area "Manhattan, New York"
python3 $MAPS area "London"
Gibt Begrenzungsrahmen-Koordinaten, Breite/Höhe in km und ungefähre Fläche zurück. Nützlich als Eingabe für den bbox-Befehl.
bbox — Innerhalb eines Begrenzungsrahmens suchen
python3 $MAPS bbox 40.75 -74.00 40.77 -73.98 restaurant --limit 20
Findet POIs innerhalb eines geografischen Rechtecks. Verwenden Sie zuerst area, um die Begrenzungsrahmen-Koordinaten für einen benannten Ort zu erhalten.
Arbeiten mit Telegram-Standortpins
Wenn ein Benutzer einen Standortpin sendet, enthält die Nachricht die Felder latitude: und longitude:. Extrahieren Sie diese und übergeben Sie sie direkt an nearby:
# Benutzer hat einen Pin bei 36.17, -115.14 gesendet und fragt "finde Cafés in der Nähe"
python3 $MAPS nearby 36.17 -115.14 cafe --radius 1500
Präsentieren Sie die Ergebnisse als nummerierte Liste mit Namen, Entfernungen und dem maps_url-Feld, damit der Benutzer einen tap-to-open-Link im Chat erhält. Bei Fragen wie "Jetzt geöffnet?" überprüfen Sie das hours-Feld; wenn es fehlt oder unklar ist, verifizieren Sie mit web_search, da OSM-Öffnungszeiten von der Community gepflegt werden und nicht immer aktuell sind.
Workflow-Beispiele
"Finde italienische Restaurants in der Nähe des Kolosseums":
nearby --near "Kolosseum Rom" --category restaurant --radius 500— ein Befehl, automatisch geokodiert
"Was befindet sich in der Nähe dieses Standortpins?":
- Extrahiere Lat/Lon aus der Telegram-Nachricht
nearby LAT LON cafe --radius 1500
"Wie gehe ich vom Hotel zum Konferenzzentrum?":
directions "Hotelname" --to "Konferenzzentrum" --mode walking
"Welche Restaurants gibt es in der Innenstadt von Seattle?":
area "Downtown Seattle"→ Begrenzungsrahmen erhaltenbbox S W N E restaurant --limit 30
Fallstricke
- Nominatim ToS: max. 1 Anfrage/s (wird automatisch vom Skript behandelt)
nearbybenötigt lat/lon ODER--near "<Adresse>"– eines von beiden ist erforderlich- OSRM-Routingabdeckung ist in Europa und Nordamerika am besten
- Overpass API kann während Stoßzeiten langsam sein; das Skript fällt automatisch zwischen Spiegelservern zurück (overpass-api.de → overpass.kumi.systems)
distanceunddirectionsverwenden das Flag--tofür das Ziel (nicht positionsbasiert)- Wenn eine Postleitzahl allein weltweit mehrdeutige Ergebnisse liefert, Land/Bundesland hinzufügen
Verifizierung
python3 ~/.hermes/skills/maps/scripts/maps_client.py search "Freiheitsstatue"
# Sollte lat ~40.689, lon ~-74.044 zurückgeben
python3 ~/.hermes/skills/maps/scripts/maps_client.py nearby --near "Times Square" --category restaurant --limit 3
# Sollte eine Liste von Restaurants in ~500m Entfernung vom Times Square zurückgeben