星图云开放平台-以卫星遥感为核心的空天信息服务开放平台

小时预报图层未来时间区间查询

更新时间：2026-01-09 16:52:09

接口说明

根据传入的查询小时数，查询从当前小时开始往后对应的小时预报图层信息。

调用方式

使用 API 前，需要先注册账号并完成用户认证，查看开发指南

服务地址	https://api.open.geovisearth.com/pj/v1/customized/view/forecast/img/cast
请求方式	GET 方法
接口鉴权	服务密钥授权，您需要申请 token，将 token 作为必填参数拼接在服务地址中一起请求
调用限制	服务调用量的限制请点击这里查阅

请求参数

参数名	数据类型	是否必传	默认值	描述说明
hours	int	否	72	当前整点往后查询的小时数，不传默认为：72
meteCode	String	是	无	见下面meteCode参数说明

meteCode列表

要素名	要素含义	单位
prs	地面气压	hPa
rh	相对湿度	%
tcc	总云量	%
tmp	温度	℃
ws	风速	m/s
vis	能见度	m
cp	对流性降水	mm/h
snow_fall	降雪	mm/h

返回参数

参数名	类型	描述信息	异常值
status	int	状态码，非0表示没有正常获取到数据	无
version	String	版本	无
date	String	服务时间，与timeZone对应。数据格式：yyyyMMddHHmmss	无
bbox	Object	图层url的host	无
layers	Object	图层信息	无
timeSeries	String[]	时间序列	无
imgSeries	String[]	图层序列，与timeSeries对应
real_tem_f	double	体感温度，华氏度

调用示例

请求示例

https://api.open.geovisearth.com/pj/v1/customized/view/forecast/img/cast?meteCode=tmp&token=您的token

返回示例

{
    "status": 0,
    "version": "v1",
    "date": {
        "time": "20260107102421",
        "timeZone": "Asia/Shanghai"
    },
    "result": {
        "host": "http://127.0.0.1:9142",
        "bbox": {
            "minlon": 70.05,
            "maxlon": 140.0,
            "minlat": 15.05,
            "maxlat": 60.0
        },
        "layers": {
            "timeSeries": [
                "2026010710",
                "2026010711",
                "2026010712",
                "2026010713",
                "2026010714",
                "2026010715",
                "2026010716",
                "2026010717",
                "2026010718",
                "2026010719",
                "2026010720",
                "2026010721",
                "2026010722",
                "2026010723",
                "2026010800",
                "2026010801",
                "2026010802",
                "2026010803",
                "2026010804",
                "2026010805",
                "2026010806",
                "2026010807",
                "2026010808",
                "2026010809",
                "2026010810",
                "2026010811",
                "2026010812",
                "2026010813",
                "2026010814",
                "2026010815",
                "2026010816",
                "2026010817",
                "2026010818",
                "2026010819",
                "2026010820",
                "2026010821",
                "2026010822",
                "2026010823",
                "2026010900",
                "2026010901",
                "2026010902",
                "2026010903",
                "2026010904",
                "2026010905",
                "2026010906",
                "2026010907",
                "2026010908",
                "2026010909",
                "2026010910",
                "2026010911",
                "2026010912",
                "2026010913",
                "2026010914",
                "2026010915",
                "2026010916",
                "2026010917",
                "2026010918",
                "2026010919",
                "2026010920",
                "2026010921",
                "2026010922",
                "2026010923",
                "2026011000",
                "2026011001",
                "2026011002",
                "2026011003",
                "2026011004",
                "2026011005",
                "2026011006",
                "2026011007",
                "2026011008",
                "2026011009",
                "2026011010"
            ],
            "imgSeries": [
                "/v1/customized/view/cloud/9f44f04564b44804658a0c27090545c4.png",
                "/v1/customized/view/cloud/625f21c92664a18ca90c1061ef3c9b12.png",
                "/v1/customized/view/cloud/f3978db75a22421b8ba09b86e18bad67.png",
                "/v1/customized/view/cloud/38a1dd7c1cfd1c0420b0af86f5f5de19.png",
                "/v1/customized/view/cloud/17ef2f1ce9db23423d1253614fa73ac8.png",
                "/v1/customized/view/cloud/deb4141c64572e4e108449a67dc877f1.png",
                "/v1/customized/view/cloud/0742da511ddfcdf249bf981fb27dfe17.png",
                "/v1/customized/view/cloud/3346a02d2b06701649ff340d298c3d5e.png",
                "/v1/customized/view/cloud/4898743ea3049e36a2ba6c20ce134505.png",
                "/v1/customized/view/cloud/0cc23d8938192a91df009d31bbcee2a3.png",
                "/v1/customized/view/cloud/b9195e48f2f625e2d5cb5f6269d0fe91.png",
                "/v1/customized/view/cloud/c9ed220d80e47a95bf2f553adf4ccd03.png",
                "/v1/customized/view/cloud/a18fd5887e384b2b24afae424b826cb5.png",
                "/v1/customized/view/cloud/f15ea91000192d81cbb66b68ab585b4e.png",
                "/v1/customized/view/cloud/be5382fc242e643d2ed11cb084e9fd58.png",
                "/v1/customized/view/cloud/ce2b7a13b2e51818d4bfd1bacb1ab2c9.png",
                "/v1/customized/view/cloud/92210bef6c7bdabca15459ba05e5fd45.png",
                "/v1/customized/view/cloud/88fa3ae70f8739270bf650b162cd6f81.png",
                "/v1/customized/view/cloud/73a4ceb65b782d3b2956a0e59f6b9efe.png",
                "/v1/customized/view/cloud/8839df140919585be003b3615dcaf5b0.png",
                "/v1/customized/view/cloud/f44780685364f64d2e02a5c491ebf3d2.png",
                "/v1/customized/view/cloud/ea5316cf8d0f37bdfff2a0b65c0bb9f3.png",
                "/v1/customized/view/cloud/d86449fed6da8ec03d59b28f69dbcbb1.png",
                "/v1/customized/view/cloud/856f20fec942b2eb1e1d89a7000ac6d4.png",
                "/v1/customized/view/cloud/b00669d4c9de09d9f7d277805a431b43.png",
                "/v1/customized/view/cloud/fbd8b1b20b8a1a2dd0da756a54e5ffa6.png",
                "/v1/customized/view/cloud/ed05e61318e8a97955fb55be5a735d31.png",
                "/v1/customized/view/cloud/29579ac9af60b0394b2290ffff42267a.png",
                "/v1/customized/view/cloud/3e8116bfd843455e858adf8b46241bdd.png",
                "/v1/customized/view/cloud/d1c3d261e265151eb676d2b6d9120a75.png",
                "/v1/customized/view/cloud/40585f1d754772f4ee0444834e000cd3.png",
                "/v1/customized/view/cloud/030d24d38bda365d5d35c36b314e4a9f.png",
                "/v1/customized/view/cloud/accda6f434ca14afa2ab6181e93f43e2.png",
                "/v1/customized/view/cloud/36f60f8ab3ad762b0d001416093b1037.png",
                "/v1/customized/view/cloud/6587c74216baced87c7ee024d7889e5c.png",
                "/v1/customized/view/cloud/d6b750a60f967b8c9cb8392274b1fdf9.png",
                "/v1/customized/view/cloud/3f3d40b124c88dee2f9d48066db00080.png",
                "/v1/customized/view/cloud/bde08ab9de2d9cd674ea4d31872a0442.png",
                "/v1/customized/view/cloud/1de5ae82e2fe98b2bf86dd544db5e94d.png",
                "/v1/customized/view/cloud/6d3b8e883dab3dc3df1e99ae57d12b0b.png",
                "/v1/customized/view/cloud/adeaf738f8f2aa2274a3f6ca1ebb579d.png",
                "/v1/customized/view/cloud/758b4f8a16ae55289c64317cc21f7897.png",
                "/v1/customized/view/cloud/5216c59a84e5807e108c8dc62911b963.png",
                "/v1/customized/view/cloud/47247aa33bbf711f2f29256f7a454a50.png",
                "/v1/customized/view/cloud/2146a412284e8be3cd33bac53d892119.png",
                "/v1/customized/view/cloud/9092f85770f1fdeb847ee32daa408efd.png",
                "/v1/customized/view/cloud/c37fd4609d2f21adb693fdaa2fe41151.png",
                "/v1/customized/view/cloud/47e2ab942ba2c2eed832e98f9e8da3a4.png",
                "/v1/customized/view/cloud/189ab8c079f8ec504175e97d61ebe3d9.png",
                "/v1/customized/view/cloud/9ede0cf6f04383463c39dfa8585df89a.png",
                "/v1/customized/view/cloud/08215d87576497b53377d2b168f1c3ad.png",
                "/v1/customized/view/cloud/10f85a5f025b2a74b901ad2c6965d2ff.png",
                "/v1/customized/view/cloud/f2a3d723c7a5ddc9edcf0eeb6c89afd2.png",
                "/v1/customized/view/cloud/93ea69549e1b56720de5ff0281efb729.png",
                "/v1/customized/view/cloud/7d75cb7a8807a16233d34959311a1479.png",
                "/v1/customized/view/cloud/861f065621f95ef45d4879286c7f0156.png",
                "/v1/customized/view/cloud/b9c403278f58a334bb5ad937127b9870.png",
                "/v1/customized/view/cloud/e0586931b5abed0453e8cc05e2ba3b36.png",
                "/v1/customized/view/cloud/ac64b4f42f982e4a16e24e65a008a25b.png",
                "/v1/customized/view/cloud/b5d63d7dcf64b231ccc74673735215e9.png",
                "/v1/customized/view/cloud/aebe1cbdb1c50b1c07b0e6daa2fba7e7.png",
                "/v1/customized/view/cloud/0b9d06d690e6e22f33efcb4900ea9fed.png",
                "/v1/customized/view/cloud/266530cb2f0b94c29b277d3a40d7e6d5.png",
                "/v1/customized/view/cloud/a6322fda0081b446e4f325a26732d907.png",
                "/v1/customized/view/cloud/2d75bb5c2f9a92f68fcc9629ba85093f.png",
                "/v1/customized/view/cloud/c491199576c7928bcc2defbab97a63d7.png",
                "/v1/customized/view/cloud/42be8fb7fcfed4108923608669271cc5.png",
                "/v1/customized/view/cloud/ef3d481e1ad0e4f75f368ecfd5c84d41.png",
                "/v1/customized/view/cloud/bd4f6a12dd3dc981837f0febf094290f.png",
                "/v1/customized/view/cloud/483b6dcae8ec07c9b11be122c812a445.png",
                "/v1/customized/view/cloud/c63e95ddb3845bb82cc6fad11f955555.png",
                "/v1/customized/view/cloud/df2d54041935a441bbdb1646908d675f.png",
                "/v1/customized/view/cloud/3c8a4486c765e5cca59589fbc5aabfca.png"
            ]
        }
    }
}