### [06.03.040 配置物流地图和地址服务](https://guaqi.com/docs/77615)

**Published:** 2026-09-11T02:28:40

**Author:** 二丿小青年

**Excerpt:** 一、这个功能能做什么 物流轨迹与地址服务分开设置。 瓜奇 → 第三方 → 快递查询接口 按前端维护；综合的全局…

[06 商品与交易](/docs-archive/1254) / [06.03 交付与订单](/docs-archive/1257)

## 一、这个功能能做什么

物流轨迹与地址服务分开设置。**瓜奇 → 第三方 → 快递查询接口** 按前端维护；综合的全局第三方物流能力与地址数据用于共享基础能力。

### 先认识这几个词

-   **API Key**：访问某项服务的凭据，也称 API 密钥；应填入对应服务的设置中并妥善保管。
-   **前端**：访客实际打开和使用的网站；同一后台可以对应多个前端网址。

### 逐项设置与效果

| 设置  | 功能与效果 |
| --- | --- |
| 高德地址服务 | 配置 Web 服务 Key，服务适用地址功能 |
| Google 地图服务 | 配置 API Key 与适用代理地址 |
| 阿里云地址标准化 | 配置对应账号与应用凭据，使用支持的地址处理 |
| 国家地址基础信息 | 管理国家名称、图标、地名编号、国际电话区号与国家代码 |
| 物流查询开关 | 决定是否启用相应快递轨迹查询 |
| 物流平台、密钥与地址 | 连接适用轨迹服务 |
| 轨迹语言、超时、缓存 | 按业务需要配置返回语言和查询方式 |
| 运单与发货记录 | 保存物流公司、运单号与适用订单发货状态 |

## 二、设置后会有什么效果

可以在订单中展示运单信息并查询轨迹，使用地址服务辅助选择省市区和填写地址。地图与快递查询分别配置。

## 三、怎么使用

### 快递轨迹

当前面板默认且仅提供 51Tracking。开启轨迹查询，填写该账户的 API Key，通常保留默认 V4 查询地址。关闭后仍可显示物流公司和运单号，但不调用第三方轨迹接口。

查询前确认订单已保存有效物流公司和运单号。保存物流、标记发货和确认货到付款尾款是不同动作，轨迹查询成功不代表尾款到账。

### 地址与地图

高德 Key 用于中国省市区级联、地址联想和逆地理，应申请 **Web 服务** 类型，供后端使用。按高德官方[创建应用和 Key](https://lbs.amap.com/api/webservice/create-project-and-key)进入应用管理、创建应用、添加 Web 服务 Key，再填回瓜奇。不要填 JS API 或移动端 Key。

海外地址另有基础数据下载入口。缺少城市选项时，先区分国内地图服务和海外数据，再检查对应服务或数据是否就绪。

切换页面语言不会自动改变物流公司编码，也不会自动翻译收货人填写的地址。跨前端排查轨迹时，核对该前端是否配有查询凭据。

### 完成配置并检查结果

先核对地址和地图的实际服务配置；快递查询在「瓜奇 → 第三方 → 快递查询接口设置」中配置。快递查询目前提供 51Tracking：填写 API Key，通常保留默认 API 地址，选择返回语言，再调整请求超时与缓存时长。默认超时 15 秒、缓存 600 秒。随后在订单中填写正确物流公司和运单号，打开订单详情核对轨迹。地图服务和快递轨迹是两个独立用途，按需要分别接入。

## 四、常见问题

### 常见问法与直接答案

#### 高德地图 Key 选什么类型？

选择 Web 服务类型，供后端进行行政区域查询、地址联想与逆地理处理。不要填写 JS API、Android 或 iOS 的 Key；海外地址选择还涉及另一套基础数据。

### 更多使用问题

**关闭快递查询后订单会没有运单号吗？**

关闭后仍可展示物流公司和运单号，只是不调用第三方轨迹查询。

**物流公司已更新轨迹，网站为什么稍晚才变化？**

同一运单在缓存有效期内优先使用已有结果。检查缓存时长及第三方返回情况，不要反复修改订单号。

**切换页面语言会自动切换物流轨迹语言吗？**

轨迹返回语言有独立选项，需同时核对该设置与服务返回内容。



---