《无人机数据接入接口文档》

1、 21/22无人机数据接入接口文档目 录目录TOC o 1-3 h u HYPERLINK l _Toc32169 目 录 PAGEREF _Toc32169 0 HYPERLINK l _Toc26077 1. 接口设计 PAGEREF _Toc26077 1 HYPERLINK l _Toc8613 1.1. 接口设计流程说明 PAGEREF _Toc8613 1 HYPERLINK l _Toc18980 1.2. 接口接入说明 PAGEREF _Toc18980 1 HYPERLINK l _Toc82 PAGEREF _Toc82 1 HYPERLINK l _Toc17719 2.

2、1. 无人机信息接入接口 PAGEREF _Toc17719 2 HYPERLINK l _Toc7403 2.1.1. 接口地址 PAGEREF _Toc7403 2 HYPERLINK l _Toc19608 2.1.2. 请求参数和返回结果 PAGEREF _Toc19608 2 HYPERLINK l _Toc23394 2.1.3. 参数示例 PAGEREF _Toc23394 2 HYPERLINK l _Toc20229 2.1.4. 参数说明 PAGEREF _Toc20229 3 HYPERLINK l _Toc26567 2.2.1. 接口地址 PAGEREF _Toc26

3、567 3 HYPERLINK l _Toc1901 2.2.2. 请求参数和返回结果 PAGEREF _Toc1901 3 HYPERLINK l _Toc23531 2.2.3. 参数示例 PAGEREF _Toc23531 4 HYPERLINK l _Toc12431 2.2.4. 参数说明 PAGEREF _Toc12431 5 HYPERLINK l _Toc14070 2.3.1接口地址 PAGEREF _Toc14070 7 HYPERLINK l _Toc26296 2.3.2请求参数和返回结果 PAGEREF _Toc26296 7 HYPERLINK l _Toc2425

4、6 2.3.3参数示例 PAGEREF _Toc24256 8 HYPERLINK l _Toc12338 2.3.4参数说明 PAGEREF _Toc12338 8 HYPERLINK l _Toc24818 2.4.1接口地址 PAGEREF _Toc24818 9 HYPERLINK l _Toc10847 2.4.2请求参数和返回结果 PAGEREF _Toc10847 9 HYPERLINK l _Toc6716 2.4.3参数示例 PAGEREF _Toc6716 10 HYPERLINK l _Toc2212 2.4.4参数说明 PAGEREF _Toc2212 10 HYPER

5、LINK l _Toc23584 2. 附录 PAGEREF _Toc23584 11 HYPERLINK l _Toc15231 附表1 返回结果编码表 PAGEREF _Toc15231 11 HYPERLINK l _Toc11806 附表2 作业类型代码表 PAGEREF _Toc11806 12 HYPERLINK l _Toc2432 附表3 终端接入厂家白名单信息登记表 PAGEREF _Toc2432 12 HYPERLINK l _Toc27979 信息登记之后发送至邮箱： PAGEREF _Toc27979 12 HYPERLINK l _Toc28938 精准作业平台负责

6、开通终端白名单，开通后返回以下指标 PAGEREF _Toc28938 12 HYPERLINK l _Toc26007 接口登录账号：91130101681* PAGEREF _Toc26007 12 HYPERLINK l _Toc8446 接口登录密码：* PAGEREF _Toc8446 12 HYPERLINK l _Toc6737 厂家ID: 9788101*1 PAGEREF _Toc6737 13 TOC o 1-3 h z u 接口设计接口设计流程说明首先需要经过用户中心鉴权是否通过，鉴权失败则返回失败信息，鉴权通过则开始数据传输，传输完成则返回成功信息，否则返回失败信息。接

7、口接入说明精准作业平台为第三方接入厂家分配账号和密码，在向平台接入数据时需要校验账号、密码、IP、厂家ID号码四个属性值，通过才可以备份数据。验证属性属性说明account账号：精准作业平台分配password密码：精准作业平台分配factoryId厂家ID：白名单开通后，由作业平台分配infoGuidUUID : 接入方接入GUID,由作业平台分配2接口设计无人机信息接入接口接口地址URL: 4:8083/gpcsConnect_UAV/action/connect?handler=receiveUavInfo请求参数和返回结果请求参数：名称是否必填类型说明jsontrueString同步参

8、数及信息返回结果：名称是否必填类型说明NStatus状态码NDesc是否成功Result返回结果参数示例请求参数示例： account: xxxx, password: xxxx, factoryId: xxxx, infoGuid: xxxx, data: uav_name: a12345, uav_fuselage_code: 243523, uav_flight_num: 234234, uav_province: 黑龙江省, uav_city: 哈尔滨市, uav_district: 阿城区, uav_coop: 利新合作社, id_card:2323232, owner_name:方

9、法, owner_phone:456456412313 , uav_name: a12345, uav_fuselage_code: 243523, uav_flight_num: 234234, uav_province: 黑龙江省, uav_city: 哈尔滨市, uav_district: 阿城区, uav_coop: 利新合作社, id_card:84965156156151615, owner_name:三十东方, owner_phone:12345678944 支持一次添加多架无人机返回结果示例：NStatus:0,NDesc:success,Result: 参数说明序号名称是否必

10、填类型说明accounttrueString接入方授权账号passwordtrueString接入方授权密码factoryIdtrueString厂家IDdeviceIdtrueString终端设备号infoGuidtrueString接入方接入GUIDuav_nametrueString无人机名称uav_fuselage_codetrueString机身码uav_flight_numtrueString飞控编号uav_provincetrueString隶属单位 省uav_citytrueString隶属单位 市uav_districttrueString隶属单位 区县uav_cooptru

11、eString隶属单位合作社id_cardtrueString身份证owner_nametrueString机主名owner_phonetrueString机主电话注：上述数据均为必填项。 每天定时推送一次数据2.2 作业信息接入接口接口地址URL: 4:8083/gpcsConnect_UAV/action/connect?handler?handler=receiveWorkInfo请求参数和返回结果请求参数：名称是否必填类型说明jsontrueString同步参数及信息返回结果：名称是否必填类型说明NStatus状态码NDesc是否成功Result返回结果参数示例请求参数示例： acco

12、unt: xxxx, password: xxxx, factoryId: xxxx, infoGuid: xxxx, data: uav_fuselage_code: a12345, area: 131, area_vaild: 131, latitude: 47.65864, longitude: 126.4512312, operation_time: 542, diswork: 100, distance: 145, speed: 30, height: 800, spray: 50, modes: 自驾模式, status: 1, work_date: 2019-12-19, beg

13、in_time: 2019-12-19 10:20:51, loc1: 黑龙江省, loc2: 哈尔滨市, loc3: 双城市, loc4: 大王乡东南500米, end_time: 2019-12-19 13:50:48, workType: 1 , uav_fuselage_code: a19846, area: 131, area_vaild: 131, latitude: 47.65864, longitude: 126.4512312, operation_time: 542, diswork: 100, distance: 145, speed: 30, height: 800,

14、spray: 50, modes: 自驾模式, status: 1, work_date: 2019-12-19, begin_time: 2019-12-19 10:20:51, loc1: 黑龙江省, loc2: 哈尔滨市, loc3: 双城市, loc4: 大王乡东南500米, end_time: 2019-12-19 13:50:48, workType: 1 返回结果示例：NStatus:0,NDesc:success,Result: 参数说明作业信息接入接口支持批量接入，按照json数组格式进行接入即可。序号名称是否必填类型说明accounttrueString接入方授权账号pas

15、swordtrueString接入方授权密码factoryIdtrueString厂家IDuav_fuselage_codetrueString机身码areatrueString合格面积area_vaildtrueString作业面积work_datetrueString作业日期（YYYY-MM-DD）begin_timetrueString开始时间（YYYY-MM-DD HH24:MI:SS）end_timetrueString结束时间（YYYY-MM-DD HH24:MI:SS）distancetrueString行驶里程 disworktrueString作业里程 longitudetr

16、ueString作业地点经度 latitudetrueString作业地点纬度 operation_timetrueString作业时长 单位分钟heighttrueString地面高度，单位:米(相对地面高度),精确度:小数点后2位spraytrue String喷幅，单位:米,精确度:小数点后2位modestrueString飞行模式：自驾模式、AB作业 等statustrueString飞机状态（1开始2结束）work_typetrueString见附表2depthtrueString耕深（厘米）speedtrueString平均速度 千米/时loc1trueString作业地点-省 l

17、oc2trueString作业地点-市 loc3trueString作业地点-区县 loc4trueString作业地点-具体位置 xxx乡/村东南xxx米 注：是否必填列为true的为必须传输属性，如没有须填写“0”注：上述数据均为必填项。 每天定时推送一次数据2.3 无人机最新实时定位信息接入接口2.3.1接口地址URL: 4:8083/gpcsConnect_UAV/action/connect?handler?handler=receiveUavRT2.3.2请求参数和返回结果请求参数：名称是否必填类型说明jsontrueString同步参数及信息返回结果：名称是否必填类型说明NSta

18、tus状态码NDesc是否成功Result返回结果2.3.3参数示例请求参数示例： account: xxxx, password: xxxx, factoryId: xxxx, infoGuid: xxxx, data: uav_fuselage_code: a12389, gps_time: 2019-12-19 10:20:51, latitude: 47.65482, longitude: 126.84562, speed: 30, height: 30, course:56 , uav_fuselage_code: a12456, gps_time: 2019-12-19 10:20

19、:51, latitude: 47.65482, longitude: 126.84562, speed: 30, height: 30, course:152 返回结果示例：NStatus:0,NDesc:success,Result: 2.3.4参数说明接口支持批量接入，按照json数组格式进行接入即可。序号名称是否必填类型说明1.accounttrueString接入方授权账号2.passwordtrueString接入方授权密码3.factoryIdtrueString厂家ID4.uav_fuselage_codetrueString机身码5.gps_timetrueString定位时

20、间（YYYY-MM-DD HH24:MI:SS）6.longitudetrueString作业地点经度 7.latitudetrueString作业地点纬度 8.speedtrueString速度9.heighttrueString地面高度，单位:米(相对地面高度),精确度:小数点后2位10.coursetrueString航向角注：是否必填列为true的为必须传输属性，如没有须填写“0”此接口需要每5分钟同步一次最新定位信息2.4 无人机作业轨迹信息接入接口2.4.1接口地址URL: 4:8083/gpcsConnect_UAV/action/connect?handler?handler=

21、receiveUavTrace2.4.2请求参数和返回结果请求参数：名称是否必填类型说明jsontrueString同步参数及信息返回结果：名称是否必填类型说明NStatus状态码NDesc是否成功Result返回结果2.4.3参数示例请求参数示例： account: xxxx, password: xxxx, factoryId: xxxx, infoGuid: xxxx, data: uav_fuselage_code: a12345, gps_time: 2019-12-19 10:20:51, latitude: 47.65482, longitude: 126.84562, spee

22、d: 310, work_flag: 1, course: 256, height: 30 , uav_fuselage_code: a12356, gps_time: 2019-12-19 10:20:51, latitude: 47.65482, longitude: 126.84562, speed: 302, work_flag: 1, course: 256, height: 30 返回结果示例：NStatus:0,NDesc:success,Result: 2.4.4参数说明接口支持批量接入，按照json数组格式进行接入即可。序号名称是否必填类型说明1.accounttrueStr

23、ing接入方授权账号2.passwordtrueString接入方授权密码3.factoryIdtrueString厂家ID4.uav_fuselage_codetrueString机身码5.gps_timetrueString定位时间（YYYY-MM-DD HH24:MI:SS）6.longitudetrueString作业地点经度 7.latitudetrueString作业地点纬度 8.speedtrueString速度9.heighttrueString地面高度，单位:米(相对地面高度),精确度:小数点后2位10.coursetrueString航向角11.work_flagtrueS

24、tring作业状态 1作业 0非作业注：是否必填列为true的为必须传输属性，如没有须填写“0”注：上述数据均为必填项。 每天定时推送一次数据注：上述所有的经纬度坐标，坐标系统一为wgs84坐标系附录附表1 返回结果编码表接入结果状态码接入结果状态说明0成功100账号密码错误101IP地址不符102厂家ID不存在200必填信息不完整201数据格式错误300JSON协议错误404请求URL错误500接口内部错误（请联系技术支撑）600接口服务繁忙，稍后重试999未知错误（请联系技术支撑）附表2 作业类型代码表作业类型作业类型说明1播种作业2植保作业 3撒肥作业4作物授粉作业5其他作业附表3 终端

25、接入厂家白名单信息登记表工商注册号码终端厂家名称终端品牌终端型号联系人联系电话绑定IP接口对接人qq号码或微信号码信息登记之后发送至邮箱： 精准作业平台负责开通终端白名单，开通后返回以下指标接口登录账号：91130101681*接口登录密码：*厂家ID: 9788101*1时间一锅米饭，放到第二天，水气就会干一些；放到第三天，味道恐怕就有问题；第四天，我们几乎可以发现，它已经发馊；再放下去，恐怕就要发霉了。是什么原因，使那锅米饭变馊变坏是时间。可是，在烟雨的江南，年轻的父母生下女儿，他们就在地窖里，埋下一缸缸米酒，十七、八年以后，女儿长大了，这些酒就成为嫁女儿、婚礼上的佳酿。它有一个美丽而惹人

26、遐思的名字，叫女儿红。是什么使那些平凡的米，变成芬芳甘醇的酒也是时间。到底，时间是善良的，还是邪恶的魔术师呢？或许都不是，时间只是一个简单的指数符号，它会把原来倍增而已。开始变坏的米饭，每一天都不断变得更腐臭，而开始变醇的美酒，每一分钟，都在继续增加它的芬芳。在人世间，我们也曾经看过天真的少年一旦开始堕落，便不免愈陷愈深，终于变得满面风尘，面目可憎。但相反的，时间却把温和的笑痕，体谅的眼神，成熟的风采，智慧的神韵添加在那些追寻善良的人身上。同样是煮熟的米，馊饭与美酒的差别在哪里呢？就在那一点点的酒曲。皆出父母，谁堕落如禽兽，而谁又能提升成完美的人呢？是内心深处，紧紧环抱不放的，捉摸不透的欲望。

27、与其问，时间将怎样对待你我。不如问，你我将如何对待时间。你就是一道风景生于世界上，存于宇宙间，你不比别人多，也不比别人少，同顶炎炎烈日，共沐皎皎月辉，心智不缺，心力不乏，只要你勇于展示自己的才华、个性及风采，那么，你就没必要去仰视别人。你，就是一道风景！不要隐于云海峰峦之后，不必藏于青竹绿林之中，你就是巍巍山峦的一石，就是苍苍林莽中的一株。所以你没必要敬畏名山大川，没必要去赞叹大漠孤烟，你的存在，其立身就在解释世上所有的景致；你的存在，正注释着时代的一种风情！不必去拥挤了，你就站在属于自己的位置上，不断地展示你内心世界的丰富内涵，给苍白的四周以绮丽，给庸俗的日子以诗意，给沉闷的空气以清新，每日

28、拭亮一个太阳，用大自然的琴弦，奏响自己喜爱的心曲。自然美具有不以人们意志为转移的自然性，梅花自有梅花的风韵，红杏自有红杏的丽姿，如今认清自己往往比注视别人更为重要。没必要一味褒扬别人贬低自己，应该果敢地站起，与最佳景观比肩，只要你不懈追求，相信你，不比别人差。真的，你行！翠竹之秀丽，青松之壮美，杨柳之潇洒，兰草之温柔，自然赋予各异风情，都在各自的一片土地上展示生命的光辉。如今所需的不是自谦，而是自信。很久很久了，虚假的谦逊毁掉个性的展露，模仿、装扮、整容，使人无法认清你的真面目，不知哪个是你自己，那情景似古代砖窑烧出的规格相同的陶俑。风景这边独好！妙在独好。我们太忽视这个“独”了。世上被人们公

29、认的景点都是独特的：埃及金字塔，中国古长城；法国凯旋门，罗马斗兽场世上被人赞誉的美景也别具风采：泰山日出，威尼斯水缄，热带雨林，撒哈拉大沙漠大凡能被我们记住的人多富有个性特征：阿Q的“快乐”，鲁滨逊的坚毅，王熙风的笑里藏刀，奥赛罗嫉妒杀人让个性伴你，站着该是一座山，倒下便是路基；完整时给人启示，粉碎时使人警醒你不比别人多，也不比别人少，你不用注视人们的眸光便可知道，你在阳光下用身影发表宣言：你就是一道风景！大气戈壁上的胡杨活着三百年不死，死了三百年不倒，倒了三百年不朽。飞沙走石中守住了生命的鲜活，孤苦凄然中昂起了信念的不屈。胡杨的勃然生机挺拔出了撼人的大气。秋风中的竹子虽消瘦但不折腰，虽孤独但

30、不动摇，虽忧思但不哀鸣，任凭寒夜苦雨萧瑟，依然傲骨拔节凌空。竹子的冲天豪情正直出了高亢的大气。池塘里的莲花身陷污泥而不染，一身清白不自怜，纵使面对丑恶也不悲戚，昂首独立更为清高。莲花丹青难写之精神顶立起风骨的大气。大气，便是冲破贫瘠和困苦之折磨即使有万千磨难也要心揣梦想播撒爱意的生气。嫩嫩的企盼不灭，目光便总是向前，重重的责任肩负，生长丰厚了痴迷的期待。大气，便是卑微不失凌云之志，平凡犹有不可欺之尊的骨气，用自己找寻使自己的足迹不欲，跌倒爬起照样有路可走，用自己的脖子支起自己的脑袋，用自己的脊梁挺直自己的腰板，失去拥有总是无愧无悔。大气，便是受邪恶不辱不低头、保护柔弱不自负的正气，正因为心中有爱，才敢向不平挥剑，才肯如老牛俯首，行侠仗义呼啸而过，即使伤痕犹在也刚毅且无泪。大气，小而言之就是一个人