SuperAPI AI 工具集

maps

通用与其它

查看项目

更新于 10-16 07:15

技能介绍

该技能提供基于开放数据的位置智能,数据来源为 OpenStreetMap/Nominatim、Overpass API、OSRM 和 TimeAPI.io。零依赖,仅用 Python 3.8+ 标准库,无需 pip 安装或 API 密钥。脚本路径为 ~/.hermes/skills/maps/scripts/maps_client.py,常设变量 MAPS=~/.hermes/skills/maps/scripts/maps_client.py。

主要用途与命令:search 将地名或地址地理编码为经纬度、显示名、类型、边界框和重要度;reverse 将经纬度反查完整地址;nearby 按类别查找附近地点,支持坐标或 --near 自动地理编码、--radius、--limit 及多类别合并,共约 46 个类别(如 restaurant、cafe、hospital、hotel 等),结果含名称、地址、距离、地图链接、路线链接及营业时间、电话、网站等标签;distance 计算两点间驾车、步行或骑行距离与耗时,需用 --to 指定目的地;directions 提供逐步导航,含指令、距离、耗时、道路名和动作类型;timezone 根据坐标返回时区名、UTC 偏移和当前当地时间;area 返回地点的边界框、宽高和近似面积;bbox 在矩形范围内搜索 POI。

典型用法:用户发送 Telegram 位置图钉时,从消息中提取 latitude 和 longitude,传入 nearby;例如 python3 $MAPS nearby 36.17 -115.14 cafe --radius 1500。查找“罗马斗兽场附近意大利餐厅”可执行 nearby --near "Colosseum Rome" --category restaurant --radius 500。步行路线用 directions "Hotel Name" --to "Conference Center" --mode walking。

限制与注意事项:Nominatim 使用条款限制每秒最多 1 次请求,脚本自动处理;nearby 必须提供坐标或 --near;OSRM 路径覆盖以欧洲和北美最佳;Overpass API 高峰时段可能较慢,脚本会在镜像间自动回退;distance 与 directions 的目的地需用 --to 而非位置参数;单独邮编可能全局歧义,建议加国家或州。OSM 营业时间由社区维护,可能不是最新,回答“现在是否营业”时若字段缺失或不明确应另行核实。技能替代旧版 find-nearby,原功能均由 nearby 覆盖并保留 --near 快捷方式与多类别支持。