hl-api-changelog/changelogs/2026-04/2026-04-13_product-v2_calculate_mileage_api.md

产品v2 - 新增自动计算行程总里程接口

日期: 2026-04-13 服务: product-service-v2 类型: 新增接口 PR: #431

---

新增接口

GET /admin/product/item/{productId}/calculate-mileage

根据行程途经点坐标，调用高德驾车路线规划API自动计算总驾驶里程。

前提条件: 产品必须已保存行程(Step2)，且行程中至少有2个有效途经点（有经纬度坐标）。

请求参数: 无（productId在路径中）

返回示例:

{
  "code": 200,
  "data": 1234.5,
  "msg": "success"
}

字段	类型	说明
data	BigDecimal	总里程(km)，保留1位小数

错误情况:

• 行程途经点不足2个：返回错误提示
• 高德API调用失败：返回错误提示

使用场景

Step3"路线与备品"页面，前端可调用此接口获取自动计算的里程值，填充到"总里程"输入框中。

建议交互:

• 进入Step3时，若总里程为空，自动调一次此接口获取里程
• 提供"自动计算"按钮，点击时调用此接口刷新里程值
• 用户仍可手动修改覆盖自动计算的值

同时修复

行程酒店名快照补全

Step2行程保存时，如果住宿节点(accommodations)传了resourceId但没传hotelName，后端会自动通过Feign查询酒店名称填充。前端无需改动。

Step1 支付字段恢复

POST /admin/product/item/basic 请求体恢复以下字段：

字段	类型	说明
paymentType	String	支付方式(字典payment_type: FULL=全款, DEPOSIT=订金+尾款)
depositRatio	BigDecimal	订金比例(0-100)，paymentType=DEPOSIT时必填
depositDeadlineDays	Integer	尾款截止天数(出发前N天)，paymentType=DEPOSIT时必填