QUICK START

接入分析服务

两个端点返回相同的分析结构。产品标题、离散图例或地图配准不可靠时，服务会整体失败，不输出猜测结果。

打开交互式文档

请求示例

选择一种图片输入方式

当前服务地址 http://127.0.0.1:8000

请求方法POST

响应格式application/json

城市数量恰好 16 市

上传本地图片

curl -F "file=@weather.jpg" \
  http://127.0.0.1:8000/api/v1/analyze

请求格式为 multipart/form-data，文件字段名为 file，单图最大 15 MB。

提交图片 URL

curl -X POST http://127.0.0.1:8000/api/v1/analyze-url \
  -H "Content-Type: application/json" \
  -d '{"url":"https://image.nmc.cn/product/example.png"}'

URL 必须使用 HTTPS 且主机位于服务端允许列表；默认允许 image.nmc.cn。

公开接口

仅保留两个分析端点

POST /api/v1/analyze

上传带离散图例的中国地图，返回 16 市覆盖结果、图例和地图叠加变换。

请求: multipart/form-data
失败: 422 / 413 · 稳定错误结构

POST /api/v1/analyze-url

传入 {"url":"https://..."}，下载受信任图片并执行相同分析，不要求产品预先入库。

请求: application/json
失败: 422 / 413 · 稳定错误结构

响应结构节选

{
  "product": "全国强降雨落区预报图",
  "recognition_mode": "catalog",
  "cities": [
    {
      "city": "济南市",
      "affected": true,
      "coverage_ratio": 0.1815,
      "detail": { "max_level": "大雨", "dominant_level": "大雨" }
    }
  ],
  "legend": [...],
  "visualization": {...}
}

结果表示输入预报图的覆盖，不代表灾害已经发生。覆盖比例严格大于 3% 才标记为受影响。