先分清地址服务和快递查询
地址服务用于选择地区、联想地址或处理地址数据；快递查询用于查看运单轨迹。两者需要分别配置。
快递查询位于「瓜奇 → 第三方 → 快递查询接口设置」，按前端分别维护。这里的「前端」指访客使用的网站，同一后台可以对应多个网站。全站共享的地址和地图能力在「综合」的全局第三方设置中维护。
开始前，准备对应服务的账号和 API Key，并使用有权管理后台设置的账号操作。API Key 是服务凭据，应填写到指定设置中。
配置快递轨迹查询
- 切换到需要使用物流查询的前端设置。
- 开启快递轨迹查询，选择当前支持的 51Tracking。
- 填写该服务账号生成的 API Key，通常保留默认 V4 查询地址。
- 选择返回语言，检查请求超时和缓存时长，保存设置。
| 设置 | 作用与默认值 |
|---|---|
| 查询开关 | 关闭后不调用第三方轨迹接口，订单仍可展示已保存的物流公司和运单号。 |
| 物流平台 | 当前面板仅支持 51Tracking。 |
| API Key | 填写 51Tracking 控制台生成的密钥。 |
| API 地址 | 使用默认 V4 查询地址即可，只有明确需要时才修改。 |
| 返回语言 | 可选简体中文或 English，默认简体中文。 |
| 请求超时 | 默认 15 秒，用于限制等待第三方接口响应的时间。 |
| 轨迹缓存时长 | 默认 600 秒。同一运单在缓存有效期内优先使用已有结果；设为 0 时不使用这项缓存。 |
配置地址与地图服务
高德地址服务
高德 Key 用于中国省市区级联、地址联想和逆地理查询，需要申请供后端使用的 Web 服务类型。
按高德官方创建应用和 Key说明进入应用管理，创建应用并添加 Web 服务 Key，再填回瓜奇。不要使用 JS API、Android 或 iOS 类型的 Key。
Google 地图与阿里云地址标准化
需要使用 Google 地图服务时，填写对应 API Key，并按实际网络情况配置代理地址。
需要使用阿里云地址标准化时，开启该服务，填写 AccessKey ID、AccessKey Secret 和项目 AppKey。接口地址通常保留默认值；出现无法解析主机的错误时，先检查服务器 DNS 和网络。
国家与海外地址数据
国家地址基础信息包含名称、图标、地名编号、国际电话区号和国家代码。海外地址还涉及基础数据下载，应先准备好对应数据。
缺少省市或城市选项时，先判断是国内高德服务问题，还是海外地址数据尚未就绪。切换页面语言不会自动翻译客户填写的地址，也不会改变物流公司编码。
分别验证地址和物流
- 打开网站的地址填写页面，测试国内省市区选择、地址联想，以及实际需要的海外地址。
- 在测试订单中保存正确的物流公司和运单号。
- 打开订单详情的物流轨迹页，核对公司、运单号、轨迹内容和返回语言。
- 如果有多个前端网站，分别验证各自的查询凭据。
保存物流信息、标记发货和确认货到付款尾款是不同操作。查询到物流轨迹，不能作为尾款已经到账的依据。
轨迹没有及时更新怎么办
先检查是否仍在缓存期内，再检查第三方平台返回的内容。不要为了刷新轨迹反复修改运单号。
轨迹语言有独立设置，不能只根据页面语言判断。如果关闭了查询开关，订单只展示物流公司和运单号，也属于正常结果。