research.md 2.1 KB
技术调研：闪送配送服务
Google 路线距离
采用 Google Routes API v2 的 POST https://routes.googleapis.com/directions/v2:computeRoutes。请求头使用 X-Goog-Api-Key 和 X-Goog-FieldMask: routes.distanceMeters,routes.duration，请求体使用取件、收件经纬度、DRIVE、TRAFFIC_AWARE。参考 Google 官方 Compute Routes、计算路线 和 字段掩码。
闪送与外卖共用字典 sys_googlemap_key，不在闪送响应或日志中输出 Key。该 Key 需启用 Routes API，并在 Google Cloud 配置 API 限制、来源限制和配额。连接/读取超时、HTTP 非成功、JSON 无路线或距离不大于 0 均降级；降级告警仅记录车型和失败原因，不记录地址、坐标或 Key。
降级与精度
外部路线不可用时使用 Haversine 公式计算球面直线距离，四舍五入为整数米并标记 STRAIGHT_LINE；路线成功标记 ROUTE。直线降级仍返回预计时长：机车按 25 km/h、轿车按 30 km/h 计算，结果向上取整且最少 60 秒；这是保守履约展示估算，不参与计价。闪送计价与现有外卖订单保持同一业务规则：按当前时间匹配运价时段，起送距离内收起送价格，超出不足 0.5 公里不加价、0.5 至不足 1 公里按 1 公里计、至少 1 公里按实际超出距离计。距离与单价除法使用 BigDecimal，里程费用使用 HALF_UP 四舍五入为整数新台币；路线预计时长只用于履约展示，不参与金额计算。
并发与安全
- 创建由
(user_id, client_request_id)唯一键最终保证幂等。 - 抢单和状态变更使用条件 UPDATE，不先查后改。
- App 身份只来自
JwtUtil.getusid(token)，骑手额外校验userType=2。 - 平台接口使用
@PreAuthorize；凭证仅接受 HTTP(S) URL。 - 待抢订单通过专用视图脱敏，不直接序列化数据库实体。