T CAMA 33-2020 农机作业远程监管系统 平台数据交换技术规范.pdf

ICS 65 060 01 B 90 团 体 标 准 T CAMA 33 2020 农机作业远程监管系统 平台数据 交换技术规范 Data exchange technical specifications of remote supervision system for agricultural machinery operation 2020 11 01 实施 2020 09 01 发布 中国农业机械化协会 发布 T CAMA 33 2020 I 目 次 前言 II 1 范围 1 2 规范性引用文件 1 3 术语和定义 1 4 技术要求 3 4 1 通用性规范 3 4 2 数据传输方式 3 4 3 数据传输模式 3 4 4 功能实现流程 3 4 5 参数加密方法 4 4 6 数据交换接口定义 5 5 参数定义 21 5 1 作业农机与配置参数 21 5 2 农机工况参数 22 5 3 作业类型与状态参数 24 5 4 农机作业质量参数 26 5 5 农机故障参数 26 6 常量定义 27 6 1 服务状态码 27 6 2 区划级别 27 6 3 农机类型 27 6 4 作业类型 27 6 5 作业代码与名称 28 6 6 机具代码与名称 28 T CAMA 33 2020 II 前 言 本 文件 按照 GB T 1 1 2020 给出的规则起草 本 文件 由中国农业机械化协会信息化分会提出 本 文件 由中国农业机械化协会归口 本 文件 起草单位 北京农业智能装备技术研究中心 农芯科技 北京 有限责任公司 北京农 业信息技术研究中心 北京派得伟业科技发展有限公司 中国农业大学 中国农业机械化科学研究 院 北京市农业机械试验鉴定推广站 黑龙江惠达科技发展有限公司 江苏北斗卫星应用产业研究 院有限公司 北京德邦大为科技股份有限公司 本 文件 主要起草人 赵春江 杜经纬 孟志军 陈竞平 陈立平 罗长海 吴春江 张光强 王 培 吴才聪 梅鹤波 尹彦鑫 魏学礼 秦五昌 郭树霞 刘旺 张俊宁 安红艳 盛顺 胡浩 韩 兴宇 陈伏州 陈伟 陈启东 刘世达 王伟 T CAMA 33 2020 1 农机作业远程监管系统 平台数据交换技术规范 1 范围 本 文件 规定了农机作业远程监管系统平台之间进行数据交换过程中所需遵守的规范 包括术语 和定义 技术要求 常量定义和应用规范 本 文件 适用于农机作业监管场景下 多个厂商自建的农机作业远程监管系统平台之间及其与政 府管理部门建设的农机作业远程监管系统平台之间完成平台数据的交换 2 规范性引用文件 下列文件对于本文件的应用是必不可少的 凡是注日期的引用文件 仅注日期的版本适用于本 文件 凡是不注日期的引用文件 其最新版本 包括所有的修改单 适用于本文件 T CAMA 01 2017 农机深松作业远程监测系统技术要求 JT T 809 道路运输车辆卫星定位系统 平台数据交换 JB T 8574 机具产品 型号编制规则 NY T 1640 农业机械分类 3 术语和定义 下列术语和定义适用于本 文件 3 1 平台角色 platform role 根据某一次平台数据交换过程中的数据流向不同 定义以下两种平台角色 上级平台 数据流入的平台 一般指政府管理部门建设的农机远程监管系统平台 下级平台 数据流出的平台 一般指各企业自建的农机作业远程监管系统平台 政府管理部门 建设的农机作业远程监管系统平台中接入上级平台的远程监管系统平台 平台的角色定位是相对的 一个平台可以既是下级平台又是上级平台 3 2 用户信息 user s information 接口用户与接口调用相关的配置信息 包括用户名 用户权限 包括区域权限和时间权限 接口权限以及用户所属地等信息 3 3 农机静态信息 agricultural machinery static information 从事农机作业相关的 在一定时期内固定不变的终端编号 农机编号 车主信息 区划归属等 信息 T CAMA 33 2020 2 3 4 农机定位信息 agricultural machinery positioning information 由作业监测终端从导航卫星接收并发送到远程监管系统平台的 与该农机当前位置有关的信息 包括农机的经纬度 速度 方向等 3 5 农机作业动态信息 agricultural machinery operation dynamic information 由作业监测终端所装配的作业监测传感器监测到并发送到远程监管系统平台的 与该农机当前 作业相关的信息 包括作业状态 机具状态 传感器状态 对于某些作业类型 如深松作业 深翻作 业等 也可包括作业质量相关的参数 如作业深度 3 6 农机作业轨迹信息 agricultural machinery operation trace information 农机在一段时间内连续运行所产生的多个轨迹点位的集合 每个轨迹点位包括经纬度 时间 速度 方向 作业状态等信息 3 7 农机作业地块信息 agricultural machinery operation plot information 根据农机作业轨迹得出的农机作业区域轮廓信息 包括作业地块面积等属性 3 8 农机作业场景照片信息 agricultural machinery operation scene pictures 农机在作业过程中利用图像采集设备采集的 作业实况图像信息 也包括采集时间 经纬度位置 点等信息 3 9 农机作业量信息 agricultural machinery operation workload information 衡量农机作业多少的相关信息 包括作业面积 作业时长 作业里程等 3 10 农机作业质量信息 agricultural machinery operation quality information 衡量农机作业好坏的相关信息 以深松 翻 为例 包括作业平均深度 达标比等 3 11 农机工况信息 agricultural machinery condition information 由作业监测终端所装备的工况监测传感器监测到并发送到远程监管系统平台的 与该农机运行 情况相关的信息 包括农机运行信息 农机排放信息 农机故障信息等 T CAMA 33 2020 3 4 技术要求 4 1 通用性规范 4 1 1 区划级别 区划级别有省级 地市级 区县级 乡镇级 服务组织五个级别 每个级别有对应的编码 各级 别间存在从属关系 服务组织级别为农机最终归属的具体级别 服务组织一般有三种 1 合作社 大多数农机从属于合作社组织进行作业 2 村组 对于从属于个人的农机 将农机归属的村组指定为其服务组织 3 公司型服务组织 省级 地市级 区县级 乡镇级区划代码参照国家统计局最新版统计用区划代码和城乡划分代 码 服务组织的代码如下确定 1 服务组织是合作社或公司组织 使用统一社会信用代码 2 服务组织是村组 使用统计局最新版区划代码中对应的村组代码 作业监测终端在系统中的归属为具体的服务组织 上级平台与下级平台所维护的区划信息库应保持一致 4 1 2 农机和终端 规范认为一台农机最多安装一台作业监测终端 农机编号 唯一标识农机 终端编号 唯一 标识作业监测终端 4 1 3 车主信息 车主信息包括其车主的姓名和电话 不同车主的姓名可相同 即同名的情况 但电话不可相 同 即电话号码可唯一标识一个车主 一个车主名下可拥有多台农机 配备终端 但一台农机仅可属于一个车主 4 2 数据传输方式 平台间数据通信方式采用 HTTP协议 数据协议格式采用 JSON JavaScript Object Notation 字符编码使用 UTF 8 数据加密后进行网络传输 4 3 数据传输模式 根据平台数据交换过程中的数据交换发起者的区别 分为如下两种数据传输模式 模式 A 上级平台发起 调用下级平台的数据接口服务 获取下级平台数据 模式 B 下级平台发起 调用上级平台的数据接口服务 主动向上级平台推送 模式选择根据实际业务需求确定 4 4 功能实现流程 模式 A 1 账号及密钥分配 下级平台为上级平台分配账户 并根据实际需要赋予相应的权限 用户权限包括 区域权限 接口用户对归属在一定区划范围内的作业监测终端的数据在指定的时间段内拥有 调取权限 即用户的区域权限 T CAMA 33 2020 4 接口权限 允许用户访问的接口 以及使用时限 上级平台得到接口用户名 密码 数据加密密钥 用户名和密码用于接口用户身份验证 密钥 用于参数加密 2 参数加密及接口访问 上级平台对用户名 密码之外的参数进行加密 并使用分配的账号连接数据接口服务 3 结果返回 下级平台响应请求 返回相应的数据 经过上级平台所用的密钥加密数据后传输 模式 B 1 账号及密钥分配 上级平台为下级平台分配账户 并根据实际需要赋予相应的权限 用户权限包括 区域权限 接口用户对归属在一定区划范围内的作业监测终端的数据在指定 的时间段内拥 有数据推送权限 即用户的区域权限 接口权限 允许用户访问的接口 以及使用时限 下级平台得到接口用户名 密码 数据加密密钥 用户名和密码用于接口用户身份验证 密钥 用于参数加密 2 参数加密 下级平台对用户名 密码之外的参数进行加密 并使用分配的账号连接数据接口服务 3 定时上传 上级平台与下级平台协定不同数据类型的上传频率 下级平台按规定的频率上传数据至上级平 台 4 结果返回 上级平台接收数据 同时返回调用结果状态信息 返回的数据同样加密处理 4 5 参数加密方法 4 5 1 加密算法 加密算法 AES 加密模式 ECB 补码方式 PKCS5Padding 密钥长度 128 加密结果编码方式 base64 字符集 UTF 8 4 5 2 加密方式 对于接口请求参数 加密用户名密码之外的业务数据 例如 usr testusr pwd testpwd para LscQhABl66pHxeb 对于接口返回结果 加密结果状态码和返回信息之外的结果性数据 例如 code 1 msg success T CAMA 33 2020 5 result LscQhABl66pHxeb 4 6 数据交换接口定义 具体设计数据交换接口的功能 确定各接口的请求参数和返回结果及功能实现逻辑 请求参数 和返回结果采用 JSON格式 字符编码 UTF 8 4 6 1 通用接口 4 6 1 1 用户配置信息查询接口 用户使用该接口查询验证用户配置信息以及接口服务状态 方法名 userinfo 请求参数 参数名称 参数类型 必填与否 参数说明 usr string 是 用户名 pwd string 是 密码 返回结果 参数名称 类 型 参数说明 code int 返回结果状态值 见下表 6 1 msg string 返回信息 user json 用户配置信息 userstatus string 用户状态 正常 禁用 异常等 usrname string 用户名称 key string 密钥 regionauthor json 用户权限 level string 区划级别名称 省 市 县 name string 区域 名称 start string 区域数据权限开始 时间 本地时间 格式 yyyy MM dd end string 区域数据权限 截止时间 本地时间 格式 yyyy MM dd isenable int 是否可用 0 不可用 1 可用 apiauthor json 接口权限 apiname string 接口名称 expiredat string 到期时间 格式 yyyy MM dd T CAMA 33 2020 6 url string 接口地址 isenable int 是否 可用 0 不可用 1 可用 4 6 1 2 区划信息查询接口 上级平台和下级平台的区划信息需统一 上级平台以国家统计局最新版行政区划分及代码为依 据维护区划信息库 下级平台通过该接口查询权限范围内的行政区划信息 方法名 adivision 请求参数 参数名称 参数类型 是否必填 参数说明 usr string 是 用户名 pwd string 是 密码 para json 否 查询参数 dlevel int 否 查询级别 见 6 2 dcode string 否 查询区划代码 返回结果 参数名称 参数类型 参数说明 code int 返回结果状态值 见 6 1 msg string 返回信息 divsn json 区划信息 code string 省代码 name string 省名称 city json 市列表 code string 市代码 name string 市名称 county json 区县列表 code string 区县代码 name string 区县名称 town json 乡镇列表 code string 乡镇代码 name string 乡镇名称 vill json 服务组织列表 T CAMA 33 2020 7 code string 服务组织代码 name string 服务组织名称 4 6 1 3 农机档案查询接口 查询用户注册的终端 农机列表 方法名 aminfo 请求参数 参数名称 参数类型 是否必填 参数说明 usr string 是 用户名 pwd string 是 密码 para json 否 查询参数 dlevel int 否 查询区划级别 见 6 2 rcode string 否 查询区划代码 amno string 否 农机编号 返回结果 参数名称 参数类型 参数说明 code int 返回结果状态值 见下表 6 1 msg string 返回信息 ls json 农机 终端列表 am json 主机信息 amno string 农机编号 主机唯一识别号 mc string 农机大类 sc string 农机小类 ptyp string 农机品目 pnam string 农机产品名称 pmod string 农机产品型号 rackid string 机架号 engnum string 发动机编号 hp int 发动机 12 小时额定功率 kw amset json 农机配置参数 T CAMA 33 2020 8 para 参数见 5 1 vme json 终端信息 mfp string 终端生产企业名称 pmod string 终端产品型号 vmeid string 终端唯一识别号 owner json 机主信息 name string 机主姓名 tel string 机主手机号 pro string 所属省代码 city string 所属市代码 county string 所属区县代码 town string 所属乡镇代码 vill string 所属服务组织代码 4 6 1 4 农机发动机 ECU 信息查询接口 查询农机发动机 ECU 信息 方法名 ecuinfo 请求参数 参数名称 参数类型 是否必填 参数说明 usr string 是 用户名 pwd string 是 密码 para json 否 查询参数 amno string 否 农机编号 返回结果 参数名称 参数类型 参数说明 code int 返回结果状态值 见下表 6 1 msg string 返回信息 ecuinfo json ecu 信息 vmeid string 终端编号 T CAMA 33 2020 9 mfp string ECU 厂商 mod string ECU 型号 serial string ECU 序列号 4 6 2 模式 A 上 级 平 台 上 级 平 台 下 级 平 台 下 级 平 台 接 口 调 用 接 口 调 用 数 据 返 回 数 据 返 回 4 6 2 1 农机位置及工况信息查询接口 查询农机的最新位置信息 终端在线时 获取的是终端的实时数据 未在线时 获取的是终端 在线时最后一次上传的数据 方法名 amlocation 请求参数 参数名称 参数类型 必填与否 参数说明 usr string 是 用户名 pwd string 是 密码 para json 是 参数信息 p1 string 否 农机编号 不传此参数时 查询用户 拥有权限的全部农机信息 p2 int 否 是否请求作业状态数据 0 不请求 1 请求 默认 0 p3 int 否 是否请求工况数据 0 不请求 1 请求 默认 0 p4 int 否 是否请求故障信息 0 不请求 1 请求 默认 0 返回结果 参数名称 参数 类型 参数说明 code int 返回结果状态值 见下表 6 1 msg string 返回信息 ls json 数据内容 v1 string 终端编号 T CAMA 33 2020 10 v2 string 定位时间 UTC 时区 格式 yyyy MM dd HH mm ss 例 2017 09 08 13 25 36 v3 int 是否已采集图片 0 无图片 1 有图片 pos json 农机位置信息 p1 double 经度 WGS84 坐标系 保留 8位小数 p2 double 纬度 WGS84 坐标系 保留 8位小数 p3 double GNSS 速度 km h p4 int 0 不可用 1 单点定位 2 差分定位 3 无效 PPS 4 实时差分定位 5 RTK FLOAT 6 正在估算 p5 double 水平精度因子 p6 int 海拔高度 m p7 int 正在使用的卫星数量 p8 int 定位状态 0 未定位 1 定位 p9 double 航向 0 360 job json 作业状态信息 j1 int 作业类型 见 6 4 par 作业状态参数编号 见 5 3 cond json 农机工况信息 par 工况参数 见 5 2 error json 错误代码 par 故障参数 见 5 3 4 6 2 2 农机轨迹信息查询接口 查询农机某一天的轨迹数据 方法名 amtrace 请求参数 T CAMA 33 2020 11 参数名称 参数类型 必填与否 参数说明 usr string 是 用户名 pwd string 是 密码 para json 是 参数信息 p1 string 是 农机编号 p2 string 是 作业日期格式为 yyyy MM dd 例 2018 09 08 p3 int 否 作业类型码 见 6 4 p4 int 是 是否请求作业状态数据 0 不请求 1 请求 默认 0 p5 int 是 是否请求工况数据 0 不请求 1 请求 默认 0 p6 int 是 是否请求故障信息 0 不请求 1 请求 默认 0 返回结果 参数名称 参数 类型 参数说明 code int 返回结果状态值 见下表 6 1 msg string 返回信息 ls json 数据内容 v1 string 终端编号 v2 string 定位时间 UTC 时区 格式 yyyy MM dd HH mm ss 例 2017 09 08 13 25 36 v3 int 是否已采集图片 0 无图片 1 有图片 pos json 农机位置信息 p1 double 经度 WGS84 坐标系 保留 8位小数 p2 double 纬度 WGS84 坐标系 保留 8位小数 p3 double GNSS 速度 km h p4 int 0 不可用 1 单点定位 2 差分定位 3 无效 PPS 4 实时差分定位 5 RTK FLOAT 6 正在估算 p5 double 水平精度因子 p6 int 海拔高度 m p7 int 正在使用的卫星数量 p8 int 定位状态 0 未定位 1 定位 T CAMA 33 2020 12 p9 double 航向 0 360 job json 作业状态信息 j1 int 作业类型 见 6 4 par 作业状态参数编号 见 5 3 cond json 农机工况信息 par 工况参数 见 5 2 error json 错误代码 spn int 可疑参数编号 fmi int 故障类型 cm int SPN 转换模式 oc int 当前故障计数 4 6 2 3 农机作业量信息查询接口 查询农机作业量数据 说明 接口提供两种查询方式 1 查询单台终端单天的作业记录 p7参数传 1 2 查询区域统计值 p7参数传 2 作业质量用于评估农机的作业情况 查询区域统计值时不提供作业质量数据 方法名 workload 请求参数 参数名称 参数类型 必填与否 参数说明 usr string 是 用户名 pwd string 是 密码 para json 是 参数信息 p1 string 否 农机编号 p2 int 否 查询区划级别 见 6 2 p3 string 否 查询区划代码 p4 string 是 查询起始日期 格式为 yyyy MM dd p5 string 是 查询截至日期 格式为 yyyy MM dd p6 int 否 作业类型代码 见 6 4 T CAMA 33 2020 13 p7 int 是 1 查询终端作业记录 2 查询统计值 p8 int 否 是否请求作业质量数据 0 不请求 1 请求 默认 0 返回结果 参数名称 参数 类型 参数说明 code int 返回结果状态值 见 6 1 msg string 返回信息 ls json 作业信息 job json 农机作业信息 j1 string 农机编号 j2 string 作业日期 格式 yyyy MM dd j3 double 作业面积 亩 j4 int 作业类型代码 j5 int 作业幅宽 cm j6 string 作物代码 见 6 5 j7 string 机具代码 见 6 6 j8 double 作业时长 h j9 double 作业里程 m j10 double 空闲 非作业 里程 m j11 double 空闲 非作业 时长 h j12 double 作业地块面积 亩 qual json 作业质量信息 par 参数编号 见 5 4 4 6 2 4 农机作业图片信息查询接口 获取农机作业过程中采集的图像信息 单次获取 1张图片 图像数据以 Base64 编码格式并通过 GZIP算法压缩后进行传输 方法名 imginfo 请求参数 参数名称 参数类型 必填与否 参数说明 usr string 是 用户名 T CAMA 33 2020 14 pwd string 是 密码 para json 是 参数信息 p1 string 是 农机编号 p2 string 是 查询时间 本地时间 格式 yyyy MM dd HH mm ss 返回结果 参数名称 参数 类型 参数说明 code int 返回结果状态值 值见下表 6 1 msg string 返回信息 img json 图片数据 m1 string 图片采集时间 UTC 时区 格式 yyyy MM dd HH mm ss 例 2017 09 08 13 25 36 m2 int 图片数据长度 单位 字节 原始图片大小 非编码后大小 m3 string 图片数据 base64 编码 4 6 2 5 按点位查询作业记录接口 根据传入的经纬度坐标 查询该点在指定的轮作周期内是否已经有作业地块记录 坐标要求为 WGS84坐标系经纬度 方法名 overlaybypoint 请求参数 参数名称 参数类型 必填与否 参数说明 usr string 是 用户名 pwd string 是 密码 para json 是 参数信息 lon double 是 WGS84 坐标系经度 保留 7 位小数 lat double 是 WGS84 坐标系纬度 保留 7 位小数 startdate string 是 查询起始时间 在该日期之后的作业地块中检索是否 重叠 本地时间 格式 yyyy MM dd enddate string 是 查询截止时间 格式 yyyy MM dd jobtype int 是 作业类型码 见 6 4 T CAMA 33 2020 15 返回结果 参数名称 参数 类型 参数 说明 code int 返回结果状态值 见 6 1 msg string 返回信息 data json isoverlay int 0 无作业地块记录 1 有作业地块记录 4 6 2 6 作业地块信息查询接口 查询作业地块信息 单次查询一台农机一天作业产生的作业地块 方法名 plotinfo 请求参数 参数名称 参数类型 必填与否 参数说明 usr string 是 用户名 pwd string 是 密码 para json 是 参数信息 amno string 是 农机编号 jobday string 是 作业日期 本地时间 格式 yyyy MM dd 返回结果 参数名称 参数类型 参数说明 code int 返回结果状态值 值见下表 6 1 msg string 返回信息 plot Json 农机作业地块信息 p1 string 农机编号 p2 string 作业地块地理位置所属省 例 山东省 p3 string 作业地块地理位置所属市 例 潍坊市 p4 string 作业地块地理位置所属县 例 临朐县 p5 string 作业地块地理位置所属乡镇 例 龙岗镇 p6 string 作业地块地理位置 例 山东省潍坊市临朐县龙岗镇刘王庄 p7 string WKT 格式地块边界数据 Polygon 类型 WGS84 坐标系 T CAMA 33 2020 16 4 6 3 模式 B 上 级 平 台 上 级 平 台 下 级 平 台 下 级 平 台 数 据 推 送 数 据 推 送 4 6 3 1 终端注册接口 终端数据向平台推送数据 首先需要进行终端信息的注册 未经注册的终端数据将被过滤 无 法推送成功 支持批量上传 单次推送记录不超过 500 条 同一终端只需注册一次 方法名 regvme 请求参数 参数名称 参数类型 是否必填 参数说明 usr string 是 用户名 pwd string 是 密码 ls json 是 主机 终端信息 am json 是 主机信息 amno string 是 农机编号 农机唯一识别码 mc string 是 农机大类代码 见 6 3 sc string 是 农机小类代码 见 6 3 ptyp string 是 农机品目代码 见 6 3 pnam string 是 农机产品名称 pmod string 是 农机产品型号 rackid string 否 机架号 engnum string 否 发动机编号 hp int 是 发动机 12 小时额定功率 kw amset json 否 农机配置参数 para 否 参数见 5 1 vme json 是 终端信息 mfp string 是 终端生产企业名称 pmod string 是 终端产品型号 vmeid string 是 终端唯一识别码 owner json 是 机主信息 T CAMA 33 2020 17 name string 是 机主姓名 tel string 是 机主手机号 pro string 是 所属省代码 city string 是 所属市代码 county string 是 所属区县代码 town string 是 所属乡镇代码 vill string 是 所属服务组织代码 返回结果 参数名称 参数类型 参数说明 code int 返回结果状态值 见下表 6 1 msg string 返回信息 4 6 3 2 发动机 ECU 信息注册接口 注册农机发动机 ECU信息 支持批量上传 单次推送记录不超过 500条 方法名 regecu 请求参数 参数名称 参数类型 是否必填 参数说明 usr string 是 用户名 pwd string 是 密码 ls json 是 ECU 信息 vmeid string 是 终端编号 mfp string 是 ECU 厂商 mod string 是 ECU 型号 serial string 是 ECU 序列号 返回结果 参数名称 参数类型 参数说明 code int 返回结果状态值 见下表 6 1 msg string 返回信息 4 6 3 3 农机位置及工况推送接口 该接口用于接收终端最新的位置 作业状态 工况 故障信息 支持批量推送 单次推送的终 端位置信息不能超过 500条 T CAMA 33 2020 18 注 有工况数据上传时 必须同时上传位置信息 方法名 ampos 请求参数 参数名称 参数类型 是否必填 参数说明 usr string 是 用户名 pwd string 是 密码 ls json 是 数据内容 v1 string 是 终端编号 v2 string 是 定位时间 UTC 时区 格式 yyyy MM dd HH mm ss 例 2017 09 08 13 25 36 pos json 是 农机位置信息 p1 double 是 经度 WGS84 坐标系 保留 8位小数 p2 double 是 纬度 WGS84 坐标系 保留 8位小数 p3 double 是 GNSS 速度 km h p4 int 是 0 不可用 1 单点定位 2 差分定位 3 无效 PPS 4 实时差分定位 5 RTK FLOAT 6 正在估算 p5 double 是 水平精度因子 p6 int 是 海拔高度 m p7 int 是 正在使用的卫星数量 p8 int 否 定位状态 0 未定位 1 定位 p9 double 否 航向 0 360 job json 否 作业状态信息 j1 int 否 作业类型 见 6 4 par 作业状态参数编号 见 5 3 cond json 否 农机工况信息 par 工况参数 见 5 2 error json 否 错误代码 par 否 故障参数 见 5 3 T CAMA 33 2020 19 返回结果 参数名称 参数类型 参数说明 code int 返回结果状态值 见下表 6 1 msg string 返回信息 4 6 3 4 农机作业信息推送接口 该接口用于接收终端的作业信息 终端作业以天为单位 一天内同一终端同一作业类型只有一 条作业记录 接口支持批量上传 单次推送作业记录不超过 500条 方法名 amjob 请求参数 参数名称 参数类型 是否必填 参数说明 usr string 是 用户名 pwd string 是 密码 ls json 是 作业信息 job json 是 农机作业信息 j1 string 是 终端编号 j2 string 是 作业日期 例 2017 09 08 j4 double 是 作业面积 亩 j5 int 是 作业幅宽 cm j6 int 是 作业类型码 见 6 4 j7 string 否 作物代码 见 6 5 j8 string 否 机具代码 见 6 6 j9 double 否 作业时长 h j10 double 否 作业里程 m j11 double 否 空闲 非作业 里程 m j12 double 否 空闲 非作业 时长 h j13 double 否 作业地块面积 亩 qual json 否 作业质量信息 par 参数编号 见 5 4 T CAMA 33 2020 20 返回结果 参数名称 参数类型 参数说明 code int 返回结果状态值 见表 6 1 msg string 返回信息 4 6 3 5 作业地块信息推送接口 该接口用于接收作业地块边界数据 接口支持多地块批量上传 一次上传的地块数量不超过 50 方法名 jobplot 请求参数 参数名称 参数类型 是否必填 参数说明 usr string 是 用户名 pwd string 是 密码 plot Json 是 农机作业地块信息 p1 string 是 终端编号 p2 string 是 作业日期 例 2017 09 08 p3 int 是 作业类型码 见 6 4 p4 string 是 作业地块地理位置所属省 例 山东省 p5 string 是 作业地块地理位置所属市 例 潍坊市 p6 string 是 作业地块地理位置所属县 例 临朐县 p7 string 是 作业地块地理位置所属乡镇 例 龙岗镇 p8 string 是 作业地块地理位置 例 山东省潍坊市临朐县龙岗镇刘王 庄 p9 string 是 WKT 格式地块边界数据 Polygon 类型 WGS84 坐标系 返回结果 参数名称 参数类型 参数说明 code int 返回结果状态值 见下表 6 1 msg string 返回信息 4 6 3 6 农机作业图片推送接口 该接口用于接收农机作业过程中采集的图片数据 支持批量上传 单次上传不超过 100 条图片 T CAMA 33 2020 21 记录 方法名 jobimg 请求参数 参数名称 参数类型 是否必填 参数说明 usr string 是 用户名 pwd string 是 密码 img json 是 农机作业地块信息 p1 string 是 终端编号 p2 string 是 图片采集时间 UTC 时区 格式 yyyy MM dd HH mm ss 例 2017 09 08 13 25 36 p3 int 是 图片数据长度 单位 字节 原始图片大小 非编码后大小 p4 string 是 Base64 编码图片数据 返回结果 参数名称 参数类型 参数说明 code int 返回结果状态值 见下表 6 1 msg string 返回信息 5 参数定义 以下列举了部分常见农机配置参数 农机工况参数 农机作业状态参数 农机作业质量参数和 农机故障参数 参数表可依据实际需求扩展 5 1 作业农机与配置参数 农机配置参数与具体的农机类型相关 常用的农机配置参数如下表 农机 品目名称 参数 说明 轮式拖拉机 S0101 驱动轮数 2轮 4轮 自走轮式谷物联合收割机 S0201 喂入量 kg s 自走式玉米收获机 S0301 形式 摘穗型 摘穗剥皮型 S0302 收获行数 S0303 幅宽 m 水稻插秧机 S0401 行数 T CAMA 33 2020 22 S0402 幅宽 m 喷药机 S0501 喷头数量 S0502 幅宽 m 5 2 农机工况参数 常用农机工况 C1 农机 ECU 工况信息 编号 参数 单位 编号 参数 单位 C101 发动机转速 rpm C102 发动机实际扭矩百分比 C103 当前转速下负荷百分比 C104 油门踏板位置 C105 摩擦扭矩百分比 C106 怠速转速 rpm C107 怠速扭矩百分比 C108 最高发动机转速 rpm C109 最高发动机转速 下 的扭矩百分比 C110 发动机工作时间 h C111 总里程 km C112 行车距离 km C113 燃油消耗总量 L C114 发动机航段耗油量 L C115 瞬时燃油经济性 Km L C116 每小时油耗 L h C117 平均燃油经济性 Km L C118 冷却水温度 C119 燃油温度 C120 机油温度 C121 涡轮增压机油温度 C122 中冷器温度 C123 环境温度 C124 进气温度 C125 发动机进气歧管温度 C126 排气温度 C127 发动机舱内部温度 C128 机油压力 kPa C129 冷却液压力 kPa C130 曲轴箱压力 kPa C131 大气压力 kPa C132 相对增压压力 kPa C133 绝对增压压力 kPa C134 曲轴箱窜气压力 kPa C135 机油液位 C136 冷却液液位 C137 PTO 状态 0 1 C138 手刹状态 0 1 C139 离合状态 0 1 C140 脚刹状态 0 1 C141 系统电压 V C142 喷油提前角 deg T CAMA 33 2020 23 C2 农机排放信息 编号 参数 单位 编号 参数 单位 C201 EGR 质量流量 Kg h C202 发动机 进气质量流量