qipai/docs/api-changelog/2026-06-18-M03-C-store-discovery.md

M03-C 地图选店与距离 API

GET /app-api/stores

请求头：

• x-wechat-appid
• 多租户 AppID 时提供 tenant-id

筛选参数：

• city
• businessStatus
• openNow=true|false
• latitude + longitude
• maxDistanceMeters

经纬度必须成对提供。距离由后端使用 Haversine 公式计算并排序，客户端不能提交或覆盖距离值。未授权定位时可仅传城市进行手工选店。

营业中状态按门店时区、业务状态和每周营业时间计算，支持跨午夜营业时间。