卫星图层
访问限制
本部分 API 属于增值服务，仅提供给企业套餐开发者，如需采购请联系彩云商务
按经纬度、卫星产品和分辨率返回指定时间范围内的卫星图层图片。
请求
http
GET https://api.caiyunapp.com/v1/satellite查询参数
| 参数 | 必填 | 默认值 | 取值范围 | 说明 |
|---|---|---|---|---|
token | 是 | — | — | API 认证凭证，详见 认证与鉴权 |
show_time | 否 | 2 | 1~30 | 获取数据的时间跨度，单位为小时 |
lon | 否 | 中国区域默认经度 | — | 目标经度 |
lat | 否 | 中国区域默认纬度 | — | 目标纬度 |
product | 否 | true_color | true_color/C11/ir108_3d | 卫星产品，各区域支持的取值见下表 |
resolution | 否 | 4000M | 2000M/4000M/8000M | 图片分辨率，各区域支持的取值见下表 |
product 参数
| 区域 | 取值 | 说明 |
|---|---|---|
| 中国 | true_color | 地球真彩色图 |
| 中国 | C11 | 水汽云图 |
| 中国 | ir108_3d | 3D 云图 |
| 北美 | true_color | 地球真彩色图 |
resolution 参数
| 区域 | 取值 | 说明 |
|---|---|---|
| 中国 | 4000M | 4 公里分辨率 |
| 中国 | 8000M | 8 公里分辨率 |
| 北美 | 2000M | 2 公里分辨率 |
| 北美 | 4000M | 4 公里分辨率 |
请求示例
bash
curl "https://api.caiyunapp.com/v1/satellite?token={token}&show_time=2&lon=116.3176&lat=39.9760&product=true_color&resolution=4000M"响应示例
json
{
"status": "ok",
"images": [
[
"http://meteorology.caiyuncdn.com/satellite/prod/fy4b/preprocess/2025/06/23/true_color/4000M/china_DISK_202506230645_202506230659_webmerc.jpg?source=&auth_key=***",
1750661100,
[6, 66, 54, 136]
],
[
"http://meteorology.caiyuncdn.com/satellite/prod/fy4b/preprocess/2025/06/23/true_color/4000M/china_DISK_202506230715_202506230729_webmerc.jpg?source=&auth_key=***",
1750662900,
[6, 66, 54, 136]
]
]
}响应字段
| JSONPath | 类型 | 说明 |
|---|---|---|
$.status | string | 请求状态；成功时为 ok |
$.images | array<array> | 卫星图层图片列表 |
$.images[][0] | string | 图片 URL |
$.images[][1] | number | 图片时间戳 |
$.images[][2] | array<number> | 图片边界，使用 WGS84 经纬度，顺序为 [南纬度, 西经度, 北纬度, 东经度] |