{/* 本页面由 website/scripts/generate-skill-docs.py 从技能 SKILL.md 自动生成。请编辑源 SKILL.md 而非本页面。 */}
地图
通过 OpenStreetMap/OSRM 进行地理编码（Geocode）、POI 搜索、路线规划、时区查询。
技能元数据
| 来源 | 内置（默认安装） |
| 路径 | skills/productivity/maps |
| 版本 | 1.2.0 |
| 作者 | Mibayy |
| 许可证 | MIT |
| 平台 | linux, macos, windows |
| 标签 | maps, geocoding, places, routing, distance, directions, nearby, location, openstreetmap, nominatim, overpass, osrm |
参考：完整 SKILL.md
:::info 以下是此技能被触发时 Hermes 加载的完整技能定义。这是技能激活时代理所看到的指令。 :::
地图技能
使用免费、开放数据源的位置智能服务。8 个命令，44 个 POI 类别，零依赖（仅 Python 标准库），无需 API 密钥。
数据源：OpenStreetMap/Nominatim、Overpass API、OSRM、TimeAPI.io。
此技能取代了旧版的 find-nearby 技能——find-nearby 的所有功能都包含在下面的 nearby 命令中，具有相同的 --near "<place>" 快捷方式和多类别支持。
使用时机
- 用户发送 Telegram 位置钉（消息中的纬度/经度）→
nearby - 用户想要地点的坐标 →
search - 用户有坐标并想要地址 →
reverse - 用户询问附近的餐厅、医院、药店、酒店等 →
nearby - 用户想要驾车/步行/骑行距离或旅行时间 →
distance - 用户想要两地之间的逐向导航 →
directions - 用户想要某位置的时区信息 →
timezone - 用户想要搜索地理区域内的 POI →
area+bbox
前提条件
Python 3.8+（仅标准库——无需 pip 安装）。
脚本路径：~/.hermes/skills/maps/scripts/maps_client.py
命令
MAPS=~/.hermes/skills/maps/scripts/maps_client.pysearch — 对地名进行地理编码
python3 $MAPS search "Eiffel Tower"
python3 $MAPS search "1600 Pennsylvania Ave, Washington DC"返回：纬度、经度、显示名称、类型、边界框、重要性评分。
reverse — 坐标转地址
python3 $MAPS reverse 48.8584 2.2945返回：完整地址分解（街道、城市、州、国家、邮编）。
nearby — 按类别查找地点
# 按坐标（例如来自 Telegram 位置钉）
python3 $MAPS nearby 48.8584 2.2945 restaurant --limit 10
python3 $MAPS nearby 40.7128 -74.0060 hospital --radius 2000
# 按地址/城市/邮编/地标——--near 自动地理编码
python3 $MAPS nearby --near "Times Square, New York" --category cafe
python3 $MAPS nearby --near "90210" --category pharmacy
# 多个类别合并为一次查询
python3 $MAPS nearby --near "downtown austin" --category restaurant --category bar --limit 1046 个类别：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。
每个结果包括：name、address、lat/lon、distance_m、maps_url（可点击的 Google Maps 链接）、directions_url（从搜索点的 Google Maps 导航），以及可用时的推广标签——cuisine、hours（营业时间）、phone、website。
distance — 旅行距离和时间
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模式：driving（默认）、walking、cycling。返回道路距离、时长以及直线距离以供比较。
directions — 逐向导航
python3 $MAPS directions "Eiffel Tower" --to "Louvre Museum" --mode walking
python3 $MAPS directions "JFK Airport" --to "Times Square" --mode driving返回带编号的步骤，包含指令、距离、时长、道路名称和操作类型（转弯、出发、到达等）。
timezone — 坐标的时区
python3 $MAPS timezone 48.8584 2.2945
python3 $MAPS timezone 35.6762 139.6503返回时区名称、UTC 偏移量和当前本地时间。
area — 地点的边界框和面积
python3 $MAPS area "Manhattan, New York"
python3 $MAPS area "London"返回边界框坐标、宽度/高度（公里）和近似面积。可用作 bbox 命令的输入。
bbox — 在边界框内搜索
python3 $MAPS bbox 40.75 -74.00 40.77 -73.98 restaurant --limit 20在地理矩形区域内查找 POI。先使用 area 获取命名地点的边界框坐标。
处理 Telegram 位置钉
当用户发送位置钉时，消息包含 latitude: 和 longitude: 字段。提取这些值并直接传递给 nearby：
# 用户在 36.17, -115.14 发送了位置钉并询问"查找附近的咖啡馆"
python3 $MAPS nearby 36.17 -115.14 cafe --radius 1500将结果显示为带有名称、距离和 maps_url 字段的编号列表，以便用户在聊天中获得点击即开的链接。对于”现在营业吗？“的问题，检查 hours 字段；如果缺失或不清楚，使用 web_search 验证，因为 OSM 营业时间由社区维护，不总是最新的。
工作流示例
“查找罗马斗兽场附近的意大利餐厅”：
nearby --near "Colosseum Rome" --category restaurant --radius 500— 一个命令，自动地理编码
“这个位置钉附近有什么？”：
- 从 Telegram 消息中提取纬度/经度
nearby LAT LON cafe --radius 1500
“如何从酒店步行到会议中心？”：
directions "Hotel Name" --to "Conference Center" --mode walking
“西雅图市中心有哪些餐厅？”：
area "Downtown Seattle"→ 获取边界框bbox S W N E restaurant --limit 30
注意事项
- Nominatim 服务条款：最大 1 请求/秒（脚本自动处理）
nearby需要纬度/经度 OR--near "<address>"——两者必选其一- OSRM 路线规划覆盖最佳范围为欧洲和北美
- Overpass API 在高峰时段可能较慢；脚本会在镜像之间自动回退（overpass-api.de → overpass.kumi.systems）
distance和directions使用--to参数指定目的地（不是位置参数）- 如果仅邮编在全球范围内给出模糊结果，请包含国家/州
验证
python3 ~/.hermes/skills/maps/scripts/maps_client.py search "Statue of Liberty"
# 应返回纬度 ~40.689，经度 ~-74.044
python3 ~/.hermes/skills/maps/scripts/maps_client.py nearby --near "Times Square" --category restaurant --limit 3
# 应返回时报广场约 500m 范围内的餐厅列表