生态环境分区管控信息平台接口规范（征求意见稿）.docx

《生态环境分区管控信息平台接口规范（征求意见稿）.docx》由会员分享，可在线阅读，更多相关《生态环境分区管控信息平台接口规范（征求意见稿）.docx（30页珍藏版）》请在课桌文档上搜索。

1、附件4HJ中华人民共和国国家生态环境标准HJ20生态环境分区管控信息平台接口规范Interfacespecificationforeco-environmenta1.zoningmanagementp1.atform（征求意见稿）20-实施20-发布生态环境部发布目次前iiI适用范国I2烷枢性引用文件13术语和定义I4缩略语25设计股则26基本要求37接口类型与内容48接D使用模式与使用要求15附录A（资料性附录接口规范示例17前言为提砌g中共中央国务院关于深入打好污染防治攻坚战的意见中共中央分公厅国务院办公厅关于加强生态环境分区管外的意见要求.指导生态环境分区管控信&平台建设.制定本标准.本

2、标准规建了生态环境分区管控信息平台接口的设计傀则、基本要求、类粗与内容、应用模式和使用要求,为生态环境分区代控信息平台接11开发和应用提供规范指导.本标席为首次发布.本标准由生态环境部环境影响评价和排放管理司、法堤与标准司、办公厅出织制订.本标准的附录A为费料性附录，本标准主要起草单位：由生态环境部环境匚程评估中心牵头.组织相关技术m位共同起草.本标准生态环境部20口年月日批准，本标准自20口年OQ月H起实施.本标准由生态环境部解择，生态环境分区管控信息平台接口规范1适用范围本标准规定了生态环境分又管IS信息平台接口的设计原则、基本要求、类型与内容、应用模式和使用要求。本标准适用于国家与地方生

3、态环境分区管控平台的应用程序接口的设计与建设,以指导生态环境分区管控相关业务数据的在现交换、互操作与协同共享,生态环境分区管控信息平台与其他业务管理及政务服务平台接口开发可照木标准执行。2规范性引用文件本标准引用了下列文件或其中的条款.凡是注明日期的引用文件,仅注日期的版本适用于本标准-凡是未注日期的引刖文件,其用新版本（包括所有的修改单）适用于本标准。GBT222392019信息安全技术一网络安全尊姒保护基本要求GBT30169地理信息葩于网络的要素瞅务GB,T35652瓦片地图服务H1.T416环境信息术谱HJ719-2014环境信息系统数据阵访间接1规范HJ729-2014环境信息系统安

4、全技术规范OGC04094OpcnG1.SWcbRaturcScniccImp1.ementationSPCCifiCatiOnOGC06042OpcnGISWebMapSerViCeIinp1.ernen1.a1.iunSpecifku1.ionOGC07057OpenGISWebM叩Ti1.eServiceImpIeinentmiiMiStandard三线取”成果数据规范（试行）环办环评（2018）18号）3术语和定义HJZT416界定的以及下列术谪和定义适用于本标准.3. 1生态环境分区管控eco-environmenta1.zoningmanagement以保际生态功能和改善环境侦量为

5、目标,实施分区域差坪化管控的环境管理出度.3.2生态环境分区管控信息平台eco-environmenta1.zoningmanagementp1.atform面向生态环境分区管控管理和应用需求，实现生态环境分区管控成果等数据的汇交、管理、共享及生态环境分区管控应用的软硬件系统,3.3接口interface侑息系统为其他使用方提供数据交换的一种方式，是由一系列功能封装后可被信史系统用户直接远程调用的软件接口。3.4安全毅证接口securityverificationinterface用户身份蛤证的应用开发规范性约定，用于安全访问生态环境分区管控信息平台提供的相关数据接口.3.5站构化数据接口st

6、ructureddatainterface根据关犍字、空间位置等条件改取牛态环境分区管控成果数据的列表清单、管投整求以及统计分析等结构化数据的应用开发煨范性约出.3.6文件推送接口1epushinter1.ace推送生态环境分区管控成果文件、支揖文件以及文件元数据信息的应用开发规范性内定.3.7空间地图服务接口spatia1.mapserviceinter1.ace提佻生.态环境分I又管控成果数据等相关地图服务访问的应用开发规范性约定.4缩珞诘下列缩略语适用于本标准.WFS：M络密索取务WMSt网络地图眼务(WcbMapScrvicc)WMTS：网络地图切片服务现范(WebMapTiIeSer

7、vice)JSON：JavaScripi内型龙示法UR1.：统一资源定位零(UniformResource1.ocator)UTF-8：以字节为单位针对Unicode可变长度的字符编码UnicodeTransformationFornw1.8-bi1.)SMI：SMI分If1.密码算法(SMIcryptographica1.gorithm)VPN：虚拟专用网络(VirtUa1.PriYateNe1.WOrk)HTTP：用文本传输例议(HyPerteX【TransferPrmsoOXM1.；可扩展标记语(Extensib1.eMarkup1.anguage)5设计原则1.1 规范性生态环境分区管

8、控信息平台接口应在接口命名、字符摒码、文本描述,数据交换格式等方面保林统-ft保生态环境分区管控信息平台接I可查找，可访问.可现制及可可操作。1.2 完整性生态环境分区首控信息平台接口必家保证业务操作的原子性，以确保数据的完整性和致性.1.3 安全性生态环境分区管控信息平台接口的保证传输对象的信息做私,宜对传输对望采用转换加密或验证等方式进行传输，生态环境分区管控信息平台接口应提供接口调用的日志记录，隔保生态环境分区管控信息各类操作可视源和监控.1.4 可扩展性生态环境分区管控倍息平台接IJ可根据业务和技术发展需求,进行接I及其功能的扩展.按U扩展时，应保持接口间的兼容性与一致性“6基本要求6

9、. 1规范性翦本要求a）按U名称应准确在达接U功能,应使用驼砰命名法,应采用UTF-8字符集：b按1.1.状态码应迸循表1：O协议消息应使用JSON格式迸行数据交换.表1接口状态码状态码晚明2400HTTP请求成功,返网的JSON数Itt赴幽史继客户端请求无效,例如请求参数带课401未通过平台眼务州（认证403讲求无权限404找不到谙求的路符或者请求的对&不存在VI1.T1.I6.1 完整性基本要求生态环境分区管控信息平台的各类接口都应该只完成一类数据处理，保证接口的易读性、易用性和数据操作处理的原子性，6.2 安全慢基本要求生态环境分区管控信息平台接口安全性应涵足接口谙求方式、接口蹿用安全性

10、、眼感数据安全性的要求。a）接口请求方式接口应支持InTPK1.文本传输通信t议,安全监证接口、结构化数据接口、文件推送接口都应采用POST方式iff求：空间地图服务接11按照规苞兼容性可果用GET诂求，b）接口调用安全性接口调用必须提供访问令牌，用标识接口调用者的身价无证，减少用户名和率码的传粕次数，J1.令牌雷要设置Yf效时限,接口提供者需要根据调用者的用户名和加密的密码/证调用者的身份权限,同时生成访问令牌.C）坡镇数据安全性应针对股监数据进行脱粒处理,调用安全验证接11时传入的密码信息应采用不怔于SMI等级的加密技术进行传输,在服务沏针对加密的用户宏码进行解析以隔“谓用接口用户身份信息

11、.6.3 4可追溯性基本要求生态环境分区管控信息平台接”提供方和接I调用方都应该记录接I请求的口志，便于快速定位弁常请求位置和推杳接口同趣.以及为后续共享服务接1.Ii1.ij用的监控和统计提供数据支撑.7接口类生与内容71接口类型生态环境分区管控侑息平台接口分为四类，包括：安全验证接U、结构化数据按U,文件推送接I和空间地图服务接口。平台可根据实际情况提供相应类别的接口,6.4 接口组成接口由四部分级成：接口地址、谙求畲数、请求方式、响应参数。其中,接口地址应包含接口的版本标见（如、1）,请求参数应定义接口访问的输入参数及参效类55.请求方式应定义访问接I获收或提交数据的方式.响陶参数应包含

12、接口阴应的状态64和返回数据的组织结构,状态码反映接口调用的病应状态,一个接口可以有一个或多个参数，每个参数需明确为必选或可选。6.5 接口内容7.3. 1安全验证接口安全险证接口用于结构化数据接口、文件推送接口、空间堆图服务接口调用的身份安全脱证，通过用户名和密码获取加密字符串令牌（Wken）,实现应用程序接11的安全访问.安全验证接口用于生成用户身份的底的token,以及返I可区分不同用户身份的凭证appKey.以实现各类应用程序接口的安全访问。具体内容包含接口总体描述、接口请求参数说明和响应与数说明见表2表4,接口示例卷见附录A.1。表2安全验证接口总体描述接口名称安全验证接口接口地址M

13、tpMB务SIRecvhapivI/AuthScrviccrtogin请求卷数类不叩P1.iemiMjSan追求方式POST物应参数类型JSON接口描述I.通过IK号和加密密码。录佚取IOkm和用户相X处2、令牌仃效期为120分林.并120分林内未请求任何接口.则;，重新登求3安全蕤证接口请求参数说明序当参攻标识卷数名祢必出可选多攻类型参数说明1UMrrNaine用户账号必选字符型训用方的用户名2pcvsWord密田必选字符型盟用方注幽长“对吨的密码通过加澎传输表4安全险证接口响应叁数说明字号警致标识叁数名称必选何逸叁效类型参数说明Icode执行状态标识必选字符型HTTP请求的状态码2msg执

14、行状态描述必选字符型返回搭迷3IhhI用户信息必选字符型用户的身份僧息4tokenIII/token标识选字符型会业后迄问的“km令网7. 3.2结构化数推接口结构化数据接口主要用于获取生态环境分区管控成果数据相关的行询结果.如生态环境分区管掖成果数据的列表清单、管控要求详情等结构化致据,应至少包括狭取分区管控成果数据列表接口、根抠编码宜询管控要求详情接1、根据空间位置15询管控要求详情接1,且可根据应用需求扩展，用于获取分类统计分析等就构化数据.按照HJ719-2014中应用服务接口方式规定为用户提供应用服务接口访问生态环境分区管控信息平台的相关数据。7. 3.2.1获取生态环境分区管控成果

15、数据列表接口获取生态环境分区管持成果数据列衣接口总体描述、获取分区管拴成果数据列登接口请求参数说明.荻收分区管控成果数据列表接1.1.响应参数说明见表5表7,接口示例参见附求A2表5获取生态环境分区管控成果数据列表接口总体描述接口名称伏址生态环境分区曾控成果敢粼列我接口接口地址http3i务器IP:端Ieco,apivIgXydQUCryShMe/GcmcGkdyHj户ByCnditionSharc?KpPKCy;调用方；IPPKCy请求参数类型;IPP1.iCXiOntiM)C请求方式POST也应叁数英皇JSON接口描述将token信息故入请求头中:调用笠取生态环境分区管控成果数柢列表接”获

16、取生态环境分区管控成堤数粼列表清总包含取元编玛和名称号基础信息,表6获取分区管控成果数据列表接口请求叁皱说明序号参数标M金效名称必选/可选出数类型杂数说明IGKQF1.管拄区分类必迭字符51咨询的管拄区分类,其中：1：优先保护：2：景点管控：3：-股笆控序号参效标M参数幺称必如可选卷数类型If数说明2HJYS1.B环境燮素类别必选字符型代询的环境要索类别,其中:1生态空间t2r水IJi大气14:1堆；5：自燃；6：岸线：7：环境管拄单元:S:通海*控单元I9味声3kcyWori阳性我谢关键7必达字符31提供针对成果数据名称*馍码、管柱要求的校期依宗4WmFkId推序字段可达字符里排序字段：bm

17、、InC5SOrtRuk柞序规艰可选字符里It序规则：dewi6pagcNum语求页码必选整型致故如：17PagcSizc语求私灾记录散必选壑型取值1:IO表7荻取分区管控成果数据列表接口响应卷能说明序号卷数标识布数名移必如M选tt8!咨数说明Icode执行状态标识必逡字符型HTTP请求的状态种2msg执行状态描述必选字符型返回描述3data用户一息仍选字符型返回的故粼列表7.3.2.2根据编码查询管控要求详情接口根期箱码住询管控要求详情接口总体描述、根擀编码住刑管控要求详情接U请求参数说明、根据羯码查询管控饕求详情接1.1.响应参数说明见表8表10.接IJ示例参见附荥A.3我8根据嫔码查询管

18、控要求详情接口总体描述接口名称根据笫码代谢肾控要求详情接”接口地址hup:股务JKIP:iSI1.,eru,ax,vb,SxyJQuerySharv.,Ge(F1.jy(ikdyInfoBjBinShaiu?SppKey=调用方JMPP1.Sy请求参政类中a)ptica(ionjson谛求方式POST附梗卷数类型JSONIgn1.fiifiK将token伯息放入请求头中;2、调用根据编码代沏泊拉饕求洋债接【1，在取核生态环境分区的库钿1湾挖嬖求信.表9根据编码查询管控要求详情接口请求数说明序号参数标M卷故幺称必加可选参数类型舂数说明IDYBM唯元设附必选字符中提供曾对生态环境分区独码的精曲机农

19、表10根据编码查询管控要求详情接口响应参数说明字号警数标识落数名称必选何选答数类组警数说明Icode执行状态标双必选字符型IrrTP请求的状态吗2m%g执行状态婚述必达字符型返回描述序号参数标识参数幺林必出可选参数类案t说明3data用户一息仍选字符型返回的故粼列表7.3.2.3根据空间位置查询管控要求详情接口根据空间位置查询管控要求详情接1.1.总体描述、根据空间位置查闻管控要求详情接U请求金数说明,根据空间位置查询管控要求详情接1.1.响应咨教说明见表】1表13.接口示例参见附录A.4表11根据空间位为查询管控要求详情接口总体描述依口名称根据空间位？!音r管控要求详侪接口接IUtiJiI请

20、求参检类小hpftt务38IPJWIbc=W1.1.h叩PKe)app1.icuio,Json请求方式POST科应参数类型JSON接口描述1.将token信息放入请求头中I2,调川根据中间他置奇询竹投,空求详情接口,获取该生密环境分1*的徉细管控也:求信忍.表12根据空间位置查询管控要求详情接口请求参数说明序与参政标识参数幺称必迎可选等攻癸型参数说明IIun经IJ必选浮点型数字川丁校本相关数掂的项H位置注度.呆用CGCS2000坐标系的十道制衣示.2IX纬Itt必选浮点型数字用了依索相关数如的项目侦世纬度.果用CGCS2000型标系的十送制&示表13根据空间位置查询管控要求详情接口响应缘数说明

21、序号参数标识畲数名林必出可选叁数类察参St说明1CodC执行状态标识必选字符型HTTP请求的状态码2nwg执行状态描述必送字符型返W描述3data用户信息选字符型返回的数据列表7.3.3文件数据接口7.1 3.1文件椎送接口文件推送接口用干推送各类等结构化、半结构化文件，主要包括成果矢依文件、研究报告、图集等各类文件，可根据应用需求扩展，用于获取生态环境分区管控相关资料文件。文件推送接口具体内容包含接口总体描述、接口请求参数说明和响应参数说明见表14-&16,其中d4aType按照附录.14进行定义。接口示例卷见附录A.5,表14文件推送接口总体描述按口名称文件推送接口按口地址http:服务S

22、SIRf0cco,aivIFi1.cShareFikUp1.oa(f7apKeytff1.1.7/3PPKCy推送消息类里F1.1.E_DATA接口名称文件推送接口请求参数类格app1.k：ii1.ion.pon谙求方式POST峋应参数类型JSON接口擒述1.将IOkCn信明收入请求头中I2、词用文件推送接口,进行文件流和文件元数据信.以推送.表15文件推送接口请求叁数说朗序号叁致标识辱效幺林必电可叁数类31畚i说明1rcgionCodc数据推送单位所属行政区划代科必选字符型效幅推送整位的所M行政区划代码2krtaPvidcr数据提供部门举位必选字符型效1提供部门单位311=1.0.(Mcrc

23、p1.icationi%on请求方式GET/POST响应放类型XM1.按口描述k将token佰患放入请求买中t2.避用网络地图切片服务-元牧掘接口.获取网络地用切片服务的元数据信息.表21元数据接口请求曲数说明序号舂数标M叁数幺称必选/可选1WrVkx服务类51必选地图切片服务央型的标识.to：WMTS2request操作类型必选接1的请求标in，to：Gciaipbi1.ities3vwion版本号必选地图切片服务遵册的版本狗1:IXhO表22元数据接口响应结果-图层参数说明序号一数标M参数名林必选何选卷数说明1OwvIdcndGer堆标识必选图层的唯一描述,同一IH务内不可至红2035：T

24、iUC标侬必选图m的标虺3forma1.切片格式必选切片数据存Wi格式,栅格切片可以妁peg、png等格式矢景切片,J以xmRjson等格式4ows:BoundingBox投彬坐库空向范W必选图层的最小越络矩形,按照投影典标表示5OW力:CGCS200(HiOUndinXBOX地理坐标空间范国必选图层的最小包络斑形,按照地理坐标表示6Myk样式必选图将使的样式,包括嚷一翻队标甥、播述殍7Ii1.cMiitrixSc1.Unk切片矩阵生乳接必选图层对应的切片矩阵集堆标识8IVNDUiveUR1.描述可选切片坳图请求的UR1.校板表23元数娓接口响应结果-切片矩阵集参数说明；序号II2-数标识us

25、JdcMfierScaIcDenominucor!参效幺移唯一标IR切片矩阵对应比例尺分母必选何选参数说明必选切片矩阵的唯一标识，同-显务内不可?fiI1.我送IZ1.片始为在对应地图纭别卜的比例尺分母3Iop1.cfiConKr切片起始点切片矩阵左上角力置在坐标参照系下的坐标.如|按照经纬度投财.以卜18(WOI作为切片起必培始点进行切图，映射到。行0列切片的左上角等格式，矢IH切片可以是m1.json等格式4YIiIcHcighiIU1.eWidth切H-浜离度切片像素贡度必选切片的侬素一度，如；256PiXe1.必去I切片的像素宽度,如：2S6pixe1.6InuUixfkight切片矩

26、阵高发必选切片始肉在舛林上的切片数状,以it蹴为弟位711;I1.riXWidthj切矩丙货Ig必iIW片矩阵在行轴上的切片如.以计敷为单位7.3.4.1.2地图切片接口地图切片接口且体内容包含接口总体描述、接I1.请求参数说明和响应参数说明见衣24-表25.地图切片接口响应结果为地图瓦片.接口示例参见附录A.8.我24地图切片接口总体描述接口名称M络地图切片服务-地图切片拉【】接口地址hiip:，IH务IPM1.1.ZZmagH股务名称wm*aKcy二闻IJ方邛PKCyievctf-W!1.SAcvqeU=GeCikh)vr-OiH1.y1.e=defaukAtiIcMairixSci=dc

27、huh(i1.cMa(f1.X=10&(i1.cRow=9&ti1.cCo1.=8Rxnat=imac.,png请求般数类型3pp1.catiovjson谛求力式GEI.W)S科应参数类51图片接口描建1 .将IDkm信息放入谓求头中：2 .词用网络地图切片收务地图切片接口，狭IRIW络也图切片服务的地图瓦片,表25地图切片接口请求叁钦说明字号参数标iH参数名称必电CI选也数说明IMrrViCe眼务类型必选地图切片服务类小的标识.to.WMTS2request操作类中必选接口的请求标识.1：Ge11ie3version板本9必选地图切片服务避牯的版本SB、；.:1.0.041.ayer图层怡总

28、必选图层的唯一标1.11,I1:VCC5M,C国展样式必造图所的样K信息.defau1.t6forma1.切片地图的*出格式心地逐网数据的存储格式.:png7IiIeMa1.rixSe1.切片矩阵数出象必达切片的矩阵集合8Ii1.eMatrix切片矩阵我透对应切片矩阵标识9川CROW我示切片矩阵的行号仍选对应切片行号10IiIcCoI衣示切片矩阵的列号必选对应切片列号7.3.4.2网塔地图服务接口7.3.4.2.1元锹框接口元数擀接【具体内容包含接口总体描述.接口请求参数说明和响应参数说明见表26-表28.元数据接口响应结果为文档,主要内容为操作请求元数据节点信息描述了网络地图服务的图层列农信

29、息.接口示例参见附录A.9.表26元数据接口电体描述接口名称网络地图版务元数据接口接口地址h1.p:服务器IP:瑙I1.1.CCQnap俅务N移/wm、?叩PKCy=调用方;ippKey&scn,icc=WMSversion=1.3.Orcqiies1.=GctcapuibiIi1.iw请求参政类里ajp1.icaion,json请求方式GET.POST接口名称网络地图眼务元数据接口响应参敏类型XM1.接口描述1、格Nken伯息放入请求头中：2、调用冏络胞图服务次推核”.获取网络地图IH务的无数如信息.表27元数据接口请求叁锹说明字号参数标M格效幺称必选/可选参数说明IMrnice服务类?H必

30、选网络地图1务类型的标识.1:WMS2request煤作类型必选接口的请求标取,如：GctCapabiIities3vewion版本号必选网络地图股务遵循的版本Jft号，如：13.0*28元数据接口响应结果-图层参数说明字号参数标识参数名粽必选何选SftiHInaxe图层名称可选图层名称tit1.e标识修选图层依息简写3MS空间咨考可送佃所的空间卷考系统4borxiingox指定坐标空间莅固可选图层的M小包络矩形,按照指定坐标表示7.3.4.22地图数娓接口地图数抠接口具体内容包含接口总体描述、接口请求参数说明和响应参数说明见表29-表30.地图数据接口响应结果为动态地图，其空间参考、空间范围

31、、透明度等信息5请求参数一致.接口示例参见附录A.10.我29地图数据接口总体描述，口名称网络地图服务-地图数据接Ii接口地址httpzJH务器IP：端IACEm;ip，vIH务名称Mm2appKcy=谓用方JippKeyAscnicc=WMsArcqucst=GctMapA1.avr=0ANxn=I13.642578,22.851562.113.90625.23.115234&width=512hcight=512tsH必选地图危困的边界,是-minx.miny.maxx.maxymKwidth图片宽度必选返回图片的索收，电位烟或9height图片高度必选返回图片的痛收.里也像索IOSBi空

32、间参考必选地图覆出的空间每年系统I1.InIIuPafE图片造W渡可选地图背景处否透明.值为uef曲e.MUftfaiM12co1.x图片背景色可选返回图片的背景色.我认是FFFFH,（白色）7.3.4.2.3地理要素信息接口地理耍索信息接口具体内容包含极口总体描述、接口请求参数说明见表31表33.地理要素侑息接口响应结果为文档，响应忿故说明见表33.接口示例格见附录A.11.表31地理要素信息接口总体描述接口名称M络地图用务地理要看信：目按口接口地址ImP:服务器1PMIHOC(VmaPMJ联务名称AVm叩PKey=调用方apKcy4cmmviceWMsArvques1.=Cie1.Fea1

33、.uftfInkiAquufy_h)vn.=145Aver%)n=13.1.aycn府即图层必选Kft砌的图层石,图层之间用逗号分隔5infbFormu(峋拔数类M可逸返回数据的力储格犬,Shxm1.6bbox必选地图莅IH的边界值是“mi11x.mi11y,11uxx.maxy,7width图片近度必选返H图片的变堆.冷位做索8height图片齿改必选返M图片的高度.第位可索9SS空间够否必选坳图输出的空间参考系统10fcaiurcCnStm可选最大返臼要求牧所,取值为正数，欣认为I11X横坐标必选在目标图形上进行点查询时水平方向便案例12y纵坐标必选1.1.标图形上逆行以我小时垂H方向僧索伏13excei,几何坐标CiM1.规范的几何对像7. 343网络要素服务接口8. 3.4.3.1元数据接口元数据接口具体内容包含接口总体描述、接口请求参数说明和响陶参数说明见龙34-表35.元数据接口响应结果为文档，主要内容为要素类型元数据节点，描述了网络要索果务中要素类型元数据节点信息.接I1.示例参见附录A.I2.表34元数据接口总体描述接口名称网络要索取分-元数据接口按地址hup:圾/JSIP:端口,ccNmaI烟务K仅W化?叩PKey=调H1.7/a