2 0 2 3 0 2 1 7 发 布 － － 2 0 2 3 0 6 0 1 － － 实 施 农 业 农 村 地 理 信 息 服 务 接 口 要 求 0 1 中 华 人 民 共 和 国 农 业 行 业 标 准 备 案 号 ： X X X X - X X X X Ｉ Ｃ Ｓ 3 5 . 2 4 0 . 6 8 C C S B 4 3 2 5 — 2 0 2 3 I n t e r f a c e r e q u i r e m e n t s f o r a g r i c u l t u r a l a n d r u r a l g e o g r a p h i c i n f o r m a t i o n s e r v i c e Ｎ Ｙ ／ Ｔ 中 华 人 民 共 和 国 农 业 农 村 部 发 布NY/T４３２５—２０２３ 目　　次 前言 Ⅱ 􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺 １　范围 １ 􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺 ２　规范性引用文件 １ 􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺 ３　术语和定义 １ 􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺 ４　缩略语 ２ 􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺 ５　服务分类 ２ 􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺 ６　接口基本规定 ３ 􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺 ７　服务接口要求 ３ 􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺 附录A(规范性)　服务接口框架 ６ 􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺 附录B(规范性)　服务接口API参数 ７ 􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺 参考文献 １４ 􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺􀆺 ⅠNY/T４３２５—２０２３ 前　　言 本文件按照GB/T１􀆰１—２０２０«标准化工作导则　第１部分:标准化文件的结构和起草规则»的规定 起草. 请注意本文件的某些内容可能涉及专利.本文件的发布机构不承担识别专利的责任. 本文件由农业农村部市场与信息化司提出. 本文件由农业农村部农业信息化标准化技术委员会归口. 本文件起草单位:农业农村部信息中心、北京佳格天地科技有限公司、北京超图软件股份有限公司. 本文件主要起草人:董春岩、丛小蔓、饶晓燕、李晓鹏、任艳婷、王泓霏、张振琦. ⅡNY/T４３２５—２０２３ 　 　 　农业农村地理信息服务接口要求 １　范围 本文件规定了农业农村地理信息服务分类、服务接口基本规定和服务接口要求. 本文件适用于农业农村地理信息服务接口的设计、建设、管理与应用等. ２　规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款.其中,注日期的引用文件,仅 该日期对应的版本适用于本文件;不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件. GB/T３０１６９—２０１３　地理信息　基于网络的要素服务 GB/T３５６５２—２０１７　瓦片地图服务 NY/T３９８７—２０２１　农业信息资源分类与编码 NY/T３９８９—２０２１　农业农村地理信息数据管理规范 OGC０４—０９４　网络要素服务实现规范 OGC０６—０４２　网络地图服务实现规范 OGC０７—０５７r７　开放的地理数据互操作规范网络地图瓦片服务实施标准 ３　术语和定义 下列术语和定义适用于本文件. ３􀆰１ 基础地理信息　fundamentalgeographicinformation 作为统一的空间定位框架和空间分析基础的地理信息. [来源:GB/T１３９２３—２００６,２􀆰１] ３􀆰２ 农业农村专题地理信息　agriculturalandruralgeographicinformation 与农业基础信息、农业生产、农产品加工、农业市场与流通、农村综合、农业科技与教育、农业法规与标 准、农业政务和农业农村信息化等相关且具有地理空间属性的信息. ３􀆰３ 农业农村地理信息服务　agriculturalandruralgeographicinformationservice 农业农村领域涉及基础地理信息与农业农村专题地理信息的数据,按照一定规则构建的农业农村地 图、数据和分析计算服务. ３􀆰４ 栅格瓦片　rastertile 将地图数据根据一定规则切分形成的若干栅格数据单元. ３􀆰５ 矢量瓦片　vectortile 以x,y坐标或坐标串表示的空间点、线、面等图形数据及与其相联系的有关属性数据根据一定规则 切分形成的若干矢量单元. 注:每个矢量单元对应有固定编码,可依据矢量瓦片编码将矢量瓦片重新拼接成地图以进行显示. ３􀆰６ 空间分析　spatialanalysis １NY/T４３２５—２０２３ 在对地理空间中的目标进行形态结构定义与分类的基础上,对目标的空间关系和空间行为进行描述, 为目标的相关分析提供参考,进一步为空间决策支持提供服务. ３􀆰７ 缓冲区分析　bufferanalysis 对选中一组或一类地图要素(点、线或面)按设定的距离条件,围绕其要素而形成具有一定范围的多边 形实体,从而实现数据在二维空间扩展的信息分析方法. ３􀆰８ 叠加分析　overlayanalysis 将两层或多层地图要素进行叠加产生一个新要素层的操作,其结果将原来要素分割生成新的要素,新 要素综合了原来两层或多层要素所具有的属性,并形成新的空间关系和新的属性关系. ３􀆰９ 网络数据集　networkdataset 由边线、交汇点、转弯要素和一系列属性表组成的数据集合. ３􀆰１０ 最佳路径分析　optimalpathanalysis 基于网络数据集,在指定的网络上查找一条路径,其结果为网络中两点之间阻力最小的路径. ３􀆰１１ 物流路径分析　logisticspathanalysis 基于网络数据集,给定M个配送中心和N个配送目的地(M、N为大于零的整数),查找最经济高效 的配送路径,其结果为相应的运输路线. ４　缩略语 下列缩略语适用于本文件. API:应用程序编程接口(ApplicationProgrammingInterface) B３DM:批量化三维模型(Batched３DModel) HTTP:超文本传输协议(HyperTextTransferProtocol) HTTPS:安全的超文本传输协议(HyperTextTransferProtocoloverSecureSocketLayer) JSON:JavaScript对象简谱(JavaScriptObjectNotation) OGC:开放式地理空间协会(OpenGeospatialConsortium) PBF:协议缓冲区二进制格式(ProtocolbufferBinaryFormat) PNG:便携式网络图形(PortableNetworkGraphicFormat) REST:表述性状态转移(RepresentationalStateTransfer) S３M:空间三维模型(Spatial３DModel) URL:统一资源定位符(UniformResourceLocator) UUID:通用唯一标识码(UniversallyUniqueIdentifier) WFS:网络要素服务(WebFeatureService) WMS:网络地图服务(WebMapService) WMTS:网络地图切片服务(WebMapTileService) XML:可扩展标记语言(eXtensibleMarkupLanguage) ５　服务分类 按照业务性质将农业农村地理信息服务划分为基础地理信息服务和农业农村专题地理信息服务.两 类服务应分别提供相应的API.API按照服务的性质和实现的技术划分为数据服务API、功能服务API. 农业农村地理信息服务分类见表１. ２NY/T４３２５—２０２３ 表１　农业农村地理信息服务分类 一级类目 二级类目 三级类目 服务项 基础地理信息服务数据服务 功能服务地图服务 栅格瓦片服务 矢量瓦片服务 要素服务 三维服务 空间分析服务地图服务 栅格瓦片服务 矢量瓦片服务 要素服务 三维服务 缓冲区分析服务 叠加分析服务 最佳路径分析服务 农业农村专题地理信息服务数据服务 功能服务专题数据服务 专题数据服务 地名地址服务 地名地址服务 场景图层服务 场景图层服务 信息查询服务 信息查询服务 物流路径分析服务 物流路径分析服务 ６　接口基本规定 ６􀆰１　请求协议 采用HTTP或HTTPS协议.请求方式为GET、POST、PUT或DELETE请求. ６􀆰２　数据格式 数据格式见表２. 表２　数据格式 名称 说明 JSON 空间分析接口采用此格式 XML WMS、WMTS、WFS、REST等服务的元数据访问接口返回此格式 PNG WMS、WMTS、REST等服务的栅格地图瓦片访问接口返回此格式 S３M 三维数据服务(S３M)访问接口返回此格式 B３DM 三维数据服务(３DTiles)访问接口返回此格式 ６􀆰３　接口类型 农业农村地理信息服务接口