湖南省农机作业监测系统县级平台数据接入接口要求.docx
湖南省农机作业监测系统（县级平台）数据接入接口要求1接口设计1.1 概述本说明描述了湖南省农机作业监测系统（以下称省平台）与县级农机作业监测系统（以下称县级平台）的作业数据的对接格式，省平台利用本说明定义的接口接收县级平台的各类农机作业数据。1.2 用户验证接口用户使用预分配的用户名和密码进行身份验证以及权限控制。1.3 数据传输请求接口使用httpPost方式提交数据，用户发送的请求和接口返回的数据统一采用JSOn格式，编码采用UTF-8编码方式。县级平台向省平台推送的位置、地块边界等与经纬度相关的数据采用WGS84参考坐标系进行处理后上传至省平台。数据上传频率要求：数据名称数据内容涉及接口推送频率终端注册信息归属地信息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许可IDAccessPwdStringY许可密码VM日NFOJSONY推送数据内容VMEModeIStringY终端型号OrgVMEIDStringY终端编号（最大长度16位）AmNoStringY农机牌号（例：鲁03-62765）对于没有牌号的农机可将发动机号作为农机牌号。AmTypeStringY农机类型（见附录3.1）VehicIeNumStringY农机型号（例：东方红-1504）ProNameStringY所属省CItyNameStringY所属市CountyNameStringY所属区县TownNameStringY所属乡镇ViIINameStringY所属村组/合作社OwnerNameStringY车主姓名OwnerTeINumStringY车主电话出参：参数名称类型说明ResuItCodeInt结果代码(0成功；1-失败)ErrorMsgString错误信息DataObject预留，无附加数据null2.1.4 参数示例入参：用户信息参数AccessID和AccessPwd参数由链接传入：，OPost参数:"VMEINFO"："VMEModel":',AMT999"j"OrgVMEID":"X","AmNo":“鲁01-3332”,"AmType":"04","VehicleNum":“东方红998”，"ProName":"山东省”,“CItyName":"聊城市“，"CountyName":"阳谷县“，“TownName”:“侨润街道”，“VillName"：“孙膑阁农机专业合作社L"OwnerNamen:"孙振泰”，"OwnerTelNum":'"")出参："ErrorMsg":null,"ResultCode":0)2.2 位置信息推送接口2.2.1 接口说明该接口用于接收县级平台按分钟推送该区县所有终端位置信息，支持批量推送，单次推送的终端位置信息不能超过200条C2.2.2 接口地址2.2.3 出入参数定义入参：参数名称类型是否必填说明AccessIDStingY许可IDAccessPwdStringY许可密码VehicIePosJSONY推送数据内容，其中可包含多条记录VM日DStringY终端编号（最大长度16位）LonDoubleY经度（保留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错误信息DataObject预留，无附加数据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,"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-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当天自重叠区面积（亩）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,"TranDist":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,"OverlapArea":2,"HistOverlapArea":2,"LeakArea":6"ErrorMsg":"","ResultCode":02.4.1 接口说明该接口用于接收县级平台按天推送该区县所有终端的作业地块边界数据。接口支持多地块批量上传，一次上传的地块数量不超过50。2.4.2 接口地址2.4.3 出入参数定义入参：参数名称类型是否必填说明AccessIDStingY许可IDAccessPwdStringY许可密码JobPIotJSONY推送数据内容，可包含多条记录VM日DStringY终端编号（最大长度16位）JobDateStringY作业日期（例:2017-09-08）PIotAreaDoubleY地块面积（亩）JobTypeIntY作业类型码（见附录3.2）WorkProvStringY作业地块地理位置所属省（例：“山东省”）WorkCityStringY作业地块地理位置所属市（例：“潍坊市”）WorkCountyStringY作业地块地理位置所属县（例：“临胸县”）WorkTownStringY作业地块地理位置所属乡镇（例：”龙岗镇"）WokPIaceStringY作业地块地理位置（例：“山东省潍坊市临胸县龙岗镇刘王庄“）PIotBoundryStringYWKT格
