susi_python定位功能指南:如何借助update_location让AI回答精准匹配你的位置
susi_python定位功能指南:如何借助update_location让AI回答精准匹配你的位置
如果你正在使用 susi_python(SUSI.AI 官方 Python 封装库),却发现问天气、查地点时 AI 的回答总是"对不上号",问题往往出在没有给 AI 设置定位信息。本文带你用 update_location 函数快速配置经纬度与国家参数,只需三步,就能让 AI 回答精准匹配你所在的位置 📍
🎯 为什么定位能让 AI 回答更精准?
SUSI.AI 的服务端是根据请求参数来生成答案的。当你问"今天天气怎么样"时,服务端并不知道你在哪——除非请求里带上经纬度。
susi_python 在 susi_python/main.py 中维护了一个模块级的位置字典:
location = {'latitude': None, 'longitude': None, 'country_name': None, 'country_code': None}
四个字段初始值都是 None,也就是"未定位"状态。调用 update_location 之后,每次提问都会自动携带你的位置信息,AI 才能给出本地天气、周边推荐等贴合实际的答案。
🧩 update_location 的四个参数详解
update_location 的函数签名很简单,一次传齐四个参数即可:
susi.update_location(latitude, longitude, country_name, country_code)
| 参数 | 含义 | 示例 |
|---|---|---|
latitude |
纬度 | 31.2304 |
longitude |
经度 | 121.4737 |
country_name |
国家/地区名称 | "China" |
country_code |
两位国家代码 | "CN" |
函数实现见 susi_python/main.py#L39-L44,它只做一件事:把四个值写入全局 location 字典。
💡 小提示:经纬度建议保留 3~4 位小数(约 10~100 米精度),对天气、地区类技能完全够用;获取坐标可以用任意在线经纬度查询工具,搜索你的城市名即可。
🚀 三步完成定位配置(最快使用步骤)
第 1 步:获取并安装
git clone https://gitcode.com/gh_mirrors/su/susi_python
pip install -r requirements.txt
也可以直接通过 pip install susi_python 安装。核心依赖(requests、geocoder)说明见 requirements.txt。
第 2 步:调用 update_location 设置位置
由于 susi_python/init.py#L9 已把 update_location 导出为包级 API,import 后即可直接调用:
import susi_python as susi
susi.update_location(31.2304, 121.4737, "China", "CN")
第 3 步:提问验证
reply = susi.ask("今天天气怎么样")
print(reply.get('answer'))
如果返回的是上海当地的天气描述,说明定位配置成功 ✅ 完整对话示例可参考 sample.py。
🔍 定位参数如何随每次请求自动发送?
设置好位置后,你无需在每次提问时重复传参。query() 函数(susi_python/main.py#L47-L78)会在组装请求时自动判断:
latitude与longitude均非None→ 追加到请求参数country_name与country_code均非None→ 同样追加到请求参数
此外请求还会自动带上 timezoneOffset(时区偏移)和 device_type,最终发送到 https://api.susi.ai/susi/chat.json 接口。这就是"设一次、处处生效"的原理。
💡 进阶技巧:本地服务与 IP 自动定位
自动切换本地服务:包导入时会执行 check_local_server()(susi_python/main.py#L16-L31),如果检测到本地 localhost:4000 有 SUSI 服务,就自动改用本地端点,无需云网络、隐私更可控。
IP 自动定位:调用 sign_in 登录并注册设备时,add_device 内部会用 geocoder.ip('me') 自动获取当前 IP 的经纬度(susi_python/main.py#L184-L192),省去手动填写的麻烦。
地图答案:当你问"附近的咖啡店"这类问题时,服务端会返回地图动作,susi_python/models.py#L188-L197 中的 Map 模型会据此生成 OpenStreetMap 链接,配合 sample.py#L73-L75 中的输出逻辑即可在终端查看地图。
❓ 常见问题快速解答(FAQ)
Q1:只设置经纬度、不设置国家信息可以吗?
可以。两对参数是独立判断的(见 susi_python/main.py#L56-L62):经纬度成对生效,国家信息成对生效,任意一组缺失都不影响另一组发送。
Q2:定位设置是永久生效的吗?
不是。location 是模块级全局变量,只在当前 Python 进程内有效;程序重启后需再次调用 update_location。
Q3:调用 update_location 会立刻发起网络请求吗?
不会,它只是本地赋值。真正携带位置参数发出请求的时机是每次调用 ask() / query() 时。
Q4:如何验证库安装正常?
可以运行自带的简单测试 tests/test_simple.py,它会对服务端发起一次 hi 提问并断言返回不为空。
总结
susi_python 的 update_location 是让 AI 回答"长在位置上"的关键开关:设置一次经纬度与国家信息,后续所有提问都会自动携带位置参数,天气、地点类技能立刻变得精准可用。配合本地服务自动探测与 IP 自动定位,这套定位机制同样适用于树莓派等智能音箱场景,是打造个性化 SUSI.AI 应用的推荐起点 🎉