GB/T 41187-2021 农业物联网应用服务（正式版）

GB/T41187—2021国家市场监督管理总局国家标准化管理委员会I Ⅲ1范围 12规范性引用文件 13术语和定义 1 25服务分类及要求 25.1总体分类 25.2共性基础服务 35.3专业领域服务 3 56.1服务描述 56.2服务发布要求 6 67.1调用方式 67.2响应内容 67.3服务组合 6 68.1访问控制 68.2服务质量管理 7附录A(规范性)农业物联网应用服务编码规则 8参考文献 9ⅢGB/T41187—2021本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定请注意本文件的某些内容可能涉及专利。本文的发布机构不承担识别专利的责任。本文件由中华人民共和国农业农村部提出并归口。本文件起草单位：北京农业信息技术研究中心、北京农业智能装备技术研究中心、农芯(南京)智慧学、中华全国供销合作总社北京商业机械研究所、中国电子技术标准化研究院、北京市农业局信息中心、北京市植物保护站。1农业物联网应用服务GB/T33745—2017物联网术语3术语和定义使用农业物联网数据服务、计算服务或控制服务的程序接口或应用系统。2GB/T41187—20213.7服务提供者对农业物联网应用服务接口调用的具体参数说明。3.8服务提供者向注册中心注册农业物联网应用服务或提供服务描述的过程。3.9服务调用servicecallrequest服务响应资源内容的过程。4缩略语HTTP:超文本传输协议(HypertextTransferProtocol)IEC:国际电工委员会(InternationalElectrotechnicalCommission)IETF:互联网工程任务组(TheInternetEngineeringTaskForce)ISO:国际标准化组织(InternationalOrganizationforStandardization)ITU-T:国际电信联盟电信标准分局(InternationalTelecommunicationUnion-TelecommunicationStandardizationSector)JSON:JavaScript对象简谱(JavaScriptObjectNotation)REST:表述性状态转移(RepresentationalStateTransfer)RFID:射频识别(RadioFrequencyIdentification)RMI:远程方法调用(RemoteMethodInvocation)RPC:远端程序呼叫(RemoteProcedureCall)RTP:实时传输协议(Real-timeTransportProtocol)RTSP:实时流协议(Real-timeStreamingProtocol)SOAP:简单对象访问协议(SimpleObjectAccessProtocol)TCP:传输控制协议(TransmissionControlProtocol)UDP:用户数据报协议(UserDatagramProtocol)W3C:万维网联盟(WorldWideWebConsortium)XML:可扩展标记语言(ExtensibleMarkupLanguage)农业物联网应用服务包括共性基础服务和专业领域服务，如图1所示。共性基础服务按照服务用农资流通管理服务等。专业领域服务一般由若干共性基础服务组合而成。3GB/T41187—2021果园与果园与茶园生产农产品加工流通共性基础服务畜禽养殖农产品大田生产农业资源环境监测农资领域服务农机作业控制服务数据服务计算服务设施生产采用H.264(ITU-TRec.H.264—2005)高度压缩数字视频编解码器标准；音频宜采用ITU-TRecG.711语音编码标准。传输协议宜采用RTP(IETFRFC3550、IETFRFC3984)和RTSP(IETFRFC2326)协议。图像宜采用JPEG、JPEG2000、TIFF或PNG等主流格式；音频宜采用MP3/MP3Pro、MPEG、WMA等主流格式。7235)、SOAP(W3C建议书SOAP)或WebSocket(IETFRFC6455)等协议中的一种或多种对外提供服务；宜采用XML(W3C建议书XML)或者JSON(ISO/IEC16262:2011)等数据格式，以及UTF-8计算服务应具有明确的版本信息及稳定的输入输出接口，宜采用HTTP、SOAP或者Socket等协4GB/T41187—20215.3.2设施生产服务生产管理要求。5.3.3果园与茶园生产服务果园与茶园生产服务用于各类果品或茶叶生产过程的监测、分析决策和调节控制，主要包括果园或茶园微环境监测服务、果树或茶树生理监测服务、果树或茶树病虫害监测服务、果树或茶树栽培管理决策服务、肥水药投入设备控制服务等。果园与茶园生产服务应具备准确性、可靠性、及时性，宜按果树或茶树类别分类，支持园区感知数务进行组合应用，满足果园与茶园生产管理使用要求。畜禽养殖服务用于各类畜禽养殖生产管理过程的监测、分析决策和调节控制，主要包括畜禽舍环境殖环境综合调控服务、设施设备远程控制服务等。禽养殖生产管理要求。5.3.5水产养殖服务水产养殖服务用于各类水产养殖生产管理过程的监测、分析决策和调节控制，主要包括养殖水体环养殖环境综合调控服务、设施设备远程控制服务等。产养殖生产管理要求。5.3.6农业资源环境监测服务农业资源环境监测服务用于区域农业资源环境的监测和分析决策，主要包括农用土地资源监测服与面源监测融合服务，采用大样本、多尺度数据融合等方法提升监测的准确度。5.3.7农机作业服务农机作业服务用于各类农业生产场景中农机作业的监测控制和管理调度，主要包括导航定位服务、5GB/T41187—2021模农机作业的应用需求，支持不同农机之间的互联互通与数据共享，可提升农田作业的精准化水平。5.3.8农产品加工流通服务农产品加工流通服务用于农产品在存储、加工、运输、交易等过程管理中的监测、分析决策和控制，主要包括农产品仓储管理与仓储环境测控服务、加工环境测控服务、分级分选及加工设备远程控制服加工流通全程监控服务使用要求。5.3.9农产品质量安全服务农产品质量安全服务用于农产品生产供应过程中质量安全的监测和分析决策，主要包括农产品产地信息服务、农产品生产信息服务、农产品加工信息服务、农产品流通信息服务、农产品质量监管服务、农产品质量安全追溯服务、安全应急保障决策服务等。工、储运、交易服务并获取相关数据，满足农产品生产供应全程质量安全监管及追溯使用要5.3.10农资流通管理服务农资流通管理服务用于农产品生产所需农业投入品的流通及使用过程管理与分析决策，主要包括农资流通管理服务、农资投入管理服务等。农资监管服务应具备准确性、可靠性，宜按农资产品类别分类，采用适当的个体识别技术开展农资防伪及农资投入管理服务。6服务发布6.1服务描述农业物联网应用服务应提供服务描述，服务描述信息见表1。表1服务描述信息服务参数内容名称农业物联网应用服务名称编码标识农业物联网应用服务唯一性的编码，编码规则应符合附录A的规定内容描述服务内容和服务调用关键信息请求报文样例对调用服务的参数例子说明，并可以测试返回报文样例对请求报文样例的返回说明请求报文格式定义详细描述服务调用参数含义返回报文格式定义详细描述服务返回参数含义接口业务异常列表和描述描述返回异常的说明6GB/T41187—2021表1服务描述信息(续)服务参数内容对应的服务节点提供具体服务提供者的地址节点说明监测报文(可选)可进行服务可用性的监测是否进行监测(时间，频度)对监测报文的要求备用服务地址(在连续失败或拨测失败等情况下自动或手工切换服务地址)提供备用服务提供者的地址的说明6.2服务发布要求服务出现异常时应返回错误代码。农业物联网应用服务宜采用RMI、Socket、REST或者HTTP等国际通用的服务发布方式，其中视频数据服务宜采用基于TCP或UDP的Socket协议进行发布，文本数据服务可采用WebService、HT-7服务调用服务的网络端口应定义为访问地址和端口的绑定。服务调用方和服务提供者采用同步调用的方式进行请求，如需要使用异步调用可采用消息队列或服务调用方定义异步通知接口来实现。响应内容应包含服务状态信息、处理结果信息。处理结果信息应采用通用格式，需符合相关校验规则。专业领域服务可通过调用一到多个共性基础服务组合而成，农业物联网应用系统可通过调用若干专业领域服务或共性基础服务组合而成。8服务管理农业物联网应用服务应能承受高频服务请求，或具备根据访问数据流量对服务进行访问控制的农业物联网应用服务应通过鉴权服务授予服务使用者访问权限，通过权限访问实际应用服务。同77GB/T41187—2021时宜采用必要的访问控制策略。8.2服务质量管理服务提供者和服务使用者之间宜签订服务等级协议。服务等级协议可说明服务类型、服务质量和——分配给服务使用者的最小带宽和极限带宽；——服务访问可用性； 能同时使用服务的数量：——服务数据备份或统计；——服务使用者的流量优先权；——服务提供者支持的最小网络利用性能； 在可能影响用户行为的网络变化之前的通知安排——技术支持和服务；服务提供者应监控和管理服务质量，以满足服务等级协议中的相关要求。8GB/T41187—2021(规范性)为标识农业物联网应用服务，对不同的服务进行编码。农业物联网应用服务编码由专业领域服务A.1所示。版本号顺序号共性基础服务编码专业领域服务编码图A.1农业物联网应用服务编码格式专业领域服务编码见表A.1。编码可扩展。基础服务编码见表A.2。顺序号取值001～999,区分同一领域同一类别的不同应用服务。版本号取值01～99,区分同一应用服务的不同上线版本。编码名称其他领域服务大田生产设施生产果园与茶园生产畜禽养殖水产养殖农业资源环境监测农机作业农产品加工流通农产品质量安全农资流通管理扩展编码专业领域服务编码表A.2基础服务编码编码名称组合服务数据服务计算服务控制服务基础服务编码[1]ISO/IEC16262:2011信息技