状态：已上线。核心坐标转换与 CAD 几何计算在服务端 Python（pyproj / ezdxf / pyshp），
开放 API 网关以 API Key 鉴权后内部转发，算法与网页版完全一致。
工具简介
坐标处理面向架空输电线路勘测设计：CGCS2000 ↔ WGS84 高斯投影转换、 度带自动判定与长度变形偏差报告、坐标生成 DXF（塔块 / 占地 / 路径多段线）、 占地几何转 KML / Shapefile。
坐标约定：coords=[[x北(northing), y东(easting)]]（米）；easting 含带号时 = 带号×1000000 + 坐标（如 38500000 = 38 带）；
zone 为 CGCS2000 3° 带号（21–53），中央经线 = zone × 3。
接口一览
| 接口 | 作用域 | 入参 | 产出 |
|---|---|---|---|
POST /openapi/v1/cptool/cgcs2wgs | cptool:coord | coords, zone(可空) | JSON [[lon,lat]] 8 位小数 |
POST /openapi/v1/cptool/wgs2cgcs | cptool:coord | coords, zone(可空) | JSON 投影坐标 + deviation 偏差报告 |
POST /openapi/v1/cptool/batch | cptool:coord | coords, from_crs, to_crs, zone | JSON（同上面两个之一） |
POST /openapi/v1/cptool/cgcs2shp | cptool:cad | coords, labels, zone | ZIP（点 + 折线 SHP 五件套） |
POST /openapi/v1/cptool/coord2pline | cptool:cad | sets:[{points:[{label,x,y}]}] | DXF（多段线 + 文字） |
POST /openapi/v1/cptool/coord2dxf | cptool:cad | sets, genkai | DXF（塔块 + 线 + 文字，固定根开缩放） |
POST /openapi/v1/cptool/coord2coverdxf | cptool:cad | sets（每点 genkai） | DXF（占地块，每点独立缩放） |
POST /openapi/v1/cptool/coverdxf2kml | cptool:cad | sets（Y 须含带号） | KML（面 / 线 / 点，已转 WGS84） |
POST /openapi/v1/cptool/coverdxf2shp | cptool:cad | sets（Y 须含带号） | ZIP（面 / 线 / 点三套 SHP） |
每个接口也兼容三段路径 /openapi/v1/cptool/coord/<action>（与网页端 /cptool/api/coord/… 结构对齐），两种写法等价。
示例 1：投影坐标 → 经纬度
curl -X POST "https://tool.0cai.net/openapi/v1/cptool/cgcs2wgs" \
-H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
-d '{"coords":[[500000,38500000],[600000,38500000]],"zone":38}'
# → {"success":true,"count":2,
# "result":[[114,4.52175323],[114,5.42605426]],"zone":38,"request_id":"…"}
示例 2：经纬度 → 投影坐标（带偏差报告）
curl -X POST "https://tool.0cai.net/openapi/v1/cptool/wgs2cgcs" \
-H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
-d '{"coords":[[114.0,4.52],[114.5,5.0]]}'
# → {"success":true,"zone":38,
# "result":[[499806.1254,38500000,38],[552906.5385,38555450.0509,38]],
# "deviation":{"cm":114,"max_dlon_deg":0.5,"max_k":1.000038,
# "distortion_m_per_km":0.0378,"avg_k":1.000013,…}}
deviation 为高斯投影长度变形报告：离中央经线越远变形越大，distortion_m_per_km 表示每公里长度变形（米），
超差时建议更换度带（指定更接近的 zone）。
示例 3：坐标 → 塔块 DXF（二进制下载）
curl -X POST "https://tool.0cai.net/openapi/v1/cptool/coord2dxf" \
-H "Authorization: Bearer YOUR_KEY" -H "Content-Type: application/json" \
-d '{"sets":[{"points":[
{"label":"1","x":500000,"y":38500000},
{"label":"2","x":500100,"y":38500100}]}],
"genkai":6}' -o towers.dxf
文件类接口（cgcs2shp / coord2* / coverdxf2*）不走 JSON 信封，直接返回文件流，
响应头带 Content-Type（application/dxf · application/zip · application/vnd.google-earth.kml+xml）、
Content-Disposition（附件文件名）以及通用的 X-RateLimit-* / X-Request-Id，配额与日志正常记录。
常见错误
| HTTP | error | 原因 |
|---|---|---|
| 400 | — | 参数缺失/坐标格式错误；单点错误以 result[i].error 逐点返回 |
| 400 | coord_invalid_coords | 坐标值超出有效范围（经度 -180~180、纬度 -90~90；投影坐标核对 X/Y 与带号） |
| 400 | — | coverdxf2kml/shp：Y 坐标缺少带号前缀或带号不一致 |
| 502 | coord_backend_unreachable | 坐标服务暂不可用，可稍后重试 |
性能提示：CAD 类接口涉及文件生成，建议客户端超时 ≥ 30s；大批量坐标建议合并为一次请求，而不是循环单点调用。
