请求
# 请求示例(沙箱)
curl -X GET "https://api.example.com/v1/satellite/optical" \
-H "X-API-Key: test_xxxxxxxx" \
-d "bbox=116.20,36.50,116.45,36.65" \
-d "date=2026-10-15" \
-d "cloud_lt=20"
请求参数
| 参数 | 类型 | 必填 | 说明 |
| bbox | string |
是 | 查询范围,WGS84 经纬度,格式 minLon,minLat,maxLon,maxLat |
| date | string |
是 | 成像日期 YYYY-MM-DD;支持日期区间 |
| cloud_lt | int |
否 | 云量上限(百分比),默认 30 |
| resolution | string |
否 | 分辨率,目前支持 10m |
| limit | int |
否 | 返回条数上限,默认 10,最大 100 |
响应
{
"code": 0,
"message": "ok",
"data": {
"scene_id": "OPT-20261015-3714-0088",
"acquired_at": "2026-10-15T02:41:07Z",
"resolution": "10m",
"cloud_cover": 8,
"bbox": [116.20, 36.50, 116.45, 36.65],
"url": "https://.../pre-signed?expires=900"
},
"meta": {
"billing": { "meter": "M2_DATA_VOLUME", "quantity": 1 },
"data_version": "2026-10-15"
}
}
每次响应都会返回本次计量的计量项与数量,便于调用方自行核对用量。