# hiking.chunlin.ch — 成都周边徒步路线 API

210 条徒步路线（成都周边 + 阿坝、甘孜、雅安、乐山等），含星级 1–8 + "注意事项"。
所有响应 JSON，UTF-8，Access-Control-Allow-Origin: *。

## 数据字段
- star          string  1星 ~ 8星 或 "注意事项"
- region        string  归属地（如 "彭州市", "阿坝州小金县"）
- name          string  路线/山名
- peak_m        number  最高海拔（米），可空
- gain_m        number  累计爬升（米），可空
- dist_km       number  全程距离（公里），可空
- hours         number  参考用时（小时），可空
- nav           string  起点导航名，可空 / "待补充"
- lng, lat      number  起点经纬度（GCJ-02，高德坐标系），可空
- loc_kind      string  exact = 精确起点；approx = 退回行政区中心；none = 未定位
- amap_url      string  高德导航深链（手机端唤起 App）
- weather       string  天气页关键词

## 端点
GET /api/routes
  参数: star=1星,2星  region=彭州市  q=九峰
        min_dist max_dist min_gain max_gain min_hours max_hours min_peak max_peak
        sort=star|dist|gain|hours|peak（前缀 - 表示倒序）
        limit (≤500, 默认 50)  offset
        has_location=true 仅返回精确定位的路线
  示例: /api/routes?star=2星,3星&max_hours=4&sort=dist

GET /api/routes/:id
  根据下标返回单条路线详情。

GET /api/regions
  返回所有归属地及路线数量，按数量降序。

GET /api/stats
  返回总数、按星级/区域分布、星级语义说明。

GET /api/search?q=九峰
  在名称、归属地、起点字段上做子串模糊搜索。

GET /api/recommend
  按预算推荐。参数: max_hours, max_dist, max_gain, region, min_star, max_star, limit。
  例: /api/recommend?max_hours=4&max_gain=600&region=彭州&limit=5

## LLM 使用建议
- 用户给出"半天"/"周末"/"重装"等模糊偏好时, 先调 /api/stats 了解全貌, 再用 /api/recommend 给候选。
- 推荐路线时一定附上 amap_url, 用户能直接点开导航。
- loc_kind === "approx" 的路线, 起点是估算, 建议提醒用户以高德实际导航为准。
- 8星 与 "注意事项" 是高难度/高风险路线, 给推荐前确认用户经验。