《湖南省农机作业监测系统县级平台数据接入接口要求.docx》由会员分享，可在线阅读，更多相关《湖南省农机作业监测系统县级平台数据接入接口要求.docx（14页珍藏版）》请在课桌文档上搜索。
1、湖南省农机作业监测系统（县级平台）数据接入接口要求1接口设计1.1 概述本说明描述了湖南省农机作业监测系统（以下称省平台）与县级农机作业监测系统（以下称县级平台）的作业数据的对接格式，省平台利用本说明定义的接口接收县级平台的各类农机作业数据。1.2 用户验证接口用户使用预分配的用户名和密码进行身份验证以及权限控制。1.3 数据传输请求接口使用httpPost方式提交数据，用户发送的请求和接口返回的数据统一采用JSOn格式，编码采用UTF-8编码方式。县级平台向省平台推送的位置、地块边界等与经纬度相关的数据采用WGS84参考坐标系进行处理后上传至省平台。数据上传频率要求：数据名称数据内容涉及接口
2、推送频率终端注册信息归属地信息2.1调用接口前发送位置信息某时刻数据2.2小时次作业信息作业面积统计值2.3轨迹信息数据集2.5图片信息农机图片数据集2.6地块信息地块信息统计值2.4一天一次2接口定义2.1 终端注册接口2.1.1 接口说明县级平台向省平台推送数据，首先需要进行终端信息的注册，未经注册的终端数据将被过滤，无法推送成功。注：调用此接口前，需要先将所需注册的终端归属地信息（省、市、县、镇、村/合作社）及终端厂商名称发送给管理员建立区划和终端厂商档案C2.1.2 接口地址2.1.3 出入参数定义入参：参数名称类型是否必填说明AccessIDStingY许可IDAccessPwdSt
3、ringY许可密码VM日NFOJSONY推送数据内容VMEModeIStringY终端型号OrgVMEIDStringY终端编号（最大长度16位）AmNoStringY农机牌号（例：鲁03-62765）对于没有牌号的农机可将发动机号作为农机牌号。AmTypeStringY农机类型（见附录3.1）VehicIeNumStringY农机型号（例：东方红-1504）ProNameStringY所属省CItyNameStringY所属市CountyNameStringY所属区县TownNameStringY所属乡镇ViIINameStringY所属村组/合作社OwnerNameStringY车主姓名O
4、wnerTeINumStringY车主电话出参：参数名称类型说明ResuItCodeInt结果代码(0成功；1-失败)ErrorMsgString错误信息DataObject预留，无附加数据null2.1.4 参数示例入参：用户信息参数AccessID和AccessPwd参数由链接传入：，OPost参数:VMEINFO：VMEModel:,AMT999jOrgVMEID:X,AmNo:“鲁01-3332”,AmType:04,VehicleNum:“东方红998”，ProName:山东省”,“CItyName:聊城市“，CountyName:阳谷县“，“TownName”:“侨润街道”，“Vi
5、llName：“孙膑阁农机专业合作社LOwnerNamen:孙振泰”，OwnerTelNum:)出参：ErrorMsg:null,ResultCode:0)2.2 位置信息推送接口2.2.1 接口说明该接口用于接收县级平台按分钟推送该区县所有终端位置信息，支持批量推送，单次推送的终端位置信息不能超过200条C2.2.2 接口地址2.2.3 出入参数定义入参：参数名称类型是否必填说明AccessIDStingY许可IDAccessPwdStringY许可密码VehicIePosJSONY推送数据内容，其中可包含多条记录VM日DStringY终端编号（最大长度16位）LonDoubleY经度（保留
6、8位小数）LatDoubleY纬度（保留8位小数）PTimeStringY定位时间，UTC时区（例：201709-0813:00:00）以小时为单位推送位置数据ElevationDoubleY高程（m）SpeedDoubleYGPS速度（节）CourseDoubleY航向(0-360)IsWorkIntY作业状态（O-非作业状态；1作业状态）JobTypeIntY作业类型码（见附录3.2）JobWidthIntY作业幅宽（Cm）WorkDeepIntY作业深度（mm）出参：参数名称类型说明ResuItCodeInt结果代码（O-成功；I-失败）ErrorMsgString错误信息DataObj
7、ect预留，无附加数据null2.2.4 参数示例入参：用户信息参数AccessID和AccessPwd参数由链接传入：Post参数:VehiclePos:VMEID:X,Lon:112.222222,Lat:46.555555,PTime,:2018-10-1100:00:00,Elevation:666,Speed:55,Course:55,IsWork:I,JobType:1,Jobwidth:200,WorkDeep:333,VMEID：X,Lon:112.33333,Lat：46.6666,PTime:2018-10-1100:00:04,Elevation:666,Speed:55
8、,Course:55,IsWork:1,JobType:1,JobWidth:200,WorkDeep:333)出参：ErrorMsg:,ResultCode:02.3 作业信息推送接口2.2.1接口说明该接口用于接收县级平台按小时推送该区县所有终端的作业信息，接口支持批量上传,单次推送作业记录不超过200条。2.3.3出入参数定义入参：参数名称类型是否必填说明AccessIDStingY许可IDAccessPwdStringY许可密码VehicIeJobJSONY推送作业数据内容，可包含多条记录VM日DStringY终端编号（最大长度16位）JobDateStringY作业日期（例:2017
9、-09-08）JobTypeIntY作业类型码（见附录3.2）JobAreaDoubleY作业面积（亩）JobHourDoubleY作业时间（h）JobWidthIntY作业幅宽（cm）WorkDistDoubleY作业里程（m）TranDistDoubleN空闲俳作业）里程（m）TranHourDoubleN空闲（非作业）时长（h）JobAreaNGDoubleY不合格作业面积（亩）AvgDeepIntN平均深度（mm）MaxDeepIntN最大深度（mm）MinDeepIntN最小深度（mm）PIotAreaDoubleY作业地块面积（亩）OverIapAreaDoubleN当天自重叠区面
10、积（亩）HistOverIapAreaDoubleN历史重叠区面积（亩）LeakAreaDoubleN当天自遗漏区面积（亩）出参：参数名称类型说明ResuItCodeInt结果代码（O-成功；I-失败）ErrorMsgString错误信息DataObject预留，无附加数据null2.3.4参数示例入参：用户信息参数AccessID和AccessPwd参数由链接传入：Post参数:VehicleJob:VMEID:X,3obDate:2018-9-1,)出参：JobType:1,JobArea:32,JobHour,:666,JobWidth:200,WorkDist:55000,TranDi
11、st:10000,TranHour:200,DobAreaNG:6,AvgDeep:333,MaxDeep:500,MinDeep:203,PlotArea:29,OverlapArea:2,HistOverlapArea:2,LeakArea:6,VMEID：X,3obDate:2018-9-2,JobType:2,JobArea:32,JobHour:666,JobWidth:200,WorkDist:55000,TranDist:10000,TranHour:200,JobAreaNG:6,AvgDeep:333,MaxDeep:500,MinDeep:203,PlotArea:29,O
12、verlapArea:2,HistOverlapArea:2,LeakArea:6ErrorMsg:,ResultCode:02.4.1 接口说明该接口用于接收县级平台按天推送该区县所有终端的作业地块边界数据。接口支持多地块批量上传，一次上传的地块数量不超过50。2.4.2 接口地址2.4.3 出入参数定义入参：参数名称类型是否必填说明AccessIDStingY许可IDAccessPwdStringY许可密码JobPIotJSONY推送数据内容，可包含多条记录VM日DStringY终端编号（最大长度16位）JobDateStringY作业日期（例:2017-09-08）PIotAreaDou
13、bleY地块面积（亩）JobTypeIntY作业类型码（见附录3.2）WorkProvStringY作业地块地理位置所属省（例：“山东省”）WorkCityStringY作业地块地理位置所属市（例：“潍坊市”）WorkCountyStringY作业地块地理位置所属县（例：“临胸县”）WorkTownStringY作业地块地理位置所属乡镇（例：”龙岗镇）WokPIaceStringY作业地块地理位置（例：“山东省潍坊市临胸县龙岗镇刘王庄“）PIotBoundryStringYWKT格式地块边界数据，POlygon类型出参：参数名称类型说明ResuItCodeInt结果代码（O-成功；I-失败）E
14、rrorMsgString错误信息DataObject预留，无附加数据null2.4.3参数示例入参：Post参数：,3obPlot:,VMEID:X,JobDate:2018-9-l,PlotArea:1,3obType:2,WorkProv:安徽省”，WorkCity:“宿州市二“WorkCounty”：“埔桥区二WorkTown:符离镇、“WokPlace“：”安徽省宿州市埔桥区符离镇北刘村二PlotBoundry:,POLYGON(116.33.89,116.33.89,116.33.89,116.33.89,116.33.89,116.33.89,116.33.8,116.33.5,
15、116,(VMEID：X,JobDate:2018-9-2h,PlotArea:1,3obType:2,WorkProv:,安徽省“Workcity：“宿州市二“Workcounty1”塘桥区”，WorkTown:符离镇二WokPlace:“安徽省宿州市埔桥区符离镇北刘村二PlotBoundry:,POLYGON(116.33.89,116.33.89,116.33.89,116.33.89j116.33.89,116.33.89,116.33.8,116.33.5,116)出参：ErrorMsg:,jResultCode:0251接口说明该接口用于接收县级平台按小时推送该区县所有终端的农机作
16、业轨迹点数据。2.5.2接口地址2.5.3出入参数定义入参：参数名称类型是否必填说明AccessIDStingY许可IDAccessPwdStringY许可密码VehicIeTraceJSONY推送数据内容，可包含多条轨迹点记录VM日DStringY终端编号（最大长度16位）PTimeStringY轨迹点定位时间UTC（例：2017-09-0813:25:36）LonDoubleY经度（保留8位小数）LatDoubleY纬度（保留8位小数）ElevationDoubleY高程（m）SpeedDoubleYGPS速度（节）CourseDoubleY航向(0360)IsWorkIntY作业状态（O
17、-非工作状态；1-作业状态）JobWidthIntY作业幅宽（cm）WorkDeepIntN作业深度（mm）JobTypeIntY作业类型码（见附录3.2）StandardDeepIntN深度合格标准（mm）出参：参数名称类型说明ResuItCodeInt结果代码（O-成功；I-失败）ErrorMsgString错误信息DataObject预留，无附加数据null2.5.4参数示例入参：Post参数:VehicleTrace:VMEID:X,PTime:2018-9-112:23：23,Lon:116,Lat:45.,Elevation:80,Speed:15,Course,:60,IsWor
18、k:1,JobWidth:250,WorkDeep:300,JobType:1,StandardDeep:250,VMEID：X,PTime:,2018-9-l12:23：25,Lon:116,Lat:45.jElevation:80,Speed:15,Course:65,IsWork:1,JobWidth:250,WorkDeep:300,JobType:li,StandardDeepu:250,)出参：ErrorMsg:,Resultcode:0)2.6.1 接口说明该接口用于接收县级平台按小时推送的该区县所有终端的作业图片数据。支持批量上传,单次上传不超过50条图片记录。2.6.2 接口
19、地址2.6.3 出入参数定义入参：参数名称类型是否必填说明AccessIDStingY许可IDAccessPwdStringY许可密码JoblmgJSONY推送的数据内容，可包含多条图片数据记录VM日DStringY终端编号（最大长度16位）PTimeStringY图片采集时间，UTC时区（例：2017-09-0813:25:36）ImgLenIntY图片数据长度（单位:字节，原始图片大小，非编码后大小）ImgCtxStringYBase64编码图片数据出参：参数名称类型说明ResuItCodeInt结果代码（O-成功；I-失败）ErrorMsgString错误信息DataObject预留，无
20、附加数据null2.6.4 参数示例入参：用户信息参数AccessID和AccessPwd参数由链接传入：Post参数:,3oblmg:VMEID:,X,PTime:,2018-9-l12：23：23”,ImgLen:8044,ImgCtx:data:imagepngjbase64,iVBORw0KGgoAAAANSUhEUgAAAlYAAAIdCAIAAABwWKTnAAAgAElEQVR4Aey9CbxtVlHnf+b8t5LQhJIEEISIKgENCEBmEZtCHYrQiKArYCatsg2nY7dIviSHdHIDWFuj+i2DbTjh8QBQ.,VMEID:X,PTime:,2
21、018-9-l12：23：25”,ImgLen:8034,ImgCt,:data:image/png;base64,iVBORw0KGgoAAAANSUhEugAAAlYAAAIdCAIAAABwWKTnAAAgAElEQVR4Aey9CbxtVlHnf+b8t5LQhJIEEISIKgENCEBmUEZtCHYrQiKArYCatsg2nY7dIviSHdHIDWFuj+i2DbTjh8QBQ.)出参：ErrorMsg:,ResultCode:03.1 农机类型码农机类型码农机类型10拖拉机04收获机02插秧机03植保机（包含无人机）020304抛秧机3.2 作业类型码作业类型码作业类型1深松作业2收获作业3喷药作业4插秧作业5翻地作业6秸秆还田7平地作业8旋耕作业9播种作业10打捆作业12施肥作业13深松作业高标准16抛秧作业
