中华人民共和国国家生态环境标准HJ1294—2023生态保护红线监管数据互联互通接口技术规范Technicalspecificationforinterconnectioninterfaceofecologicalconservationredlinesupervisiondata本电子版为正式标准文本，由生态环境部环境标准研究所审校排版。2023-04-15发布2023-04-15实施生态环境部发布HJ1294—2023i目次前言.....................................................................................................................................................................ii1适用范围...........................................................................................................................................................12规范性引用文件...............................................................................................................................................13术语与定义.......................................................................................................................................................14缩略语...............................................................................................................................................................25总体框架...........................................................................................................................................................26数据要求...........................................................................................................................................................47接口调用流程...................................................................................................................................................58开发要求.........................................................................................................................................................11附录A（规范性附录）接口名称表...............................................................................................................12附录B（规范性附录）安全验证接口及消息描述.......................................................................................13附录C（资料性附录）安全验证接口参数示例...........................................................................................15附录D（规范性附录）结构化数据接口描述...............................................................................................17附录E（资料性附录）结构化数据接口参数示例.......................................................................................19附录F（规范性附录）文件接口描述...........................................................................................................24附录G（资料性附录）文件接口参数示例...................................................................................................26附录H（规范性附录）空间服务信息接口描述..........................................................................................30附录I（资料性附录）空间服务信息接口参数示例....................................................................................32附录J（规范性附录）视频信息接口描述....................................................................................................36附录K（资料性附录）视频信息接口参数示例..........................................................................................38HJ1294—2023ii前言为贯彻落实《中华人民共和国环境保护法》和《生态保护红线生态环境监督办法（试行）》，指导和规范生态保护红线监管数据互联互通接口实现方式，促进生态保护红线监管数据的共享和应用，制定本标准。本标准规定了生态保护红线监管数据互联互通总体框架、数据要求、接口调用流程以及开发要求等内容。本标准的附录A、附录B、附录D、附录F、附录H、附录J为规范性附录，附录C、附录E、附录G、附录I、附录K为资料性附录。本标准为首次发布。本标准由生态环境部自然生态保护司、法规与标准司组织制订。本标准主要起草单位：生态环境部卫星环境应用中心、生态环境部信息中心、内蒙古自治区环境监测总站、江苏省环境监测中心、航天宏图信息技术股份有限公司。本标准生态环境部2023年4月15日批准。本标准自2023年4月15日起实施。本标准由生态环境部解释。HJ1294—20231生态保护红线监管数据互联互通接口技术规范1适用范围本标准规定了生态保护红线监管数据互联互通的总体框架、数据要求、接口调用流程以及开发要求等。本标准适用于规范和指导国家和省级生态环境部门之间生态保护红线监管数据互联互通的应用程序接口设计、功能研发以及运行管理。县、市级生态环境部门可参照执行。2规范性引用文件本标准引用了下列文件或其中的条款。凡是注明日期的引用文件，仅注日期的版本适用于本标准。凡是未注日期的引用文件，其最新版本（包括所有的修改单）适用于本标准。GB/T22239信息安全技术网络安全等级保护基本要求GB/T28168信息技术中间件消息中间件技术规范GB/T28181公共安全视频监控联网系统信息传输、交换、控制技术要求GB/T32907信息安全技术SM4分组密码算法HJ1144生态保护红线监管技术规范台账数据库建设（试行）HJ1145生态保护红线监管技术规范数据质量控制（试行）HJ1146生态保护红线监管技术规范平台建设（试行）《生态保护红线监管指标体系（试行）》（环办生态〔2020〕29号）3术语和定义下列术语和定义适用于本标准。3.1生态保护红线台账数据库ecologicalconservationredlineledgerdatabase以生态保护红线台账为核心，包括生态保护红线边界要素、人类活动监管要素、自然生态用地要素、生态服务功能要素、红线管理状况要素、遥感影像要素、基础地理要素、环境质量要素以及系统运行管理等其他要素的规范化数据集。生态保护红线台账以生态保护红线图斑为基本信息单元、以县级行政区为基本管理统计单元。3.2生态保护红线监管数据互联互通supervisiondatainterconnectionofecologicalconservationredline以生态保护红线台账数据库为基础，通过软硬件系统和接口的配置与研发，以访问接口、汇交填报、实地核实、空间服务等方式，实现国家与地方生态保护红线监管数据的在线交换、及时更新和协同共享。HJ1294—202323.3生态保护红线监管平台supervisionplatformforecologicalconservationredline服务于生态保护红线“面积不减少、性质不改变、功能不降低”管理要求，为实现“一条红线管控重要生态空间”目标而建设的，面向生态保护红线台账管理、人类活动监控、生态系统状况监测、保护成效评估等核心监管需求的业务化平台系统。生态保护红线监管平台建设内容还包括支撑平台运行的计算机支撑环境、一体化监测能力建设等。3.4国家节点nationalnode依托国家生态保护红线监管平台开展全国生态保护红线监管工作的节点。国家节点是各地方节点的根节点。3.5地方节点localnode依托地方生态保护红线监管能力开展本行政区生态保护红线监管工作的节点。各地方节点是国家节点的子节点。3.6消息中间件message-orientedmiddleware基于队列与消息传递技术，在网络环境中为应用系统提供同步或异步、可靠的消息传输的支撑性软件系统。4缩略语下列缩略语适用于本标准。TCP/IPTransmissionControlProtocol/InternetProtocol传输控制协议/互联网协议HTTPHyperTextTransferProtocol超文本传输协议JSONJavaScriptObjectNotationJavaScript对象表示法OGCOpenGeospatialConsortium开放地理空间信息联盟GMLGeographyMarkupLanguage地理标记语言5总体框架5.1访问机制以生态保护红线台账数据库为基础，地方节点通过国家生态环境业务专网，访问国家节点接口服务器的网络地址，基于身份安全验证机制，利用消息中间件进行消息传递，实现访问接口的调用和数据交换共享。互联互通接口总体框架见图1。接口名称见附录A。HJ1294—20233图1互联互通接口架构图5.2接口功能5.2.1访问授权地方节点通过用户名和密码进行安全验证，获取互联互通接口访问授权。a）国家节点可查看和访问所有地方节点共享的数据；b）地方节点可查看和访问国家节点共享的数据；c）地方节点可查看但不能访问其他地方节点共享的数据。5.2.2数据推送地方节点向国家节点数据库推送生态保护红线监管数据。5.2.3数据提取地方节点从国家节点数据库提取生态保护红线监管数据。5.3接口类型5.3.1安全验证接口用于地方节点访问国家节点时的身份安全验证。5.3.2结构化数据接口用于人类活动监管问题清单、项目审批清单、地面观测信息、红线监管台账等结构化数据的同步更新。HJ1294—202345.3.3文件接口用于生态保护红线划定和调整数据、人类活动监管数据、生态修复数据、自然生态用地数据、植被覆盖度、水源涵养等生态系统服务功能数据以及红线管理制度文件、卫星遥感影像产品等实体数据的在线传输。5.3.4空间服务信息接口用于人类活动遥感监测图斑矢量服务、各类生态功能产品栅格服务、卫星遥感影像服务等空间服务地址及服务信息的在线共享。5.3.5视频信息接口用于监控视频等视频流地址及视频信息的实时共享。6数据要求6.1数据内容以生态保护红线台账数据库为基础，以生态保护红线监管指标体系为核心，以“生态功能不降低、面积不减少、性质不改变”为监管目标，支撑生态保护红线日常监管、年度考核、定期评估业务的数据。主要包括生态保护红线划定和调整、人类活动监管、生态系统服务功能监测、生态保护修复成效评估、生态保护红线管理制度等相关成果数据，最终形成生态保护红线监管全覆盖、动态更新、权威统一的“一个库”“一张网”“一张图”。其中：a）国家节点向地方节点提供疑似生态破坏问题、卫星遥感影像产品、生态参数产品、生态系统服务功能产品、地方报送成果遥感监测和核实反馈等数据；b）地方节点向国家节点提供生态保护红线划定和调整、疑似生态破坏问题核实处理与整改、生态保护修复成效评估、人类活动准入和项目审批、视频监控、地方红线管理等数据。6.2格式要求6.2.1结构化数据结构化数据格式应符合HJ1144中6.4.2节的规定。6.2.2文件实体矢量文件采用SHP、GML等格式进行交换和共享，栅格文件采用GeoTIFF、IMG等格式进行交换和共享。6.2.3空间服务空间服务采用OGC标准进行数据共享，支持WMS、WFS、WCS、WPS、WMTS等方式发布的地图服务、影像服务或矢量服务。6.2.4流媒体流媒体格式应符合GB/T28181的规定，支持HTTPLiveStreaming网络传输协议。不同类型数据对应的接口方式见图2。HJ1294—20235图2不同数据内容与接口方式对应图6.3质量要求数据质量要求应符合HJ1145的规定，并由国家节点自动质检审核。7接口调用流程7.1安全验证接口及消息7.1.1安全验证接口地方节点通过安全验证接口访问国家节点，通过用户名和密码进行身份安全验证，提取令牌信息，实现其他应用程序接口的安全访问。接口参数见附录B，示例参见附录C。7.1.2消息采用消息中间件传递消息，消息结构包括消息安全验证、消息队列信息和消息输出内容。消息参数见附录B。HJ1294—202367.2结构化数据接口7.2.1结构化数据推送接口地方节点向国家节点推送结构化数据时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问结构化数据推送接口，将结构化数据推送至国家节点数据库；c）通过消息中间件将推送信息通知国家节点。接口调用流程见图3，接口参数见附录D，示例参见附录E。图3结构化数据推送接口调用流程图7.2.2结构化数据提取接口地方节点从国家节点提取结构化数据时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问结构化数据提取接口，从国家节点数据库获取所需数据，存储至地方节点数据库；c）通过消息中间件将提取信息通知国家节点。接口调用流程见图4，接口参数见附录D，示例参见附录E。HJ1294—20237图4结构化数据提取接口调用流程图7.3文件接口7.3.1文件推送接口地方节点向国家节点推送数据时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问文件推送接口，将文件元数据推送至国家节点数据库，将文件实体数据存储至国家节点磁盘阵列；c）通过消息中间件将推送信息通知国家节点。接口调用流程见图5，接口参数见附录F，示例参见附录G。图5文件推送接口调用流程图HJ1294—202387.3.2文件提取接口地方节点从国家节点提取数据时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问文件提取接口，将所需文件的元数据保存至地方节点数据库，同时，根据文件元数据信息中的文件下载地址，获取文件实体，并将文件实体存储至地方节点磁盘阵列；c）通过消息中间件将提取信息通知国家节点。接口调用流程见图6，接口参数见附录F，示例参见附录G。图6文件提取接口调用流程图7.4空间服务信息接口7.4.1空间服务信息注册接口地方节点向国家节点注册空间服务信息时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问空间服务信息注册接口，将空间服务信息注册至国家节点；c）通过消息中间件将注册信息通知国家节点。接口调用流程见图7，接口参数见附录H，示例参见附录I。HJ1294—20239图7空间服务信息注册接口调用流程图7.4.2空间服务信息提取接口地方节点从国家节点提取空间服务信息时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问空间服务信息提取接口，从国家节点数据库获取所需数据，存储至地方节点数据库；根据获取的空间服务地址，查看空间服务信息；c）通过消息中间件将提取信息通知国家节点。接口调用流程见图8，接口参数见附录H，示例参见附录I。图8空间服务信息提取接口调用流程图HJ1294—2023107.5视频信息接口7.5.1视频信息注册接口地方节点向国家节点注册监控视频信息时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问视频信息注册接口，最后将本地监控视频采集端的视频流地址等信息注册至国家节点；c）通过消息中间件将注册信息通知国家节点。接口调用流程见图9，接口参数见附录J，示例参见附录K。图9视频信息注册接口调用流程图7.5.2视频信息提取接口地方节点从国家节点提取监控视频信息时：a）通过安全验证接口获取令牌信息；b）通过令牌信息访问视频信息提取接口，从国家节点数据库获取所需监控视频采集端的视频流地址等信息，存储至地方节点数据库；根据获取的视频地址，查看监控视频；c）通过消息中间件将提取信息通知国家节点。接口调用流程见图10，接口参数见附录J，示例参见附录K。HJ1294—202311图10视频信息提取接口调用流程图8开发要求8.1字符集汉字编码采用UTF-8字符集。8.2网络通信协议支持TCP/IP协议和HTTP协议，请求方式为POST请求。8.3交换格式采用JSON格式进行数据交换。8.4消息机制消息机制应符合GB/T28168的规定。支持消息中间件，具备断点续传功能，用于消息的内容存储、持久化处理及数据库日志记录。8.5数据加密机制数据加密机制应符合GB/T32907的规定。密码及数据传输按采用SM4分组密码加密方式。8.6网络要求网络安全要求应符合GB/T22239和HJ1146的规定。a）纵向上通过生态环境业务专网实现国家和省级网络环境上下贯通，支撑生态保护红线监管数据的互联互通；b）横向上与本级电子政务网互联互通，支撑本级国土空间规划等数据交换与共享。HJ1294—202312附录A（规范性附录）接口名称表采用安全验证接口、结构化数据接口、文件接口、空间服务信息接口、视频信息接口等方式，通过消息中间件进行消息传递，实现生态保护红线监管数据的信息共享和交换传输。接口描述见表A.1。表A.1互联互通接口描述序号接口类型接口名称接口标识请求方式消息类型1安全验证接口安全验证接口loginServicePOST/2结构化数据接口结构化数据推送接口pushTableDataPOSTTABLE_DATA3结构化数据提取接口getTableDataPOST4文件接口文件推送接口pushFileDataPOSTFILE_DATA5文件提取接口getFileDataPOST6空间服务信息接口空间服务信息注册接口pushGeoServiceDataPOSTGEOSERVICE_DATA7空间服务信息提取接口getGeoServiceDataPOST8视频信息接口视频信息注册接口pushVideoDataPOSTVIDEO_DATA9视频信息提取接口getVideoDataPOSTHJ1294—202313附录B（规范性附录）安全验证接口及消息描述B.1消息参数消息结构包括消息安全验证、消息队列信息和消息输出内容等内容。消息参数见表B.1。表B.1消息参数序号参数名称参数标识类参数型说明1发送方fromString发送方账号2调用方toString调用方账号3消息通道IPmsgPathString国家生态保护红线监管平台IP4消息通道名称msgProvinceQueueCodeString例如：宁夏接收国家生态保护红线监管平台的消息通道名称为“PROVINCE_QUEUE_640000”推送至国家生态保护红线监管平台的消息通道名称为“COUNTRY_QUEUE_640000”5消息的唯一标识msgUniqueString6消息任务类型msgTypeString取值范围：TABLE_DATA：结构化数据FILE_DATA：文件GEOSERVICE_DATA：空间服务信息VIDEO_DATA：视频信息7消息体dataIDsString消息的实际内容B.2安全验证接口安全验证接口功能是为访问国家生态保护红线监管平台应用程序接口提供安全验证信息，防御未授权的用户访问国家生态保护红线监管平台数据。地方用户访问接口时，首先通过用户名和密码获取headertoken，然后将令牌添加到请求头中访问其他应用程序接口获取或推送数据，否则接口访问失败。安全验证接口参数见表B.2、B.3和B.4。HJ1294—202314表B.2安全验证接口总体描述项目描述接口名称安全验证接口接口标识loginService提供方国家生态保护红线监管平台接口地址http://国家生态保护红线监管平台IP:端口/hlhtAPP/loginsys/loginService请求参数类型application/x-www-form-urlencoded请求方式POST返回格式JSON包含操作1、通过账号、密码登录获取token2、令牌有效期为120分钟，若120分钟内未请求任何接口，则需重新登录表B.3安全验证接口请求参数序号参数标识参数名称参数类型参数说明必选/可选1userName账号String在“国家生态保护红线监管平台”中注册的用户名，通过SM4加密传输必选2password密码String在“国家生态保护红线监管平台”中注册账号对应的密码，通过SM4加密传输必选表B.4安全验证接口响应参数序号参数标识参数名称参数类型参数说明必选/可选1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选3data详细信息String登录后用户的详细信息必选4headertoken用户Token标识String登录后返回的token令牌必选HJ1294—202315附录C（资料性附录）安全验证接口参数示例C.1安全验证接口请求参数示例表C.1安全验证接口请求头描述请求头字段值X-Requested-WithXMLHttpRequestAcceptHostIP:端口Content-Typeapplication/x-www-form-urlencoded注：参考“附录B.2安全验证接口”，将数据加密后，再调用接口进行传输。表C.2安全验证接口请求体描述登录接口请求体请求地址:http://国家生态保护红线监管平台IP:端口/hlhtAPP/loginsys/loginService{"userName":"6db65a59778ab50dda183294852cfccd",SM4加密后的账号"password":"06b960b7693ae232efeee6f02812033f"}SM4加密后的密码C.2安全验证接口响应参数示例表C.3安全验证接口响应头描述响应头字段值headertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOST,OPTIONSAccess-Control-Allow-Origin注：成功登录后，将后台生成的token返回至responseHeaders或responseBody中。HJ1294—202316表C.4安全验证接口响应体描述响应体"data":{"userName":"青海省","roleName":"省"},"headertoken":"c9f9bc90faf24c518063b33e9c6859ec"HJ1294—202317附录D（规范性附录）结构化数据接口描述D.1结构化数据推送接口结构化数据推送接口功能是实现地方节点向国家节点推送并更新二维表等结构化数据的能力。结构化数据推送接口参数见表D.1、D.2和D.3。表D.1结构化数据推送接口总体描述项目描述接口名称结构化数据推送接口接口标识pushTableData提供方国家生态保护红线监管平台接口地址http://国家生态保护红线监管平台IP:端口/hlhtAPP/newHxtz/pushTableData推送消息类型TABLE_DATA请求参数类型application/json请求方式POST返回格式JSON包含操作1、将token信息放入请求头中的headertoken中2、调用接口，推送并更新结构化数据3、将消息信息发送给国家节点表D.2结构化数据推送接口请求参数序号参数标识参数名称参数类型参数说明必选/可选1tableDataList结构化数据列表String结构化数据列表参考HJ1144必选2tableDataType结构化数据类型String结构化数据类型参考HJ1144必选表D.3结构化数据推送接口响应参数序号参数标识参数名称参数类型参数说明必选/可选1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选D.2结构化数据提取接口结构化数据提取接口功能是实现地方节点从国家节点提取二维表等结构化数据的能力。结构化数据提取接口参数见表D.4、D.5和D.6。HJ1294—202318表D.4结构化数据提取接口总体描述项目描述接口名称结构化数据提取接口接口标识getTableData提供方国家生态保护红线监管平台接口地址http://国家生态保护红线监管平台IP:端口/hlhtAPP/newHxtz/getTableData接收消息类型TABLE_DATA请求参数类型application/x-www-form-urlencoded请求方式POST返回格式JSON包含操作1、将token信息放入请求头中的headertoken中2、调用接口，提取更新的结构化数据3、将消息信息发送给国家节点表D.5结构化数据提取接口请求参数序号参数标识参数名称参数类型参数说明必选/可选1tableDataList结构化数据类型String结构化数据标识必选2code行政区代码String行政区代码必选3year结构化数据年份String年份集合用逗号分隔可选表D.6结构化数据提取接口响应参数序号参数标识参数名称参数类型参数说明必选/可选1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选3data详情信息String数据提取结构参考E.2.3必选HJ1294—202319附录E（资料性附录）结构化数据接口参数示例E.1结构化数据推送接口示例E.1.1结构化数据推送消息示例表E.1结构化数据推送消息描述完成数据入库后，推送至国家生态保护红线监管平台ActiveMQ消息示例{msgUnique=7cf2a4775d2246de8e81f692681656eb,消息唯一标识msgType=TABLE_DATA,业务类型标识dataMsgs={消息描述data:项目审批数据,执行成功,共入库1条数据},dataNums=1,推送数据个数userName=新疆维吾尔族自治区,行政区名称code=650000,行政区代码pushtime=2020-08-0713:00:00,推送时间status=1执行状态：0失败，1成功}E.1.2结构化数据推送接口请求参数示例表E.2结构化数据推送请求头描述请求头字段值X-Requested-WithXMLHttpRequestheadertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Accept-Encodinggzip,deflateConnectionkeep-aliveContent-Typeapplication/x-www-form-urlencodedAccess-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginHJ1294—202320表E.3结构化数据推送请求体描述结构化数据推送请求体请求地址：http://国家生态保护红线监管平台IP:端口/hlhtAPP/newHxtz/pushTableData"tableDataType":"HXMJTZ",结构化数据类型编码"tableDataList":[数据集合{"code":"650000",行政区代码"year":"2020",台账年份"allInfo":"{\"LYGTMJKM2\":\"6668.59\",\"LYHXMJKM2\":\"856.17\",\"LYHXMJZB\":\"0.12838845992931\",\"LYHXTBSLG\":\"7\",\"HXMC\":\"喀什噶尔河-叶尔羌河流域防风固沙生态保护红线区\",\"HXLX\":\"防风固沙\",\"STXTYZBLXLD\":\"\",\"BZ\":\"\"}"该条记录JSON数据}]E.1.3结构化数据推送接口响应参数示例表E.4结构化数据推送响应头描述响应头字段值HostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginContent-Typeapplication/json;charset=UTF-8表E.5结构化数据推送响应体描述结构化数据推送响应参数{"msg":"执行成功,共入库1条数据",消息描述"status":1执行状态}E.2结构化数据提取接口示例E.2.1结构化数据提取消息示例HJ1294—202321表E.6结构化数据提取消息描述接收国家生态保护红线监管平台ActiveMQ消息{msgUnique=7cf2a4775d2246de8e81f692681656eb,消息IDmsgType=TABLE_DATA,消息类型dataMsgs={code:LYHXTZ数据编码year:2020,2021数据年份},pushtime=2020-08-0713:00:00,推送数据时间status=1执行状态：0失败，1成功}E.2.2结构化数据提取接口请求参数示例表E.7结构化数据提取请求头描述请求头字段值X-Requested-WithXMLHttpRequestheadertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Connectionkeep-aliveContent-Typeapplication/x-www-form-urlencodedAccess-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-Origin表E.8结构化数据提取请求体描述结构化数据提取请求体请求地址：http://国家生态保护红线监管平台IP:端口/hlhtAPP/newHxtz/getTableData"pageNo":1,页数"pageSize":500,每页条数"code":"110000",行政区代码"tzCode":"LYHXTZ",数据编码"year":"2020,2021"台账年份E.2.3结构化数据提取接口响应参数示例HJ1294—202322表E.9结构化数据提取响应头描述响应头字段值HostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginContent-Typeapplication/json;charset=UTF-8表E.10结构化数据提取响应体描述结构化数据提取响应体{"msg":"执行成功","data":{数据体"lastPage":1,最后一页"navigatepageNums":[1],页数"pageSize":2,每页个数"pageNum":1,当前页数"total":2,数据总个数"pages":1,总页数"firstPage":1,开始页数"size":500,每页个数（每页最大取500条）"list":[数据集合{"allInfo":"{\"XZQYBZYQMJM2\":\"1643976000\",\"XZQZYQMJM2\":\"2027729700\",\"XZQJZYQMJM2\":\"7141567500\",\"HXNYBZYQMJM2\":\"\",\"HXNZYQMJM2\":\"\",\"HXNJZYQMJM2\":\"\"}",该条记录JSON字符串"code":"110000",行政区代码"createTime":"2020-12-28T18:38:55",数据创建时间"province":"北京市","city":"北京市","year":"2015",数据年份"tzCode":"LYHXTZ",数据编码"updateTime":"2020-12-28T18:38:55",更新时间"id":"684ef0f33c9647369f631707b2c9355a",唯一标识},{"allInfo":"{\"XZQYBZYQMJM2\":\"12147254100\",\"XZQZYQMJM2\":\"1789541100\",\"XZQJZYQMJM2\":\"2145787200\",\"HXNYBZYQMJM2\":\"\",\"HXNZYQMJM2\":\"\",\"HXNJZYQMJM2\":\"\"}","code":"110000","createTime":"2021-01-19T11:38:11","province":"北京市","city":"北京市",HJ1294—202323续表结构化数据提取响应体"year":"2015","tzCode":"LYHXTZ","updateTime":"2021-01-19T11:38:11","id":"cbc3a5761f974e7bb92753d3e7353d47",}]},"status":1}HJ1294—202324附录F（规范性附录）文件接口描述F.1文件推送接口文件推送接口功能是实现地方节点向国家节点推送文件数据的能力。文件推送接口参数见表F.1、F.2和F.3。表F.1文件推送接口总体描述项目描述接口名称文件推送接口接口标识pushFileData提供方国家生态保护红线监管平台接口地址http://国家生态保护红线监管平台IP:端口/hlhtAPP/ArcSyncHttpDownload/pushFileData推送消息类型FILE_DATA请求参数类型application/json请求方式POST返回格式JSON包含操作1、将token信息放入请求头中的headertoken中2、调用文件推送接口，向国家生态保护红线监管平台推送文件3、将消息信息发送给国家节点表F.2文件推送接口请求参数序号参数标识参数名称参数类型参数说明必选/可选1code行政区代码String行政区代码必选2file文件MultipartFile条件查询参数文件流必选表F.3文件推送接口响应参数序号参数标识参数名称参数类型参数说明必选/可选1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选F.2文件提取接口文件提取接口功能是实现地方节点从国家节点提取文件数据的能力。文件提取接口参数见表F.4、F.5和F.6。HJ1294—202325表F.4文件提取接口总体描述项目描述接口名称文件提取接口接口标识getFileData提供方国家生态保护红线监管平台接口地址http://国家生态保护红线监管平台IP:端口/hlhtAPP/proDownLoading/getFileData接收消息类型FILE_DATA请求参数类型application/json请求方式POST返回格式JSON包含操作1、将token信息放入请求头中的headertoken中2、调用接口，获取文件数据ID及下载地址3、根据下载地址，下载数据4、将消息信息发送给国家节点表F.5文件提取接口请求参数序号参数标识参数名称参数类型参数说明必选/可选1pageNo当前页数Int页码必选2pageSize显示条数Int页个数最大500必选3orderId任务名称String条件查询参数可选表F.6文件提取接口响应参数1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选3list文件列表String一个list中可以包含多个文件元信息必选HJ1294—202326附录G（资料性附录）文件接口参数示例G.1文件推送接口示例G.1.1文件推送消息示例表G.1文件推送消息示例描述完成数据入库后，推送至国家生态保护红线监管平台ActiveMQ消息示例{msgUnique=7cf2a4775d2246de8e81f692681656eb,消息唯一标识msgType=FILE_DATA,文件类型标识dataMsgs={data:执行成功,上传成功1个文件消息描述},dataNums=1,推送数据个数userName=宁夏回族自治区,行政区名称code=640000,行政区代码pushtime=2020-08-0713:00:00,推送数据时间status=1执行状态：0失败，1成功}G.1.2文件推送接口请求参数示例表G.2文件推送请求头描述请求头字段值X-Requested-WithXMLHttpRequestheadertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Accept-Encodinggzip,deflateConnectionkeep-aliveContent-Typemultipart/form-dataAccess-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginHJ1294—202327表G.3文件推送请求体描述文件推送请求体请求地址：http://国家生态保护红线监管平台IP:端口/hlhtAPP/ArcSyncHttpDownload/pushFileData"code":"640000",行政区代码"file":[file]文件实体G.1.3文件推送接口响应参数示例表G.4文件推送响应头描述响应头字段值HostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginContent-Typeapplication/json;charset=UTF-8表G.5文件推送响应体描述文件推送响应体{"msg":"执行成功,上传1个文件",消息描述"status":1执行状态}G.2文件提取接口示例G.2.1文件提取消息示例表G.6文件提取消息示例描述接收国家生态保护红线监管平台ActiveMQ消息{msgUnique=a86c1a8657184fb1830cf209558bfb08,消息IDmsgType=FILE_DATA,消息类型dataMsgs={消息体"data":[文件ID集合b830df75efdd4e40907cc0357059898a],"datatype":"文件提取",数据类型"status":1执行状态}}HJ1294—202328G.2.2文件提取接口请求参数示例表G.7文件提取请求头描述请求头字段值X-Requested-WithXMLHttpRequestheadertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Accept-Encodinggzip,deflateConnectionkeep-aliveContent-Typeapplication/x-www-form-urlencodedAccess-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-Origin表G.8文件提取请求体描述文件提取接口请求体请求地址：http://国家生态保护红线监管平台IP:端口/hlhtAPP/proDownLoading/getFileData"orderId":"b830df75efdd4e40907cc0357059898a","pageNo":"1",页数"pageSize":"20"每页条数G.2.3文件提取接口响应参数示例表G.9文件提取响应头描述响应头字段值HostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginContent-Typeapplication/json;charset=UTF-8表G.10文件提取响应体描述文件提取接口响应参数{"msg":"执行成功","data":{数据体"lastPage":1,最后一页"navigatepageNums":[1],页数"pageSize":1,每页个数"pageNum":1,当前页数"total":1,数据总个数HJ1294—202329续表文件提取接口响应参数"pages":1,总页数"firstPage":1,开始页数"size":20,每页条数（每页最大取20条）"list":[数据集合{"orderId":"b830df75efdd4e40907cc0357059898a",订单ID"code":110000,行政区代码"dataId":"b26132d856d011eb9d050050569f6212",数据ID"downurl":"/download/downloadFile?fileURL=local/北京市/2021YSWTXF/GF1_PMS1_E95.3_N31.9_20201029_L1A0005222874.tar",下载地址"dataDownNum":1,数据下载个数"datatype":"GF1",数据类型"detailsId":"b26132d856d011eb9d050050569f6214",订单详情ID"dataName":"GF1_PMS1_E95.3_N31.9_20201029_L1A0005222874.tar",数据名称"datasize":"1.4Gb",数据大小"downSt":"2021-01-1300:00:00",下载开始时间"downEt":"2021-01-3100:00:00",下载截止时间"province":"北京市",省份名称"orderName":"数据订单20210113",订单名称}]},"status":1}HJ1294—202330附录H（规范性附录）空间服务信息接口描述H.1空间服务信息注册接口空间服务信息注册接口功能是实现地方节点向国家节点注册空间服务地址及服务信息的能力。空间服务信息注册接口参数见表H.1、H.2和H.3。表H.1空间服务信息注册接口总体描述项目描述接口名称空间服务信息注册接口接口标识pushGeoServices提供方国家生态保护红线监管平台接口地址http://国家生态保护红线监管平台IP:端口/hlhtAPP/ResourcesData/pushGeoServices推送消息类型GEOSERVICE_DATA请求参数类型application/x-www-form-urlencoded请求方式POST返回格式JSON包含操作1、将token信息放入请求头中的headertoken中2、调用接口，将空间服务信息注册至国家节点3、将消息信息发送给国家节点表H.2空间服务信息注册接口请求参数序号参数标识参数名称参数类型参数说明必选/可选1geoServiceList空间服务列表List<service>数据结构参考I.1.2必选表H.3空间服务信息注册接口响应参数序号参数标识参数名称参数类型参数说明必选/可选1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选H.2空间服务信息提取接口空间服务信息提取接口功能是实现地方节点从国家节点提取空间服务地址及服务信息的能力。空间服务信息提取接口参数见表H.4、H.5和H.6。HJ1294—202331表H.4空间服务信息提取接口总体描述项目描述接口名称空间服务信息提取接口接口标识getGeoServices提供方国家生态保护红线监管平台接口地址http://国家生态保护红线监管平台IP:端口/hlhtAPP/ResourcesData/getGeoServices接收消息类型GEOSERVICE_DATA请求参数类型application/x-www-form-urlencoded请求方式POST请求消息类型标识GEOSERVICE_DATA返回格式JSON包含操作1、将token信息放入请求头中的headertoken中2、调用接口，获取空间服务信息3、根据空间服务信息，查看空间服务4、将消息信息发送给国家节点表H.5空间服务信息提取接口请求参数序号参数标识参数名称参数类型参数说明必选/可选1serviceCodeList服务编码标识List<String>空间服务列表必选表H.6空间服务信息提取接口响应参数序号参数标识参数名称参数类型参数说明必选/可选1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选3data详情信息String数据结构参考I.2.3必选HJ1294—202332附录I（资料性附录）空间服务信息接口参数示例I.1空间服务信息注册接口示例I.1.1空间服务信息注册消息示例表I.1空间服务注册消息示例描述完成数据入库后，推送至国家生态保护红线监管平台ActiveMQ消息示例{msgUnique=7cf2a4775d2246de8e81f692681656eb,消息IDmsgType=GEOSERVICE_DATA,数据类型dataMsgs={数据信息data:执行成功,注册成功1条服务},dataNums=1,数据个数userName=重庆市,行政区名称code=500000,行政区代码pushtime=2020-08-0713:00:00,注册时间status=1执行状态：0失败，1成功}I.1.2空间服务信息注册接口请求参数示例表I.2空间服务信息注册请求头描述请求头字段值X-Requested-WithXMLHttpRequestheadertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Accept-Encodinggzip,deflateConnectionkeep-aliveContent-Typeapplication/x-www-form-urlencodedAccess-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginHJ1294—202333表I.3空间服务信息注册请求体描述空间服务注册请求体请求地址：http://国家生态保护红线监管平台IP:端口/hlhtAPP/ResourcesData/pushGeoServices{"geoServiceList"：[{"province":"重庆市",行政区名称"code":"500000",行政区代码"serviceName":"2020年重庆市2米卫星遥感影像地图服务",服务名称"serviceType":"卫星遥感",业务类型"serverType":"WMTS",服务类型"serviceText":"2020年重庆市2米卫星遥感影像地图服务",服务描述"serviceAddress":"http://IP:端口/arcgis/rest/services",服务地址"unit":"重庆市生态环境大数据应用中心",提供单位"remarks":""备注}]}I.1.3空间服务信息注册接口响应参数示例表I.4空间服务信息注册响应头描述响应头字段值HostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginContent-Typeapplication/json;charset=UTF-8表I.5空间服务信息注册响应体描述空间服务注册响应参数示例{"msg":"执行成功,入库1条",消息描述"status":1执行状态}I.2空间服务信息提取接口示例I.2.1空间服务信息提取消息示例HJ1294—202334表I.6空间服务信息提取消息示例描述接收国家生态保护红线监管平台ActiveMQ消息{msgUnique=a86c1a8657184fb1830cf209558bfb08,消息IDmsgType=GEOSERVICE_DATA,消息类型dataMsgs={消息数据"data":[数据内容{"110000-WXYG-KJFW-0015",空间服务编码（行政区代码-数据类型-服务类型-编号）"110000-WXYG-KJFW-0016"}],"datatype":"空间服务",数据类型"status":1执行状态}}I.2.2空间服务信息提取接口请求参数示例表I.7空间服务信息提取请求头描述请求头字段值X-Requested-WithXMLHttpRequestheadertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Accept-Encodinggzip,deflateConnectionkeep-aliveContent-Typeapplication/x-www-form-urlencodedAccess-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-Origin表I.8空间服务信息提取请求体描述空间服务提取请求体接口地址：http://国家生态保护红线监管平台IP:端口/hlhtAPP/ResourcesData/getGeoServices"serviceCodeList":["110000-WXYG-KJFW-0015"]获取到的空间服务标识I.2.3空间服务信息提取接口响应参数示例HJ1294—202335表I.9空间服务信息提取响应头描述响应头字段值HostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginContent-Typeapplication/json;charset=UTF-8表I.10空间服务信息提取响应体描述空间服务信息提取响应参数{"msg":"执行成功","data":{数据体"lastPage":1,最后一页"navigatepageNums":[1],页数"pageSize":1,每页个数"pageNum":1,当前页数"total":1,数据总个数"pages":1,总页数"firstPage":1,开始页数"size":500,每页个数（每页最大取500条）"list":[数据集合{"province":"北京市",行政区名称"code":"110000",行政区代码"serviceName":"2010年北京市水源涵养服务功能",服务名称"serviceCode":"110000-WXYG-KJFW-0015",服务编码"serviceType":"生态功能",业务类型"serverType":"WMTS",服务类型"serviceText":"2010年北京市水源涵养服务功能",服务描述"serviceAddress":"http://IP:端口/arcgis/rest/services",服务地址"unit":"生态环境部卫星环境应用中心",提供单位"remarks":""备注}]},"status":1}HJ1294—202336附录J（规范性附录）视频信息接口描述J.1视频信息注册接口视频信息注册接口功能是实现地方节点向国家节点注册监控视频信息的能力，包括视频地址及视频详情。视频信息注册接口参数见表J.1、J.2和J.3。表J.1视频信息注册接口总体描述项目描述接口名称视频信息注册接口接口标识pushVideoService提供方国家生态保护红线监管平台接口地址http://国家生态保护红线监管平台IP:端口/hlhtAPP/ResourcesData/pushVideoService推送消息类型VIDEO_DATA请求参数类型application/json请求方式POST返回格式JSON包含操作1、将token信息放入请求头中的headertoken中2、调用接口，将监控视频信息注册至国家节点3、将消息信息发送给国家节点表J.2视频信息注册接口请求参数序号参数标识参数名称参数类型参数说明必选/可选1videoServiceList服务列表List<void>数据结构参考K.1.2必选表J.3视频信息注册接口响应参数序号参数标识参数名称参数类型参数说明必选/可选1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选J.2视频信息提取接口视频信息提取接口功能是实现地方节点从国家节点获取监控视频信息的能力。视频信息提取接口参数见表J.4、J.5和J.6。HJ1294—202337表J.4视频信息提取接口总体描述项目描述接口名称视频信息提取接口接口标识getVideoServices提供方国家生态保护红线监管平台接口地址http://国家生态保护红线监管平台IP:端口/hlhtAPP/ResourcesData/getVideoServices接收消息类型VIDEO_DATA请求参数类型application/x-www-form-urlencoded请求方式POST请求消息类型标识VIDEO_DATA返回格式JSON包含操作1、将token信息放入请求头中的headertoken中2、调用接口，获取监控视频信息3、根据视频地址，查看视频4、将消息信息发送给国家节点表J.5视频信息提取接口请求参数序号参数标识参数名称参数类型参数说明必选/可选1serviceCodeList视频信息列表List<String>视频列表信息必选表J.6视频信息提取接口响应参数序号参数标识参数名称参数类型参数说明必选/可选1status执行状态标识Int0（失败）、1（成功）必选2msg执行状态描述String执行失败、执行成功可选3data详情信息String数据结构参考K.2.3必选HJ1294—202338附录K（资料性附录）视频信息接口参数示例K.1视频信息注册接口示例K.1.1视频信息注册消息示例表K.1视频注册消息示例描述完成数据入库后，推送至国家生态保护红线监管平台ActiveMQ消息示例{msgUnique=7cf2a4775d2246de8e81f692681656eb,消息唯一标识msgType=VIDEO_DATA,消息类型dataMsgs={数据消息data:执行成功,注册成功1服务接口响应消息},dataNums=1,userName=青海省,行政区名称code=630000,行政区代码pushtime=2020-08-0713:00:00,注册时间status=1执行状态：0失败，1成功}K.1.2视频信息注册接口请求参数示例表K.2视频信息注册请求头描述请求头字段值X-Requested-WithXMLHttpRequestheadertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Accept-Encodinggzip,deflateConnectionkeep-aliveContent-Typeapplication/x-www-form-urlencodedAccess-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginHJ1294—202339表K.3视频信息注册请求体描述视频信息注册请求体示例请求地址：http://国家生态保护红线监管平台IP:端口/hlhtAPP/ResourcesData/pushVideoService{"VideoList":[数据集合{"province":"青海省","code":"630000","videoName":"青海省果洛藏族自治州玛多县野马岭",视频名称"videoText":"青海省果洛藏族自治州玛多县野马岭",视频描述"videoAddress":"http://IP:端口/live/cameraid/1000003%24/substream/1.m3u8",视频地址"unit":"青海省生态环境监测中心",提供单位"longitude":"98.083333",视频点位经度"latitude":"34.691111",视频点位纬度"remarks":""备注}]}K.1.3视频信息注册接口响应参数示例表K.4视频信息注册响应头描述响应头字段值HostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginContent-Typeapplication/json;charset=UTF-8表K.5视频信息注册响应体描述视频信息注册响应参数示例{msg:"执行成功,入库1条",消息描述status:1执行状态}K.2视频信息提取接口示例K.2.1视频信息提取消息示例HJ1294—202340表K.6视频信息提取消息示例描述接收国家生态保护红线监管平台ActiveMQ消息{msgUnique=a86c1a8657184fb1830cf209558bfb08,消息IDmsgType=VIDEO_DATA,消息类型dataMsgs={数据信息"data":[数据内容{"630000-SP-0001",视频唯一标识（行政区代码-视频-编码）"630000-SP-0002"},],"datatype":"视频信息",数据类型"status":1执行状态}}K.2.2视频信息提取接口请求参数示例表K.7视频信息提取请求头描述请求头字段值X-Requested-WithXMLHttpRequestheadertokenc9f9bc90faf24c518063b33e9c6859ecHostIP:端口Accept-Encodinggzip,deflateConnectionkeep-aliveContent-Typeapplication/x-www-form-urlencodedAccess-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-Origin表K.8视频信息提取请求体描述视频信息提取请求体接口地址：http://国家生态保护红线监管平台IP:端口/hlhtAPP/ResourcesData/getVideoServices"serviceCodeList":["630000-SP-0001"]获取到的视频服务标识K.2.3视频信息提取接口响应参数示例HJ1294—202341表K.9视频信息提取响应头描述响应头字段值HostIP:端口Access-Control-Allow-CredentialstrueAccess-Control-Allow-methodsPOSTAccess-Control-Allow-OriginContent-Typeapplication/json;charset=UTF-8表K.10视频信息提取响应体描述视频信息提取接口响应参数示例{"msg":"执行成功","data":{数据体"list":[数据集合{"province":"青海省","code":"630000","videoName":"青海省果洛藏族自治州玛多县野马岭",视频名称"videoId":"630000-SP-0001",视频编码（行政区代码-视频-编码）"videoText":"青海省果洛藏族自治州玛多县野马岭",视频描述"videoAddress":"http://IP:端口/live/cameraid/1000003%240/substream/1.m3u8",视频地址"unit":"青海省生态环境监测中心",提供单位"longitude":"98.083333",视频点位经度"latitude":"34.691111",视频点位纬度"remarks":""备注}]},"status":1}资料来源：https://www.mee.gov.cn/ywgz/fgbz/bz/bzwb/stzl/202304/t20230425_1028209.shtml
VIP
