例如,您需要调用2017年7月5日3时(GMT)的北京站(54511)的中国地面气象站逐小时观测资料的温度要素,您可以调用如下接口(传入参数没有先后顺序):
其中,userId,pwd:分配给您的帐号和密码,从订单中获取
dataFormat:返回的数据格式,目前仅支持json格式
interfaceId:此数据的接口ID,值为getSurfEleByTimeRangeAndStaID
dataCode:此数据的编码,中国地面气象站逐小时观测资料的编码为SURF_CHN_MUL_HOR
timeRange:时间范围,支持最近7天的数据访问,格式为"[YYYYMMDDHHMISS,YYYYMMDDHHMISS]",2017年7月5日3时(GMT)格式为[20170705030000,20170705030000]
staIDs:站号,支持1-30个站点,多个站点之间以","分隔,北京站(54511)的站号为54511
elements:返回数据字段,多个字段之间使用","分隔,其中:Station_Id_C, Year,Mon,Day,Hour为默认字段,Station_Id_C为站号,Year为资料时间的年,Mon为资料时间的月,Day为资料时间的日,Hour为资料时间的时,TEM为温度(气温)
返回结果为:
{"returnCode":"0","returnMessage":"Query Succeed","rowCount":"1","colCount":"6","requestParams":"datacode=SURF_CHN_MUL_HOR&staids=54511&timerange=[20170705030000,20170705030000]&elements=Station_Id_C,Year,Mon,Day,Hour,TEM","requestTime":"2017-07-07 01:48:22","responseTime":"2017-07-07 01:48:22","takeTime":"0.014","fieldNames":"区站号(字符) 年 月 日 时 温度/气温","fieldUnits":"- 年 月 日 时 摄氏度(°C)","DS":[{"Station_Id_C":"54511","Year":"2017","Mon":"7","Day":"5","Hour":"3","TEM":"29.7"}]}
其中,returnCode为返回结果编码,0为成功,其他为失败;returnMessage为返回结果描述;rowCount 为返回数据的行数;colCount 为返回数据的列数;requestParams为请求参数;requestTime为请求时间;responseTime为请求返回时间;takeTime为执行所花费的时间(毫秒)。
fieldNames为返回的要素清单,fieldUnits为返回的要素单位清单。
DS为返回数据的内容,包括字段和值,其中Station_Id_C为站号,Year为资料时间的年,Mon为资料时间的月,Day为资料时间的日,Hour为资料时间的时,TEM为温度(气温)。