DB36T 1501-2021生态环境数据接入规范.docx
ICS 35.240L 70DB36江 西 省 地 方 标 准DB36/T 15012021生态环境数据接入规范Access specification of ecology and environment data2021 - 12- 14 发布2022 -06- 01 实施目次前言II1 范围12规范性引用文件13术语和定义14接入范围15接入方式16接入要求27接入流程2附录A （资料性）接口示例3本文件按照GB/T 1.12020标准化工作导则第1部分：标准化文件的结构和起草规则的规定起 草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由江西省生态环境厅提出并归口。本文件起草单位：江西省生态环境科学与规划研究院、江西省生态环境监测中心、江西省质量和标 准化研究院、江西省华赣环境集团有限公司。本文件主要起草人：江驰、谭文津、雷宁宁、谢雷、渔鑫、徐靓、曾建华、张仰硕、吴仁都、汪秋 雨、余君、冷滨、黄振、曹卓冰、陈雪威、付忠诚、李苏发、陈英、谢岩、胡昊旻、李雪。生态环境数据接入规范1范围本文件规定了生态环境数据的术语和定义、接入范围、接入方式、接入要求、接入流程。本文件适用于江西省内生态环境数据的接入与应用。2规范性引用文件下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。GB/T 22239信息安全技术网络安全等级保护基本要求HJ 719环境信息系统数据库访问接口规范HJ 727环境信息交换技术规范DB36/T 981电子政务共享数据统一交换平台技术规范DB36/T 1179政务数据共享技术规范3术语和定义下列术语和定义适用于本文件。3.1数据提供方data provider在一次数据接入过程中，负责提供生态环境数据的组织或单位。3.2数据需求方data demander在一次数据接入过程中，负责接收生态环境数据的组织或单位。4接入范围4.1 生态环境数据平台接入国家、省、设区市、县区生态环境行政主管部门和其他各级机构生态环境 相关的数据。4.2 省、设区市、县区生态环境数据应逐级接入或回流。4.3 其他各级机构数据接入同级生态环境数据平台。5.1 类型数据接入方式有数据文件、数据中间库和数据接口三种，针对不同的数据及需求采用相应的接入方 式。5.2 数据文件通过电子邮件或FTP方式传输生态环境数据文件。5.3 数据中间库通过数据中间库交换生态环境数据，数据交换应符合HJ 719、HJ 727、DB36/T 981、DB36/T 1179 等文件要求。5.4 数据接口5.4.1 数据获取按照数据提供方发布的数据接口要求，调用接口服务，获取生态环境数据。5.4.2 接口要求提供数据接口应符合以下要求（接口示例见附录A）：a）接口名称：此处描述接口中文含义；b）接口地址：此处描述接口服务地址；c）接口说明：对接口含义进行详细描述；d） 接口协议：http> WebService 等；e）备注：接口需备注的内容；f）输入参数：包括参数名称、参数值、验证码等；g）返回结果：包括参数名称、描述、状态等。6接入要求6.1 对数据接入应进行身份及权限验证。6.2 对数据分类分级，明确接入范围。6.3 接入应符合 GB/T 22239> DB36/T 981、DB36/T 1179 等文件要求。6.4 对数据进行校验，保证数据的准确。6.5 通过数据中间库或数据接口方式进行接入的，应对数据增加主键、时间戳。7接入流程7.1 数据需求方提出数据接入申请。7.2 数据提供方根据申请分析接入的数据项及用途，确认接入方式，并提供相应的数据字典、数据接 口说明文档等。7.3 数据提供方对提供的数据接口、数据中间库及数据文件进行监控、维护，确保数据接入持续有效。附录A （资料性） 接口示例A.1接口示例一A. 1.1接口描述接口名称通用接口接口地址http:/ip:port/servicewsjsonWebService?wsdl接口协议WebService接口方法RunJsonResult备注所有的接口返回的都是最新时间的数据A. 1.2输入参数参数名称描述类型是否必填示例TOKEN授权码String是“ynhbt”interfaced接口 IDString是,z8aaab3db5e97eecb015e993bb2d40122,zpager分页；page：当前页数（从1 开始）；pageSize：每页条数String是 "" c ""i 1t pager : page : , pageSize : HPARAMSfieldName：参数名称；value： 查询参数值；operator：匹配 关系默认为“ O注：凡是返回的字段都可以作 为查询条件使用，按照这种格 式直接拼接String是"params":"fieldName":"行政区 ", "value":"02700001", "OPerator：”二 , zzfieldNamezz :企业名称,value": 南昌"，"operator":"="A. 1.3返回结果参数名称描述示例headtotal：总数；message：响应信息；state：状态（true 成功；false 失败）；,data,z ： Fstandentersd” : IOo,., head ： “total”:5612, “message:null, “interfaceld":" 200", "state”: truedata数据信息；格式：字段名：值A. 1. 4 WebSerViCe调用示例调用java类示例:服务地址String serverUrl=xzhttp:/ip: portservicewsjsonWebService7wsdlzz;ParamS 参数String ParalnS= Pager: page:PageSiZe: 10, ParamS: ValUe: , z"fieldName”: ,zPOINTTYPEz, ,zoperator,z: =, ,value,z: ,360200000000,z, ,zf ieldName,z: CODE_R EGION", "operator、":"="”;接口方法String method = "RunJsonResult”;接口IDString interfaceld = zz8aaab3db5e97eecb015e993bb2d40122z,;授权码String token = "ynhbt”Client c=new Client(new URL(serverUrl);Object o=c. invoke(method, new Stringinterfaceld, token, params);System, out. println(o0. toString ();A. 2接口示例二A. 2.1接口描述接口名称县级饮用水站监测小时数据接口接口地址httpip:port/context/serviceinterface/search/run. action接口协议WebService接口方法getMonitoringWaterStation备注县级饮用水站监测小时数据A. 2.2输入参数参数名称描述类型是否必填示例TOKEN授权应用String是ynhbtInterfaceid接口 IDString是,8aaab3db5e97eecb015e993bb2d40122z,pointcode测点编码String否ENDTIME结束时间String是,yyyy-MM-ddss,zCODEREGION行政区域代码String否STARTTIME开始时间String是z,yyyy-MM-ddsszzA. 2.3返回结果参数名称描述示例headtotal：总数；message： 响应信息；state：状态（true 成功；false 失败）；“head：“total”:0, “state:true/false", "messag: Jdata: ITPolNTCODE :, PKID : JRegiOnN ame:PoLLUTENAME:, POLLUTEVALUE:CoDE_参数名称描述示例dataPKID：主键POINTCODE：测点编码 POINTNAME：测点名称CODE_REGION：行政区域代码 RegionName:所在地市 MONITORTIME：监测时间 CODE_POLLUTE：污染物编码 POLLUTENAME：污染物名称 POLLUTEVALUE：监测值REGION": 一CODE_POLLUTE: 一POlNTNAME: , MONlTORTlME：A. 2. 4 WebSerViCe调用示例public void wsTest() throws ExceptionString param 二 data: ,zT0KENzz: xxxx, P0INTC0DE: xxxx, ”ENDTIME: ''xxxx八CODEREGl0N: xxxx, ”STARTT IMEz,: "xxxx" ；Client c = new Client (new URL(z,httpip: portservicewsjsonWebService7wsdlz,);Object o = c. invoke("RunJsonResult”, new String口 "模板id", "TOKEN”, param);System, out. println(o0. toString();A. 3接口示例三A. 3.1接口描述接口名称公共代码接口接口地址http:/ip:port/context/serviceinterface/search/run. action接口协议WebService接口方法getPublicCode备注公共代码数据A. 3.2输入参数参数名称描述类型是否必填示例TOKEN授权应用String是“ynhbt”INTERFACED接口 IDString是
