表3错误类别代码及名称

8.1服务接口返回数据的结构分为3类：站点类、格点类和信息类，结构及其适用数据范围应符合表4 的规定。

8.2返回数据结构的具体描述分别符合附录D中D.2、D.3和D.4的规定输电线路标准规范范本，均使用2种形式进行表达： 内存对象结构和序列化格式

8.2返回数据结构的具体描述分别符合附录D中D.2、D.3和D.4的规定，均使用2种形式进行表达： 内存对象结构和序列化格式

A.3文件信息类数据服务接口示例

A.3.1天气雷达资料服务接口示例

表A.6指定时间段的天气雷达资料检索接口示

OX/T 6182021

OX/T 6182021

附录C （规范性） 常用返回码定义 表C.1给出了常用的返回码定义。除此之外的返回码，可按需、参照常用返回码的定义进行扩展

表C.1常用返回码定

D.1.1返回数据结构包含站点类、格点类、信息类3类，以C/C十十、Fortran、C#、Java等几类常用语 言，表示服务接口的数据结构及其序列化格式。其中，内存对象结构指服务接口返回的寄存在内存中的 数据结构，可直接被程序调用，序列化字符串包括XML、JSON、JSONP、TEXT、HTML等格式。Py hon等其他语言和xarray等其他序列化格式的表示，参照执行。 D.1.2站点类结构和格点类结构均返回数据具体内容。信息类结构仅返回文件URL等相关信息，不 返回文件具体内容，接口调用客户端获取URL后，使用通用的HTTP、TDS等服务协议去获取文件具 体内容。因此，该结构对NetCDF、GRIB1/2等具体的文件格式不敏感，都适用

D.2站点类返回数据结构

D.2.1内存对象结构：RetArray2D

表D.1给出了站点类返回数据的内存对象结构RetArray2D信息，包括数组、记录数、字段数、接 用过程信息等

表D.1站点类返回数据的内存对象结构RetArray2D信息

OX/T 6182021

D.2. 2 序列化格式

表D.2给出了站点类返回数据的XML、JSON、JSONP、TEXT、HTML等儿类格式信息，包括数 接口调用过程信息等

表D.2站点类返回数据的序列化格式信息

给排水造价、定额、预算表D.4格点类返回数据的序列化格式信息

startLon："网格起始经度"，endLat："网格结束纬度"，endLon："网格结束经度"，latCount："纬向格点数 onCount："经向格点数"，latStep："纬度格距"，lonStep："经度格距"，requestParams："调用参数”， requestTime：“接收请求时间"，responseTime："返回请求结果时间"，takeTime：“耗时（毫秒）"， DS［［字段值1，字段值2，字段值3，...]， [字段值1，字段值2，字段值3，]， //其他行数据，此处省略

回调函数名称（ returnCode："返回码"，returnMessage："返回码说明（含错误信息）"，startLat："网格起始纬度 startLon："网格起始经度"，endLat："网格结束纬度"，endLon："网格结束经度"，latCount："纬向格点数" 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.….

returnCode：“返回码"，returnMessage："返回码说明（含错误信息）"，startLat：”网格起始纬度 tartLon："网格起始经度"，endLat："网格结束纬度"，endLon："网格结束经度"，latCount："纬向格点数" lonCount："经向格点数"，latStep："纬度格距"，lonStep："经度格距"，requestParams："调用参数”， equestTime：“接收请求时间"，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..·..

QX/T618—2021D.4.2单个文件信息的内存对象结构：FileInfo表D.6给出了单个文件信息的内存对象结构FileInfo信息，包括接口调用客户端文件名、全路径、文件后缀、文件大小、接口服务端文件URL等。表D.6单个文件信息的内存对象结构Filelnfo信息结构名称FileInfo使用说明描述单个文件的信息。RetFilesInfo中的成员filelnfos，是本数据结构的数组C/C++/Fortran结构体成员成员名称C/C++类型Fortran类型成员说明fileNamechar[]Character(*)接口调用客户端文件名（含后缀）接口调用客户端文件全路径名（路径十文件名）。在仅获取文件savePathchar[JCharacter(*)信息列表的接口中，该成员为空suffixchar[]Character(*)文件后缀sizeintinteger文件大小，单位：比特（byte)fileUrlchar[]Character(*)接口服务端文件URLchar[]图片文件的base64编码数据。对非图片文件，该成员为空；对imgBase64Character(*)图片文件，可为空（使用fileUrl)Character（除固定输出的fileName、suffix、size和fileUrl外，用户要检索的attributeschar[J]*)要素C#/Java类成员成员名称C#/Java类型成员说明fileNameString文件名（含后缀）savePathString文件全路径名（路径十文件名）suffixString文件后缀sizeint文件大小，单位：比特（byte)fileUrlString服务端文件URLString图片文件的base64编码数据。对非图片文件，该成员为空；对imgBase64图片文件，可为空（使用fileUrl)attributes除固定输出的fileName、suffix、size和fileUrl外，用户要检索的String[J要素D.4.3序列化格式表D.7给出了信息类返回数据的XML、JSON、JSONP、TEXT、HTML等几类格式信息，包括文件信息清单、文件数、接口调用过程信息等31

煤炭标准表D.7信息类返回数据的序列化格式信息

returnCode：“返回码"，returnMessage：“返回码说明（含错误信息）"，fileCount：“文件数"，requestParan "调用参数"，requestTime："接收请求时间"，responseTime："返回请求结果时间"，takeTime："耗时（ 秒）”， DS[(filename="",fileUrl="", suffix="", size="", imgBase64="", attributesl="",... attributesn=""}, filename=""，fileUrl="",suffix=""，size="”，imgBase64=""，attributesl="",.. attributesn=""), ..//其他行数据，此处省略

表D.7信息类返回数据的序列化格式信息（续