一、这个功能能做什么
物流轨迹与地址服务分开设置。瓜奇 → 第三方 → 快递查询接口 按前端维护；综合的全局第三方物流能力与地址数据用于共享基础能力。
先认识这几个词
- API Key：访问某项服务的凭据，也称 API 密钥；应填入对应服务的设置中并妥善保管。
- 前端：访客实际打开和使用的网站；同一后台可以对应多个前端网址。
逐项设置与效果
| 设置 | 功能与效果 |
|---|---|
| 高德地址服务 | 配置 Web 服务 Key，服务适用地址功能 |
| Google 地图服务 | 配置 API Key 与适用代理地址 |
| 阿里云地址标准化 | 配置对应账号与应用凭据，使用支持的地址处理 |
| 国家地址基础信息 | 管理国家名称、图标、地名编号、国际电话区号与国家代码 |
| 物流查询开关 | 决定是否启用相应快递轨迹查询 |
| 物流平台、密钥与地址 | 连接适用轨迹服务 |
| 轨迹语言、超时、缓存 | 按业务需要配置返回语言和查询方式 |
| 运单与发货记录 | 保存物流公司、运单号与适用订单发货状态 |
二、设置后会有什么效果
可以在订单中展示运单信息并查询轨迹，使用地址服务辅助选择省市区和填写地址。地图与快递查询分别配置。
三、怎么使用
快递轨迹
当前面板默认且仅提供 51Tracking。开启轨迹查询，填写该账户的 API Key，通常保留默认 V4 查询地址。关闭后仍可显示物流公司和运单号，但不调用第三方轨迹接口。
查询前确认订单已保存有效物流公司和运单号。保存物流、标记发货和确认货到付款尾款是不同动作，轨迹查询成功不代表尾款到账。
地址与地图
高德 Key 用于中国省市区级联、地址联想和逆地理，应申请 Web 服务 类型，供后端使用。按高德官方创建应用和 Key进入应用管理、创建应用、添加 Web 服务 Key，再填回瓜奇。不要填 JS API 或移动端 Key。
海外地址另有基础数据下载入口。缺少城市选项时，先区分国内地图服务和海外数据，再检查对应服务或数据是否就绪。
切换页面语言不会自动改变物流公司编码，也不会自动翻译收货人填写的地址。跨前端排查轨迹时，核对该前端是否配有查询凭据。
完成配置并检查结果
先核对地址和地图的实际服务配置；快递查询在「瓜奇 → 第三方 → 快递查询接口设置」中配置。快递查询目前提供 51Tracking：填写 API Key，通常保留默认 API 地址，选择返回语言，再调整请求超时与缓存时长。默认超时 15 秒、缓存 600 秒。随后在订单中填写正确物流公司和运单号，打开订单详情核对轨迹。地图服务和快递轨迹是两个独立用途，按需要分别接入。
四、常见问题
常见问法与直接答案
高德地图 Key 选什么类型？
选择 Web 服务类型，供后端进行行政区域查询、地址联想与逆地理处理。不要填写 JS API、Android 或 iOS 的 Key；海外地址选择还涉及另一套基础数据。
更多使用问题
关闭快递查询后订单会没有运单号吗？
关闭后仍可展示物流公司和运单号，只是不调用第三方轨迹查询。
物流公司已更新轨迹，网站为什么稍晚才变化？
同一运单在缓存有效期内优先使用已有结果。检查缓存时长及第三方返回情况，不要反复修改订单号。
切换页面语言会自动切换物流轨迹语言吗？
轨迹返回语言有独立选项，需同时核对该设置与服务返回内容。