《無人機(jī)數(shù)據(jù)接入接口文檔》

1、 21/22無人機(jī)數(shù)據(jù)接入接口文檔目 錄目錄TOC o 1-3 h u HYPERLINK l _Toc32169 目 錄 PAGEREF _Toc32169 0 HYPERLINK l _Toc26077 1. 接口設(shè)計 PAGEREF _Toc26077 1 HYPERLINK l _Toc8613 1.1. 接口設(shè)計流程說明 PAGEREF _Toc8613 1 HYPERLINK l _Toc18980 1.2. 接口接入說明 PAGEREF _Toc18980 1 HYPERLINK l _Toc82 PAGEREF _Toc82 1 HYPERLINK l _Toc17719 2.

2、1. 無人機(jī)信息接入接口 PAGEREF _Toc17719 2 HYPERLINK l _Toc7403 2.1.1. 接口地址 PAGEREF _Toc7403 2 HYPERLINK l _Toc19608 2.1.2. 請求參數(shù)和返回結(jié)果 PAGEREF _Toc19608 2 HYPERLINK l _Toc23394 2.1.3. 參數(shù)示例 PAGEREF _Toc23394 2 HYPERLINK l _Toc20229 2.1.4. 參數(shù)說明 PAGEREF _Toc20229 3 HYPERLINK l _Toc26567 2.2.1. 接口地址 PAGEREF _Toc26

3、567 3 HYPERLINK l _Toc1901 2.2.2. 請求參數(shù)和返回結(jié)果 PAGEREF _Toc1901 3 HYPERLINK l _Toc23531 2.2.3. 參數(shù)示例 PAGEREF _Toc23531 4 HYPERLINK l _Toc12431 2.2.4. 參數(shù)說明 PAGEREF _Toc12431 5 HYPERLINK l _Toc14070 2.3.1接口地址 PAGEREF _Toc14070 7 HYPERLINK l _Toc26296 2.3.2請求參數(shù)和返回結(jié)果 PAGEREF _Toc26296 7 HYPERLINK l _Toc2425

4、6 2.3.3參數(shù)示例 PAGEREF _Toc24256 8 HYPERLINK l _Toc12338 2.3.4參數(shù)說明 PAGEREF _Toc12338 8 HYPERLINK l _Toc24818 2.4.1接口地址 PAGEREF _Toc24818 9 HYPERLINK l _Toc10847 2.4.2請求參數(shù)和返回結(jié)果 PAGEREF _Toc10847 9 HYPERLINK l _Toc6716 2.4.3參數(shù)示例 PAGEREF _Toc6716 10 HYPERLINK l _Toc2212 2.4.4參數(shù)說明 PAGEREF _Toc2212 10 HYPER

5、LINK l _Toc23584 2. 附錄 PAGEREF _Toc23584 11 HYPERLINK l _Toc15231 附表1 返回結(jié)果編碼表 PAGEREF _Toc15231 11 HYPERLINK l _Toc11806 附表2 作業(yè)類型代碼表 PAGEREF _Toc11806 12 HYPERLINK l _Toc2432 附表3 終端接入廠家白名單信息登記表 PAGEREF _Toc2432 12 HYPERLINK l _Toc27979 信息登記之后發(fā)送至郵箱： PAGEREF _Toc27979 12 HYPERLINK l _Toc28938 精準(zhǔn)作業(yè)平臺負(fù)責(zé)

6、開通終端白名單，開通后返回以下指標(biāo) 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 接口設(shè)計接口設(shè)計流程說明首先需要經(jīng)過用戶中心鑒權(quán)是否通過，鑒權(quán)失敗則返回失敗信息，鑒權(quán)通過則開始數(shù)據(jù)傳輸，傳輸完成則返回成功信息，否則返回失敗信息。接

7、口接入說明精準(zhǔn)作業(yè)平臺為第三方接入廠家分配賬號和密碼，在向平臺接入數(shù)據(jù)時需要校驗賬號、密碼、IP、廠家ID號碼四個屬性值，通過才可以備份數(shù)據(jù)。驗證屬性屬性說明account賬號：精準(zhǔn)作業(yè)平臺分配password密碼：精準(zhǔn)作業(yè)平臺分配factoryId廠家ID：白名單開通后，由作業(yè)平臺分配infoGuidUUID : 接入方接入GUID,由作業(yè)平臺分配2接口設(shè)計無人機(jī)信息接入接口接口地址URL: 4:8083/gpcsConnect_UAV/action/connect?handler=receiveUavInfo請求參數(shù)和返回結(jié)果請求參數(shù)：名稱是否必填類型說明jsontrueString同步參

8、數(shù)及信息返回結(jié)果：名稱是否必填類型說明NStatus狀態(tài)碼NDesc是否成功Result返回結(jié)果參數(shù)示例請求參數(shù)示例： 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: 阿城區(qū), 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: 阿城區(qū), uav_coop: 利新合作社, id_card:84965156156151615, owner_name:三十東方, owner_phone:12345678944 支持一次添加多架無人機(jī)返回結(jié)果示例：NStatus:0,NDesc:success,Result: 參數(shù)說明序號名稱是否必

10、填類型說明accounttrueString接入方授權(quán)賬號passwordtrueString接入方授權(quán)密碼factoryIdtrueString廠家IDdeviceIdtrueString終端設(shè)備號infoGuidtrueString接入方接入GUIDuav_nametrueString無人機(jī)名稱uav_fuselage_codetrueString機(jī)身碼uav_flight_numtrueString飛控編號uav_provincetrueString隸屬單位 省uav_citytrueString隸屬單位 市uav_districttrueString隸屬單位 區(qū)縣uav_cooptru

11、eString隸屬單位合作社id_cardtrueString身份證owner_nametrueString機(jī)主名owner_phonetrueString機(jī)主電話注：上述數(shù)據(jù)均為必填項。 每天定時推送一次數(shù)據(jù)2.2 作業(yè)信息接入接口接口地址URL: 4:8083/gpcsConnect_UAV/action/connect?handler?handler=receiveWorkInfo請求參數(shù)和返回結(jié)果請求參數(shù)：名稱是否必填類型說明jsontrueString同步參數(shù)及信息返回結(jié)果：名稱是否必填類型說明NStatus狀態(tài)碼NDesc是否成功Result返回結(jié)果參數(shù)示例請求參數(shù)示例： 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: 大王鄉(xiāng)東南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: 大王鄉(xiāng)東南500米, end_time: 2019-12-19 13:50:48, workType: 1 返回結(jié)果示例：NStatus:0,NDesc:success,Result: 參數(shù)說明作業(yè)信息接入接口支持批量接入，按照json數(shù)組格式進(jìn)行接入即可。序號名稱是否必填類型說明accounttrueString接入方授權(quán)賬號pas

15、swordtrueString接入方授權(quán)密碼factoryIdtrueString廠家IDuav_fuselage_codetrueString機(jī)身碼areatrueString合格面積area_vaildtrueString作業(yè)面積work_datetrueString作業(yè)日期（YYYY-MM-DD）begin_timetrueString開始時間（YYYY-MM-DD HH24:MI:SS）end_timetrueString結(jié)束時間（YYYY-MM-DD HH24:MI:SS）distancetrueString行駛里程 disworktrueString作業(yè)里程 longitudetr

16、ueString作業(yè)地點(diǎn)經(jīng)度 latitudetrueString作業(yè)地點(diǎn)緯度 operation_timetrueString作業(yè)時長 單位分鐘heighttrueString地面高度，單位:米(相對地面高度),精確度:小數(shù)點(diǎn)后2位spraytrue String噴幅，單位:米,精確度:小數(shù)點(diǎn)后2位modestrueString飛行模式：自駕模式、AB作業(yè) 等statustrueString飛機(jī)狀態(tài)（1開始2結(jié)束）work_typetrueString見附表2depthtrueString耕深（厘米）speedtrueString平均速度 千米/時loc1trueString作業(yè)地點(diǎn)-省 l

17、oc2trueString作業(yè)地點(diǎn)-市 loc3trueString作業(yè)地點(diǎn)-區(qū)縣 loc4trueString作業(yè)地點(diǎn)-具體位置 xxx鄉(xiāng)/村東南xxx米 注：是否必填列為true的為必須傳輸屬性，如沒有須填寫“0”注：上述數(shù)據(jù)均為必填項。 每天定時推送一次數(shù)據(jù)2.3 無人機(jī)最新實(shí)時定位信息接入接口2.3.1接口地址URL: 4:8083/gpcsConnect_UAV/action/connect?handler?handler=receiveUavRT2.3.2請求參數(shù)和返回結(jié)果請求參數(shù)：名稱是否必填類型說明jsontrueString同步參數(shù)及信息返回結(jié)果：名稱是否必填類型說明NSta

18、tus狀態(tài)碼NDesc是否成功Result返回結(jié)果2.3.3參數(shù)示例請求參數(shù)示例： 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 返回結(jié)果示例：NStatus:0,NDesc:success,Result: 2.3.4參數(shù)說明接口支持批量接入，按照json數(shù)組格式進(jìn)行接入即可。序號名稱是否必填類型說明1.accounttrueString接入方授權(quán)賬號2.passwordtrueString接入方授權(quán)密碼3.factoryIdtrueString廠家ID4.uav_fuselage_codetrueString機(jī)身碼5.gps_timetrueString定位時

20、間（YYYY-MM-DD HH24:MI:SS）6.longitudetrueString作業(yè)地點(diǎn)經(jīng)度 7.latitudetrueString作業(yè)地點(diǎn)緯度 8.speedtrueString速度9.heighttrueString地面高度，單位:米(相對地面高度),精確度:小數(shù)點(diǎn)后2位10.coursetrueString航向角注：是否必填列為true的為必須傳輸屬性，如沒有須填寫“0”此接口需要每5分鐘同步一次最新定位信息2.4 無人機(jī)作業(yè)軌跡信息接入接口2.4.1接口地址URL: 4:8083/gpcsConnect_UAV/action/connect?handler?handler=

21、receiveUavTrace2.4.2請求參數(shù)和返回結(jié)果請求參數(shù)：名稱是否必填類型說明jsontrueString同步參數(shù)及信息返回結(jié)果：名稱是否必填類型說明NStatus狀態(tài)碼NDesc是否成功Result返回結(jié)果2.4.3參數(shù)示例請求參數(shù)示例： 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 返回結(jié)果示例：NStatus:0,NDesc:success,Result: 2.4.4參數(shù)說明接口支持批量接入，按照json數(shù)組格式進(jìn)行接入即可。序號名稱是否必填類型說明1.accounttrueStr

23、ing接入方授權(quán)賬號2.passwordtrueString接入方授權(quán)密碼3.factoryIdtrueString廠家ID4.uav_fuselage_codetrueString機(jī)身碼5.gps_timetrueString定位時間（YYYY-MM-DD HH24:MI:SS）6.longitudetrueString作業(yè)地點(diǎn)經(jīng)度 7.latitudetrueString作業(yè)地點(diǎn)緯度 8.speedtrueString速度9.heighttrueString地面高度，單位:米(相對地面高度),精確度:小數(shù)點(diǎn)后2位10.coursetrueString航向角11.work_flagtrueS

24、tring作業(yè)狀態(tài) 1作業(yè) 0非作業(yè)注：是否必填列為true的為必須傳輸屬性，如沒有須填寫“0”注：上述數(shù)據(jù)均為必填項。 每天定時推送一次數(shù)據(jù)注：上述所有的經(jīng)緯度坐標(biāo)，坐標(biāo)系統(tǒng)一為wgs84坐標(biāo)系附錄附表1 返回結(jié)果編碼表接入結(jié)果狀態(tài)碼接入結(jié)果狀態(tài)說明0成功100賬號密碼錯誤101IP地址不符102廠家ID不存在200必填信息不完整201數(shù)據(jù)格式錯誤300JSON協(xié)議錯誤404請求URL錯誤500接口內(nèi)部錯誤（請聯(lián)系技術(shù)支撐）600接口服務(wù)繁忙，稍后重試999未知錯誤（請聯(lián)系技術(shù)支撐）附表2 作業(yè)類型代碼表作業(yè)類型作業(yè)類型說明1播種作業(yè)2植保作業(yè) 3撒肥作業(yè)4作物授粉作業(yè)5其他作業(yè)附表3 終端

25、接入廠家白名單信息登記表工商注冊號碼終端廠家名稱終端品牌終端型號聯(lián)系人聯(lián)系電話綁定IP接口對接人qq號碼或微信號碼信息登記之后發(fā)送至郵箱： 精準(zhǔn)作業(yè)平臺負(fù)責(zé)開通終端白名單，開通后返回以下指標(biāo)接口登錄賬號：91130101681*接口登錄密碼：*廠家ID: 9788101*1時間一鍋米飯，放到第二天，水氣就會干一些；放到第三天，味道恐怕就有問題；第四天，我們幾乎可以發(fā)現(xiàn)，它已經(jīng)發(fā)餿；再放下去，恐怕就要發(fā)霉了。是什么原因，使那鍋米飯變餿變壞是時間。可是，在煙雨的江南，年輕的父母生下女兒，他們就在地窖里，埋下一缸缸米酒，十七、八年以后，女兒長大了，這些酒就成為嫁女兒、婚禮上的佳釀。它有一個美麗而惹人

26、遐思的名字，叫女兒紅。是什么使那些平凡的米，變成芬芳甘醇的酒也是時間。到底，時間是善良的，還是邪惡的魔術(shù)師呢？或許都不是，時間只是一個簡單的指數(shù)符號，它會把原來倍增而已。開始變壞的米飯，每一天都不斷變得更腐臭，而開始變醇的美酒，每一分鐘，都在繼續(xù)增加它的芬芳。在人世間，我們也曾經(jīng)看過天真的少年一旦開始墮落，便不免愈陷愈深，終于變得滿面風(fēng)塵，面目可憎。但相反的，時間卻把溫和的笑痕，體諒的眼神，成熟的風(fēng)采，智慧的神韻添加在那些追尋善良的人身上。同樣是煮熟的米，餿飯與美酒的差別在哪里呢？就在那一點(diǎn)點(diǎn)的酒曲。皆出父母，誰墮落如禽獸，而誰又能提升成完美的人呢？是內(nèi)心深處，緊緊環(huán)抱不放的，捉摸不透的欲望。

27、與其問，時間將怎樣對待你我。不如問，你我將如何對待時間。你就是一道風(fēng)景生于世界上，存于宇宙間，你不比別人多，也不比別人少，同頂炎炎烈日，共沐皎皎月輝，心智不缺，心力不乏，只要你勇于展示自己的才華、個性及風(fēng)采，那么，你就沒必要去仰視別人。你，就是一道風(fēng)景！不要隱于云海峰巒之后，不必藏于青竹綠林之中，你就是巍巍山巒的一石，就是蒼蒼林莽中的一株。所以你沒必要敬畏名山大川，沒必要去贊嘆大漠孤煙，你的存在，其立身就在解釋世上所有的景致；你的存在，正注釋著時代的一種風(fēng)情！不必去擁擠了，你就站在屬于自己的位置上，不斷地展示你內(nèi)心世界的豐富內(nèi)涵，給蒼白的四周以綺麗，給庸俗的日子以詩意，給沉悶的空氣以清新，每日

28、拭亮一個太陽，用大自然的琴弦，奏響自己喜愛的心曲。自然美具有不以人們意志為轉(zhuǎn)移的自然性，梅花自有梅花的風(fēng)韻，紅杏自有紅杏的麗姿，如今認(rèn)清自己往往比注視別人更為重要。沒必要一味褒揚(yáng)別人貶低自己，應(yīng)該果敢地站起，與最佳景觀比肩，只要你不懈追求，相信你，不比別人差。真的，你行！翠竹之秀麗，青松之壯美，楊柳之瀟灑，蘭草之溫柔，自然賦予各異風(fēng)情，都在各自的一片土地上展示生命的光輝。如今所需的不是自謙，而是自信。很久很久了，虛假的謙遜毀掉個性的展露，模仿、裝扮、整容，使人無法認(rèn)清你的真面目，不知哪個是你自己，那情景似古代磚窯燒出的規(guī)格相同的陶俑。風(fēng)景這邊獨(dú)好！妙在獨(dú)好。我們太忽視這個“獨(dú)”了。世上被人們公

29、認(rèn)的景點(diǎn)都是獨(dú)特的：埃及金字塔，中國古長城；法國凱旋門，羅馬斗獸場世上被人贊譽(yù)的美景也別具風(fēng)采：泰山日出，威尼斯水緘，熱帶雨林，撒哈拉大沙漠大凡能被我們記住的人多富有個性特征：阿Q的“快樂”，魯濱遜的堅毅，王熙風(fēng)的笑里藏刀，奧賽羅嫉妒殺人讓個性伴你，站著該是一座山，倒下便是路基；完整時給人啟示，粉碎時使人警醒你不比別人多，也不比別人少，你不用注視人們的眸光便可知道，你在陽光下用身影發(fā)表宣言：你就是一道風(fēng)景！大氣戈壁上的胡楊活著三百年不死，死了三百年不倒，倒了三百年不朽。飛沙走石中守住了生命的鮮活，孤苦凄然中昂起了信念的不屈。胡楊的勃然生機(jī)挺拔出了撼人的大氣。秋風(fēng)中的竹子雖消瘦但不折腰，雖孤獨(dú)但

30、不動搖，雖憂思但不哀鳴，任憑寒夜苦雨蕭瑟，依然傲骨拔節(jié)凌空。竹子的沖天豪情正直出了高亢的大氣。池塘里的蓮花身陷污泥而不染，一身清白不自憐，縱使面對丑惡也不悲戚，昂首獨(dú)立更為清高。蓮花丹青難寫之精神頂立起風(fēng)骨的大氣。大氣，便是沖破貧瘠和困苦之折磨即使有萬千磨難也要心揣夢想播撒愛意的生氣。嫩嫩的企盼不滅，目光便總是向前，重重的責(zé)任肩負(fù)，生長豐厚了癡迷的期待。大氣，便是卑微不失凌云之志，平凡猶有不可欺之尊的骨氣，用自己找尋使自己的足跡不欲，跌倒爬起照樣有路可走，用自己的脖子支起自己的腦袋，用自己的脊梁挺直自己的腰板，失去擁有總是無愧無悔。大氣，便是受邪惡不辱不低頭、保護(hù)柔弱不自負(fù)的正氣，正因為心中有愛，才敢向不平揮劍，才肯如老牛俯首，行俠仗義呼嘯而過，即使傷痕猶在也剛毅且無淚。大氣，小而言之就是一個人