星图云开放平台
马来西亚小时预报数据
更新时间:2025-11-06 15:41:59
接口说明

本接口提供马来西亚槟城范围的高时空分辨率小时级天气预报产品。基于生成式AI技术,将前沿的气象预测大模型与传统的数值预报模型相结合,生成一套具有局部精细化程度高、时空分辨率高、更新频率高的气象预报服务产品。提供精准的未来5天逐小时天气趋势预测,助力用户实现天气感知、科学决策。
要素包括:温度、U、V、1小时累计降水量、降水概率。
空间范围:马来西亚槟城(100.1~100.6°E,5.1~5.6°N)
时间范围:查询时间当天至未来5天
时间分辨率:1小时
更新频次:2次/天(08和20-北京时)
空间分辨率:5km

调用方式

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

服务地址https://api.open.geovisearth.com/pj/grid/v1/listNewestForecastData
请求方式GET 方法
接口鉴权服务密钥授权,您需要 申请 token将 token 作为必填参数拼接在服务地址中一起请求
调用限制服务调用量的限制请点击 这里 查阅
请求参数
参数名含义规则数据是否必填缺省值
location经纬度数据,经度和纬度用英文逗号分隔double[]/
meteCodes查询的要素集合,要素代码见下方表格string[]/
start查询开始时间string/
end查询结束时间string/

 

 

 

 

 

 

 

 

 

meteCodes要素代码表

要素代码要素说明
pop降雨概率(0-1)
tmp温度(°C)
tp1H降雨量(mm)
wind_spd_1010m风速
u10data10mU风
v10data10mV风
返回参数
参数名类型说明
statusint状态码,非0表示没有正常获取到数据
timeString请求时间,格式:yyyyMMddHHmmss
startString查询开始时间
endString查询结束时间
sizeint返回的数据时次数
meteCodesString[]查询的要素集合
datasObject[]数据集合
fc_timeString数据时间,格式:yyyyMMddHHmmss(北京时)
valuesdouble[]数据结果集合,顺序和meteCodes请求内容对应
调用示例

请求示例

https://api.open.geovisearth.com/pj/grid/v1/listNewestForecastData?location=100.2,5.6&start=2025090421&end=2025090521&meteCodes=tp,tmp,pop,wind_spd_10,u10data,v10data&token=您的token

返回示例

{
  "status": 0,
  "version": "v1",
  "date": {
    "time": "20250904132904",
    "timeZone": "Asia/Shanghai"
  },
  "result": {
    "start": "2025-09-04 21:00:00",
    "end": "2025-09-05 21:00:00",
    "size": 25,
    "meteCodes": [
      "tp",
      "tmp",
      "pop",
      "wind_spd_10",
      "u10data",
      "v10data"
    ],
    "datas": [
      {
        "fc_time": "2025-09-04 21:00:00",
        "values": [0, 31.005, 0, 2.489, -0.654, -2.402]
      },
      {
        "fc_time": "2025-09-05 19:00:00",
        "values": [0, 31.267, 0, 2.722, 1.857, -1.99]
      },
      {
        "fc_time": "2025-09-05 20:00:00",
        "values": [0, 31.02, 0, 2.419, 1.472, -1.92]
      },
      {
        "fc_time": "2025-09-05 21:00:00",
        "values": [0, 30.792, 0, 2.451, 1.215, -2.128]
      }
    ]
  }
}