气象数据服务接口规范QXT 618-2021_第1页
气象数据服务接口规范QXT 618-2021_第2页
气象数据服务接口规范QXT 618-2021_第3页
气象数据服务接口规范QXT 618-2021_第4页
气象数据服务接口规范QXT 618-2021_第5页
已阅读5页,还剩31页未读 继续免费阅读

下载本文档

版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领

文档简介

IQX/T618—2021前言 Ⅱ 2规范性引用文件 13术语和定义 1 6接口参数 3 4附录A(资料性)接口示例 6附录B(规范性)常用接口参数定义 附录C(规范性)常用返回码定义 附录D(规范性)返回数据结构 参考文献 1气象数据服务接口规范2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中,注日期的引用文件,仅该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件。GB/T2260—2007中华人民共和国行政区划代码GB/T2659—2000世界各国和地区名称代码QX/T37—2020气象台站历史沿革数据文件格式QX/T102—2009气象资料分类与编码QX/T202—2013表格驱动码气象数据传输文件规范QX/T327—2016气象卫星数据分类与编码规范QX/T378—2017公共气象服务产品文件命名规范下列术语和定义适用于本文件。对使用各种观、探测手段获取的大气状态、现象及其变化过程的记录以及各类衍生资料进行通信、解释和处理而使用的信息的形式化表示。数据服务系统提供给应用系统访问数据的应用编程接口。接口调用后返回的内存对象的数据结构。2序列化serialization将计算机内存对象转换为可保存或传输的数据格式的过程。小驼峰命名法LowerCamelCase软件编程中的一套命名规则(惯例)。4接口组成4.1接口由4部分组成:接口名称、接口参数、返回码、返回数据结构。其中,接口名称表达数据访问的具体功能,接口参数表达数据访问的输入条件,返回码表达数据访问的调用状态,返回数据结构表达返回数据的内存结构。4.2一个接口可以有一个或多个参数,每个参数应明确为必选或可选。4.3接口示例见附录A。5接口名称内容不可为空,主要条件可为空。5.2接口名称采用小驼峰命名法,命名格式为:{接口功能}《资料类型}{数据内容}{主要条件}。5.3各组成部分的取值规则应符合表1的规定。表1接口名称各组成部分的取值规则组成部分代码含义备注接口功能检索气象数据、元数据等接口功能及其取值可按需扩展统计气象数据资料类型地面气象资料高空气象资料海洋气象资料气象辐射资料农业气象和生态气象资料数值预报产品大气成分资料历史气候代用资料气象灾害资料天气雷达资料卫星气象资料3组成部分代码含义备注资料类型科学试验和考察资料气象服务产品空间天气资料其他资料数据内容要素适用于站点、格点场等要素数据文件适用于文件形式的数据要素代码列表具体的要素多个直接连接,不用分隔符主要条件(By|In|Of}{参数名)主要的参数条件多个以"And"连接;参数名应符合6.2的规定性5个主要维度进行定义;1类用于定义其他接口参数。参数类别及其描述的输入条件应符合表2的表2参数类别及其描述的输入条件参数类别参数描述的输入条件资料种类资料的范围。如资料代码要素范围类资料的要素(含统计要素)范围。如要素列表时间范围类资料的时间范围。如时间点空间范围类资料的空间范围。如经纬度范围特殊属性类资料的其他特殊属性范围,如台风编号气象资料参数”“气象服务产品参数”等其他类6.2.2气象数据访问常用接口参数定义应符合附录B的规定。除此之外的参数可根据需要参照常用参数的定义进行扩展。47返回码7.1返回码分类返回码分为2类,即成功和失败。7.2返回码定义7.2.1返回码的定义由2部分组成:返回码取值和含义。7.2.2成功类的返回码取值为0。失败类的返回码取值为负数,取值规则为-{错误类别代码}{顺序号}。其中,错误类别代码及名称应符合表3的规定,顺序号为3位数字,从001开始。7.2.3常用返回码定义应符合附录C的规定。除此之外的返回码可按需、参照常用返回码的定义进行扩展。表3错误类别代码及名称错误类别代码错误类别名称0没有数据1用户验证失败2接口与资料不匹配3接口参数错误4没有访问权限5单次请求范围过大6服务器连接错误7数据库操作错误8数据文件错误9服务器处理错误其他错误8返回数据结构8.1服务接口返回数据的结构分为3类:站点类、格点类和信息类,结构及其适用数据范围应符合表4的规定。表4返回数据结构类别及其适用数据范围返回数据结构类别适用数据范围返回数据内容站点类站点类数据如:地面气象资料、高空气象资料、气象灾害资料等二维站点数据及其描述信息、接口调用过程信息格点类格点类数据如:数值预报产品等二维格点场数据及其描述信息、接口调用过程信息信息类文件类数据如:天气雷达资料、卫星气象资料、数值预报产品等文件信息列表及其描述信息、接口调用过程信息56(资料性)接口示例A.1站点类数据服务接口示例A.1.1地面气象资料服务接口示例表A.1给出了指定时间的地面气象资料检索接口示例。表A.1指定时间的地面气象资料检索接口示例接口名称接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选资料代码字符串资料代码的英文标识表示:中国时资料必选要素代码字符串多个以逗号(,)分隔表示:检索温度、降水数据必选时间字符串表示:2008日00时00分00秒必选返回码取值见附录C返回数据结构站点类返回数据结构,描述见D.2A.1.2高空气象资料服务接口示例表A.2给出了指定时间、垂直探测意义、经纬度范围的高空气象资料检索接口示例。表A.2指定时间、垂直探测意义、经纬度范围的高空气象资料检索接口示例接口名称接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选资料代码字符串资料代码的英文标识表示:全球高空定时值资料必选要素代码字符串多个以逗号(,)分隔表示:检索温度、气压数据必选7接口名称接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选时间字符串表示:200800时00分00秒必选垂直探测意义字符串多个以逗号(,)分隔表示:标准气压层必选起始纬度浮点数最多4位小数表示:北纬32.1度必选终止纬度浮点数最多4位小数表示:北纬40.3度必选起始经度浮点数最多4位小数表示:东经120.5度必选终止经度浮点数最多4位小数表示:东经130.0度必选返回码取值见附录C返回数据结构站点类返回数据结构,描述见D.2A.1.3气象灾害资料服务接口示例表A.3给出了指定时间段、台风编号(国际)的台风资料检索接口示例。接口名称接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选资料代码字符串资料代码的英文标识表示:台风服务产品必选8表A.3指定时间段、台风编号(国际)的台风资料检索接口示例(续)接口名称接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选时间段字符串表示:2008日00时00时00分00秒(含)必选台风编号(国际)字符串多个以逗号(,)分隔表示:2020检测对象编报中心字符串多个以逗号(,)分隔表示:欧洲报中心必选返回码取值见附录C返回数据结构站点类返回数据结构,描述见D.2A.2格点类数据解析接口示例A.2.1数值预报产品格点场解码要素解析接口示例表A.4给出了指定时间、预报层次、预报时效的单场单要素检索接口示例。表A.4指定时间、预报层次、预报时效的单场单要素检索接口示例接口名称getNafpEleGridByTimeAn接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选资料代码字符串资料代码的英文标识表示:T639模式东北半球低分辨率产品必选9表A.4指定时间、预报层次、预报时效的接口名称getNafpEleGridByTimeAnd接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选时间(单个)字符串表示:起报时间2008分00秒必选预报要素(单个)字符串一表示:检索温度要素预报层次(单个)整数单位:百帕表示:检索1000百帕气压层预报时效(单个)整数预报时效,单位:小时表示:自起24小时必选返回码取值见附录C返回数据结构格点类返回数据结构,描述见D.3A.2.2数值预报产品经纬度点要素解析接口示例表A.5给出了指定时间范围、预报层次、预报时段、经纬度点的时间序列检索接口示例。接口名称getNafpEleGridByTimeAnd接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选资料代码字符串资料代码的英文标识必选时间(单个)字符串分00秒必选预报要素(单个)字符串一表示:检索温度要素必选接口名称getNafpEleGridByTimeAnd接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选预报层次(单个)整数气压层次的整数值,单位:百帕表示:检索1000百帕气压层必选起始预报时效整数预报时效,单位:小时表示:自起报时间预24小时必选终止预报时效整数预报时效,单位:小时表示:自起报时间预48小时必选经纬度点字符串多个以逗号(,)分隔表示:北纬32.1度,东经120.2度的点必选返回码取值见附录C返回数据结构格点类返回数据结构,描述见D.3A.3文件信息类数据服务接口示例A.3.1天气雷达资料服务接口示例表A.6给出了指定时间段的天气雷达资料检索接口示例。表A.6指定时间段的天气雷达资料检索接口示例接口名称接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选资料代码字符串资料代码的英文标识表示:单站雷达基数据资料必选表A.6指定时间段的天气雷达资料检索接口示例(续)接口名称接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选时间段字符串前开后开:前开后闭:前闭后开:前闭后闭:表示:2008日00时00时00分00秒(含)必选返回码取值见附录C返回数据结构信息类返回数据结构,描述见D.4A.3.2卫星气象资料服务接口示例表A.7给出了指定时间的卫星气象资料检索接口示例。表A.7指定时间的卫星气象资料检索接口示例接口名称接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选资料代码字符串资料代码的英文标识星地球同片产品必选时间字符串表示:起报日00时00分00秒必选返回码取值见附录C返回数据结构信息类返回数据结构,描述见D.4A.3.3数值预报产品服务接口示例表A.8给出了指定时间、预报要素的数值预报产品检索接口示例。接口名称接口参数名称含义赋值类型赋值格式赋值示例使用说明必选/可选资料代码字符串资料代码的英文标识表示:T639辨率产品必选时间(单个)字符串表示:起报日00时00分00秒必选预报要素字符串多个以逗号(,)分隔表示:检索温度、气压数据必选返回码取值见附录C返回数据结构信息类返回数据结构,描述见D.4(规范性)常用接口参数定义表B.1给出了常用接口参数定义。除此之外的参数,可按需、参照常用参数的定义进行扩展。表B.1类别序号名称含义赋值类型赋值格式赋值示例使用说明资料种类1资料代码(单个)字符串单个表示:中国地面逐小时资料资料代码符合QX/T102—20095.1的规定要素范围类2要素字段代码字符串多个以逗号(,)分隔表示:小时降水、气温不应用ALL和*3统计要素代码字符串(,)分隔均值4要素值范围字符串号(;)分隔其中,要素值范围的格式:(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;[a,b]:大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b表示:能见度小于1000m,相对湿度大于70%表B.1常用接口参数定义(续)类别序号名称含义赋值类型赋值格式赋值示例使用说明要素范围类5统计值范围字符串以分号(;)分隔其中,要素值范围的格式:(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;[a,b]:大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b统计要素代码取自时间范围类6时间(单个)字符串表示:2015年1月1日00时(整点)年月日时分秒应补全7时间字符串(,)分隔20150101020000表示:2015年1月1日00时、01时、02时共3个整点年月日时分秒应补全8时间段字符串前开后开:(YYYYMMDDHHMISS,前开后闭:(YYYYMMDDHHMISS,前闭后开:[YYYYMMDDHHMISS,前闭后闭:[YYYYMMDDHHMISS,表示:大于2015年1月1日00时(整点),小于或等于2015年1月2日00时(整点)年月日时分秒应补全表B.1常用接口参数定义(续类别序号名称含义赋值类型赋值格式赋值示例使用说明时间范围类9时间窗(分整数表示:某时间点前后90min,共180单位:分钟(min)分钟取整条件(分钟)整数与timeRange配合使用小时取整条件(小时)整数6表示:00、06、12、18时的数据与timeRange配合使用(单个)整数表示:24h预报单位:小时(h)预报时效字符串多个以逗号(,)分隔表示:03、06、09时3个预报时效单位:小时(h)起始预报时效整数0单位:小时(h)终止预报时效整数表示:终止预报时效为168h单位:小时(h)(历年同期)字符串表示:1月1日应为4位数字截止月日(历年同期)字符串表示:12月31日应为4位数字起始年(历年同期整数表示:2001年应为4位数字截止年(历年同期)整数表示:2016年应为4位数字表B.1常用接口参数定义(续)类别序号名称含义赋值类型赋值格式赋值示例使用说明时间范围类日序字符串要素值范围取值:1-365(平年),1-366(闰年);多个以逗号(,)分隔表示:第1,4,365天候序字符串要素值范围取值1-72;多个以逗号(,)分隔表示:第1,10,72候旬序字符串要素值范围取值1-36;多个以逗号(,)分隔表示:第1,12,36旬月序字符串要素值范围取值1-12;多个以逗号(,)分隔表示:1,4,12月日序段字符串要素值范围取值:1-365(平年),1-366(闰年);其中,要素值范围的格式:(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;(a,b):大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b表示:日序大于1小于365表B.1常用接口参数定义类别序号名称含义赋值类型赋值格式赋值示例使用说明时间范围类候序段字符串要素值范围取值1-72;其中,要素值范围的格式:(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;(a,b):大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b表示:候序大于1小于72旬序段字符串要素值范围取值1-36;其中,要素值范围的格式:(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;(a,b):大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b表示:旬序大于1小于或等于36月序段字符串要素值范围取值1-12;其中,要素值范围的格式:(a,):大于a;(a,):大于或等于a;(,a):小于a;[,a]:小于或等于a;(a,b):大于a,小于b;(a,b):大于或等于a,小于b;[a,b]:大于a,小于或等于b;[a,b]:大于或等于a,小于或等于b表示:月序大于1小于12品表B.1常用接口参数定义(续)类别序号名称含义赋值类型赋值格式赋值示例使用说明空间范围类站号字符串多个以逗号(,)分隔表示:北京站一起始站号字符串一表示:从54511站(含)开始一终止站号字符串一表示:到58238站(含)为止一起始经度浮点数最多4位小数表示:经度从116.3°(含)开始单位:度(°)终止经度浮点数最多4位小数表示:经度到118.25°(含)为止单位:度(°)起始纬度浮点数最多4位小数表示:纬度从31.14°(含)开始单位:度(°)终止纬度浮点数最多4位小数表示:纬度到39.56°(含)为止单位:度(°)经纬度点字符串多个以逗号(,)分隔单位:度(°)台站站网字符串多个以逗号(,)分隔表示:地面观测站37—2020表3的规定台站级别字符串多个以逗号(,)分隔表示:国家级基准站37—2020表3的规定国内行政编码字符串多个以逗号(,)分隔表示:北京市GB/T2260—2007表1的规定表B.1常用接口参数定义(续类别序号名称含义赋值类型赋值格式赋值示例使用说明空间范围类国家代码字符串多个以逗号(,)分隔表示:中国国家代码符合GB/T2659—2000表1的规定镇代码字符串多个以逗号(,)分隔表示:北京市东城区2260的规定流域编码字符串多个以逗号(,)分隔表示:黄河流域流域编码见全国流域区划代码表编报中心字符串多个以逗号(,)分隔表示:欧洲中尺度预报中心编报中心符合QX/T202—2013附录B的规定垂直探测意义字符串多个以逗号(,)分隔表示:标准气压层垂直探测仪见《气象观测报告的解码规则与算法》中3.3气压层次字符串多个以逗号(,)分隔气压层单位:百帕(hPa);气压层次下限整数表示:850hPa气压层单位:百帕(hPa);码表3.15类别序号名称含义赋值类型赋值格式赋值示例使用说明空间范围类气压层次上限整数表示:100hPa气压层单位:百帕(hPa);码表3.15高度层次字符串多个以逗号(,)分隔表示:5000m高度层单位:米(m);高度层次下限浮点数具体单位因资料而异高度层次上限浮点数具体单位因资料而异飞行高度层次下限浮点数单位:米(m)用于飞机报资料飞行高度层次上限浮点数单位:米(m)用于飞机报资料土壤深度整数单位:厘米(cm)用于农气资料表B.1常用接口参数定义(续)类别序号名称含义赋值类型赋值格式赋值示例使用说明特殊属性类(台风资料参数)(国际)字符串多个以逗号(,)分隔表示:2020年西太平洋第24个检测对象一(国内)字符串多个以逗号(,)分隔表示:2020年第22个热带气旋一台风名称字符串多个以逗号(,)分隔表示:台风名称为VAMCO—特殊属性类(数值预报产品参数)(单个)字符串一表示:温度预报要素符合QX/T102—2009表5的规定预报要素字符串多个以逗号(,)分隔表示:降水量,气压预报要素符合QX/T102—2009表5的规定(单个)字符串一单位:百帕(hPa)预报层次字符串多个以逗号(,)分隔表示:850hPa和1000hPa单位:百帕(hPa)(单个)字符串一表示:全球预报区域符合QX/T102—2009表2的规定预报区域字符串多个以逗号(,)分隔表示:南半球和北半球预报区域符合QX/T102—2009表2的规定集合预报成员(单个)整数一1表示:第1个成员一怨表B.1常用接口参数定义(续)类别序号名称含义赋值类型赋值格式赋值示例使用说明特殊属性类(天气雷达资料参数)扫描方式字符串多个以逗号(,)分隔表示:圆锥扫描模式扫描方式见《气测函〔2017〕48号观测司关于新一代天气雷达 件业务运行的通知》附表1覆盖范围字符串多个以逗号(,)分隔覆盖范围见《气测函〔2017〕48号观测司关于新一代天气雷达 件业务运行的通知》附表1仰角字符串多个以逗号(,)分隔表示:仰角为1.5°单位:度(°)最小仰角字符串表示:最小仰角为1.5°单位:度(°)最大仰角字符串表示:最大仰角为6°单位:度(°)分辨率字符串多个以逗号(,)分隔1单位:千米(km)特殊属性类(卫星气象资料参数)卫星标识字符串多个以逗号(,)分隔表示:风云1号A星327—2016表1的规定卫星通道字符串多个以逗号(,)分隔表示:可见光通道327—2016表A.2的规定表B.1常用接口参数定义(续)类别序号名称含义赋值类型赋值格式赋值示例使用说明特殊属性类(卫星气象资料参数)仪器标识字符串多个以逗号(,)分隔表示:大气垂直探测系统327—2016表A.2的规定投影方式字符串多个以逗号(,)分隔表示:等面积投影327—2016表6的规定特殊属性类(气象服务产品参数)服务产品代码字符串多个以逗号(,)分隔表示:实景监测T378—2017表A.3的规定其他类最大返回记录数整数10,表示:最多返回10条一排序字段字符串(,)分隔;TEM/asc,表示:按气温升序SUM_PRE_1h/desc,表示:按累计降水降序要素代码可以是普通要统计要素(statEles)返回唯一值(去重复)字符串true或falsetrue,表示:去掉重复记录(规范性)常用返回码定义表C.1给出了常用的返回码定义。除此之外的返回码,可按需、参照常用返回码的定义进行扩展。表C.1常用返回码定义类别取值含义(英文)含义(中文)备注成功0调用成功有数据返回失败无数据返回(没有所需条件范围的数据)错误类别:没有数据用户名缺失错误类别:用户验证失败用户不正确密码缺失密码错误接口名不正确错误类别:接口与资料不匹配资料代码不正确参数赋值错误错误类别:接口参数错误参数缺失参数多余或未定义没有访问该数据的权限错误类别:没有访问权限没有访问该历史数据的权限检索的时间跨度超过范围错误类别:单次请求范围过大检索的时间点个数超过限制服务器连接失败错误类别:服务器连接错误错误类别:数据库操作错误文件不存在错误类别:数据文件错误文件不可读接口基础功能处理异常错误类别:服务器处理错误接口参数处理异常服务器其他异常错误类别:其他错误(规范性)返回数据结构D.1结构描述说明D.1.1返回数据结构包含站点类、格点类、信息类3类,以C/C++、Fortran、C#、Java等几类常用语言,表示服务接口的数据结构及其序列化格式。其中,内存对象结构指服务接口返回的寄存在内存中的thon等其他语言和xarray等其他序列化格式的表示,参照执行。D.1.2站点类结构和格点类结构均返回数据具体内容。信息类结构仅返回文件URL等相关信息,不返回文件具体内容,接口调用客户端获取URL后,使用通用的HTTP、TDS等服务协议去获取文件具体内容。因此,该结构对NetCDF、GRIB1/2等具体的文件格式不敏感,都适用。D.2站点类返回数据结构表D.1给出了站点类返回数据的内存对象结构RetArray2D信息,包括数组、记录数、字段数、接口调用过程信息等。表D.1站点类返回数据的内存对象结构RetArray2D信息结构名称使用说明适用于检索站点要素资料、格点数据中单点或多点的要素值、台站元数据信息、资料字段属性信息等接口C/C++/Fortran结构体成员成员名称Fortran类型成员说明获取的数据。一维长度rowCount,二维长度colCount记录数字段数接收时间、结果返回时间、耗时等,应符合D.5的规定C#/Java类成员成员名称C#/Java类型成员说明获取的数据接收时间、结果返回时间、耗时等,应符合D.5的规定D.2.2序列化格式表D.2给出了站点类返回数据的XML、JSON、JSONP、TEXT、HTML等几类格式信息,包括数据和接口调用过程信息等。表D.2站点类返回数据的序列化格式信息格式类型格式信息<DSreturnCode="返回码"returnMessage="返回码说明(含错误信息)"rowCount="返回数据行数"colCount="返回数据列数"requestParams="调用参数"requestTime="接收请求时间"responseTime="返回请求结果时间"takeTime="耗时(毫秒)"〉(R字段名1="字段值1"字段名2="字段值2"……字段名n="字段值n"/)(R字段名1="字段值1"字段名2="字段值2"……字段名n="字段值n"/)(!-其他行数据,此处省略--)(returnCode:"返回码",returnMessage:"返回码说明(含错误信息)",rowCount:"返回数据行数",colCount:"返回数据列数",requestParams:"调用参数",requestTime:"接收请求时间",responseTime:"返回请求结果时间",takeTime:"耗时(毫秒)",DS:[{字段名1:"字段值1",字段名2:”字段值2”,字段名3:"字段值3",……},{字段名1:"字段值1",字段名2:”字段值2”,字段名3:"字段值3",……},……//其他行数据,此处省略]}回调函数名称({returnCode:"返回码",returnMessage:"返回码说明(含错误信息)",rowCount:"返回数据行数",colCount:"返回数据列数",requestParams:"调用参数",requestTime:"接收请求时间",responseTime:"返回请求结果时间",takeTime:"耗时(毫秒)",DS:[{字段名1:"字段值1”,字段名2:”字段值2”,字段名3:"字段值3",……},{字段名1:"字段值1",字段名2:"字段值2”,字段名3:"字段值3",……},……//其他行数据,此处省略]表D.2站点类返回数据的序列化格式信息(续)格式类型格式信息//注:第1行,调用信息returnCode="返回码"returnMessage="返回码说明(含错误信息)"rowCount="Count="返回数据列数"requestParams="调用参数"requestTime="接收请求时间"resp回请求结果时间"takeTime="耗时(毫秒)"//注:第2行,返回字段列表字段名1字段名2字段名3字段名4字段名5字段名6字段名7……//注:第3-n行,每行对应一条数据记录字段值1字段值2字段值3字段值4字段值5字段值6字段值7……(td)字段名1</td)<td)字段名2</td)<td)字段名3</td><!-其他字段,省略--)td)字段值1</td)<td)字段值2</td)<td)字段值3</td)<!-其他字段,省略--)td)字段值1</td)<td)字段值2</td)<td)字段值3(/td><!-其他字段,省略--)<!--其他行数据,此处省略-)D.3格点类返回数据结构信息,包括数组、网格定义、接口调用过程信息等。表D.3格点类返回数据的内存对象结构RetGridArray2D信息结构名称使用说明适用于检索格点数据中单一要素场,或区域裁剪的数据接口C/C++/Fortran结构体成员成员名称成员说明获取的数据,排列方式:先纬度后经度;其中,纬度从北到南,经度从西到东;一维长度latCount,二维长度lonCount网格起始纬度网格起始经度网格结束纬度网格结束经度纬向格点数经向格点数纬度格距经度格距收时间、结果返回时间、耗时等,应符合D.5的规定C#/Java类成员成员名称C#/Java类型成员说明获取的数据,排列方式:先纬度后经度;其中,纬度从北到南,经度从西到东;一维长度latCount,二维长度lonCount网格起始纬度网格起始经度网格结束纬度网格结束经度纬向格点数经向格点数纬度格距经度格距收时间、结果返回时间、耗时等,应符合D.5的规定D.3.2序列化格式表D.4给出了格点类返回数据的XML、JSON、JSONP、TEXT、HTML等几类格式信息,包括数表D.4格点类返回数据的序列化格式信息格式类型格式信息〈DSreturnCode="返回码"returnMessage="返回码说明(含错误信息)"startLat="网格起始纬度"startLon="网格起始经度"endLat="网格结束纬度"endLon="网格结束经度"latCount="纬向格点数"lonCount="经向格点数"latStep="纬度格距"lonStep="经度格距"requestParams=”调用参数”requestTime="接收请求时间"responseTime="返回请求结果时间"takeTime="耗时(毫秒)">(R>值1,值2,值3,……值n(/R)(R>值1,值2,值3,……值n</R)<!-其他行数据,此处省略-)returnCode:"返回码",returnMessage:"返回码说明(含错误信息)",startLat:"网格起始纬度",lonCount:"经向格点数",latStep:"纬度格距",lonStep:“经度格距",requestParams:"调用参数”,requestTime:"接收请求时间",responseTime:"返回请求结果时间",takeTime:"耗时(毫秒)",DS:[[字段值1,字段值2,字段值3,……],[字段值1,字段值2,字段值3,……],……//其他行数据,此处省略}回调函数名称({returnCode:"返回码",returnMessage:"返回码说明(含错误信息)",startLat:"网格起始纬度",lonCount:"经向格点数",latStep:"纬度格距",lonStep:“经度格距",requestParams:"调用参数”,requestTime:"接收请求时间",responseTime:"返回请求结果时间",takeTime:"耗时(毫秒)",DS:[[字段值1,字段值2,字段值3,……],[字段值1,字段值2,字段值3,……],……//其他行数据,此处省略]//注:第1行,调用信息returnCode="返回码"returnMessage="返回码说明(含错误信息)"startLat="网格起始纬度"startLon="网格起始经度"endLat="网格结束纬度"endLon="网格结束经度"latCount="纬向格点数"lonCount="经向格点数"latStep="纬度格距"lonStep="经度格距"requestParams=”调用参数”requestTime="接收请求时间"responseTime="返回请求结果时间"takeTime="耗时(毫秒)"//注:第2-n行,每行对应一条数据记录值1值2值3值4值5值6值7……表D.4格点类返回数据的序列化格式信息(续)格式类型格式信息(td)纬度\经度</td)《td)经度1(/td)(td)经度2</td)<!--其他值省略-)(td)纬度1(/td)(td>值1(/td)(td)值2(/td)(!-其他值省略-->(td)纬度2(/td)(td)值1(/td)(td)值2(/td)(!-其他值省略--)(!--其他行数据,此处省略--)D.4信息类返回数据结构信息,包括文件信息清单、文件数、接口调用过程信息等。表D.5信息类返回数据的内存对象结构RetFilesInfo信息结构名称使用说明适用于检索文件列表信息的接口,一般为非结构化数据,包括雷达、卫星、服务产品、以及数值预报文件和图形文件等C/C++/Fortran结构体成员成员名称Fortran类型成员说明检索下载的文件信息清单,长度:fileCount,应符合表D.6规定获取的文件数收时间、结果返回时间、耗时等,应符合D.5的规定C#/Java类成员成员名称C#/Java类型成员说明检索下载的文件信息清单。应符合表D.6的规定收时间、结果返回时间、耗时等,应符合D.5的规定表D.6给出了单个文件信息的内存对象结构FileInfo信息,包括接口调用客户端文件名、全路径、文件后缀、文件大小、接口服务端文件URL等。表D.6单个文件信息的内存对象结构FileInfo信息结构名称使用说明描述单个文件的信息。RetFilesInfo中的成员fileInfos,是本数据结构的数组C/C++/Fortran结构体成员成员名称Fortran类型成员说明接口调用客户端文件名(含后缀)接口调用客户端文件全路径名(路径十文件名)。在仅获取文件信息列表的接口中,该成员为空文件后缀文件大小,单位:比特(byte)图片文件的base64编码数据。对非图片文件,该成员为空;对图片文件,可为空(使用fileUrl)要素C#/Java类成员成员名称C#/Java类型成员说明文件名(含后缀)文件全路径名(路径+文件名)文件后缀文件大小,单位:比特(byte)图片文件的base64编码数据。对非图片文件,该成员为空;对图片文件,可为空

温馨提示

  • 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
  • 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
  • 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
  • 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
  • 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
  • 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
  • 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。

评论

0/150

提交评论