阿里云首页 数字地球引擎

天气实况-历史

本文介绍如何通过数字地球引擎 Java SDK调用Historical方法获取数据。

前提条件

请仔细阅读通用流程文档中相关内容,了解代码操作步骤。

接口说明

接口说明:气象实况按站点查询五年某时历史数据

空间分辨率:按站点

时间分辨率:历史5年内

通用请求参数

名称

类型

示例值

描述

OrderId

String

aliyunape_meteor12_public_cn-*********

查看订单

Endpoint

String

aliyunape.aliyuncs.com

固定值,请勿修改为其他值

AccessKeyId

String

LT************C

用于标识用户

AccessKeySecret

String

k9*******************el

用于验证用户的密钥,必须保密

注意

以上提供的参数是针对数字地球引擎下所有产品都会用到的参数。

请求参数

参数名

是否必需

说明

备注

station

站点

54836

全国(入参单一站点)

pageSize

页面条数

1

x条数据

pageNum

页码数

1

第1页

startTime

开始时间

20210909080000

yyyymmddhh0000(当startTime为空时无数据产出,确认是否入参)

endTime

结束时间

20210909080000

yyyymmddhh0000 (当endTime为空时无数据产出,确认是否入参)

代码示例

import com.aliyun.aliyunape20210908.Client;
import com.aliyun.aliyunape20210908.models.HistoricalRequest;
import com.aliyun.aliyunape20210908.models.HistoricalResponse;
import com.aliyun.teaopenapi.models.Config;

public class Historical {
    /**
     * 天气实况-历史(SK-ls-sj)
     * 按站点查询历史数据
     * 历史5年,逐小时
     * @param
     * @return
     */
    public static void main(String[] args) {

        HistoricalRequest request = new HistoricalRequest();
        request.setOrderId("aliyunape_meteor12_public_cn-********");
        request.setStation("54594");  //站点
        request.setStartTime("20211010080000");  //开始时间,格式为yyyymmddhh0000
        request.setEndTime("20211011080000");  //结束时间,格式为yyyymmddhh0000
        request.setPageSize(1);  //页面条数
        request.setPageNum(1);  //页码数

        Config config = new Config();
        config.setEndpoint("aliyunape.aliyuncs.com");
        config.setAccessKeyId("LT**********LC");
        config.setAccessKeySecret("j***************SI");

        try {
            Client client = new Client(config);
            HistoricalResponse response = client.historical(request);

            System.out.println("code:" + response.getBody().code);
            System.out.println("message:" + response.getBody().message);
            System.out.println("requestId:" + response.getBody().requestId);
            System.out.println("success:" + response.getBody().success);
            System.out.println("data:" + response.getBody().data);

        } catch (Exception e) {
            e.printStackTrace();
        }

    }
}

示例结果

code:200
message:操作成功
requestId:EDBACEE7-A25F-5577-8C9D-549725DF83E4
success:true
data:[{prs_sea=1027.0, max_prs=1022.3, min_rhu_otime=2332.0, max_win_s_inst_6h=14.0, pagenum=1, avg_win_d_2mi=318, max_win_s=5.8, station_levl=13, max_win_d_inst=335.0, dt=20211010, max_tem=15.4, province=110000, min_tem_24h=12.0, pre_6h=0.0, tem=15.1, max_win_d_inst_12h=335.0, pre=999999.0, vap=4.5, pre_3h=0.0, station_id=54594, area_code=110115, min_prs=1021.5, avg_win_s_10mi=4.8, prs=1022.3, max_prs_otime=0.0, avg_win_s_2mi=5.0, pre_12h=0.0, pre_24h=2.8, max_win_s_otime=2333.0, min_prs_otime=2301.0, min_tem=14.9, max_tem_24h=17.0, win_d_enum=NW, alti=37.5, monitor_time=2021-10-10 08:00:00+08, update_time=20211010080000, total=25, min_tem_otime=2301.0, max_win_s_inst=14.0, pagesize=1, win_s_inst=5.8, prs_change_24h=5.8, max_win_d_s=319, prs_change_3h=2.8, max_tem_otime=2346.0, avg_win_d_10mi=323, pre_1h=0.0, dpt=-4.3, pre_arti_enc_cyc=999999, max_win_s_inst_12h=14.0, max_win_d_inst_6h=335.0, win_d_inst=273, max_win_s_inst_otime=2324.0, station_type=0, min_rhu=25, tem_change_24h=3.0, rhu=26}]

data字段说明

字段

说明

单位

station_id

站点Id

area_code

行政区代码

page_size

页码大小

page_count

返回条数

total

总条数

monitor_time

监测时间yyyy-mm-dd hh:00:00

alti

测站高度

station_type

测站类型

station_levl

测站级别

prs

气压

百帕

prs_sea

海平面气压

百帕

prs_change_3h

3小时变压

百帕

prs_change_24h

24小时变压

百帕

max_prs

最高气压

百帕

max_prs_otime

最高气压出现时间

min_prs

最低气压

百帕

min_prs_otime

最低气压出现时间

tem

温度/气温

摄氏度(℃)

max_tem

最高气温

摄氏度(℃)

max_tem_otime

最高气温出现时间

min_tem

最低气温

摄氏度(℃)

min_tem_otime

最低气温出现时间

tem_change_24h

过去24小时变温

摄氏度(℃)

max_tem_24h

过去24小时最高气温

摄氏度(℃)

min_tem_24h

过去24小时最低气温

摄氏度(℃)

dpt

露点温度

摄氏度(℃)

rhu

相对湿度

百分率

min_rhu

最小相对湿度

百分率

min_rhu_otime

最小相对湿度出现时间

vap

水汽压

百帕

pre_1h

过去1小时降水量

毫米

pre_3h

过去3小时降水量

毫米

pre_6h

过去6小时降水量

毫米

pre_12h

过去12小时降水量

毫米

pre_24h

过去24小时降水量

毫米

pre_arti_enc_cyc

人工加密观测降水量描述周期小时

pre

人工加密观测降水量

毫米

avg_win_d_2mi

2分钟平均风向

avg_win_s_2mi

2分钟平均风速

米/秒

avg_win_d_10mi

10分钟平均风向

avg_win_s_10mi

10分钟平均风速

米/秒

max_win_d_s

最大风速的风向

max_win_s

最大风速的风速

米/秒

max_win_s_otime

最大风速出现时间

win_d_inst

瞬时风向

win_s_inst

瞬时风速

米/秒

max_win_d_inst

极大风速的风向

max_win_s_inst

极大风速

米/秒

max_win_s_inst_otime

极大风速出现时间

max_win_d_inst_6h

过去6小时极大瞬时风向

max_win_s_inst_6h

过去6小时极大瞬时风速

米/秒

max_win_d_inst_12h

过去12小时极大瞬时风向

max_win_s_inst_12h

过去12小时极大瞬时风速

米/秒

win_d_enum

风向分桶

update_time

预测开始日期

yyyymmddhh0000

dt

年月日

yyyymmdd

province

省份编码