《無人機數據接入接口說明》

《無人機數據接入接口說明》

目錄

目錄

目錄................................................................................0

1.接口設計..........................................................................1

1.1.接口設計流程說明...............................................................1

1.2.接口接入說明...................................................................1

2.1.無人機信息接入接口.............................................................1

27.1.接口地址.......................................................................................................................................1

2.1.2.請求參數和返回結果...................................................................................................................2

2.7.3.參數示例.......................................................................................................................................2

2.1.4.參數說明.......................................................................................................................................3

2.2.1.接口地址......................................................................................................................................4

2.2.2.請求參數和返回結果..................................................................................................................4

2.2.3.參數示例.......................................................................................................................................5

22.4.參數說明.......................................................................................................................................7

23.1接口地址..........................................................................................................................................9

2.3.2請求參數和返回結果......................................................................................................................9

2.3.3參數示例..........................................................................................................................................9

2.3.4參數說明........................................................................................................................................10

2.4.1接口地址........................................................................................................................................11

2.4.2請求參數和返回結果....................................................................................................................11

2.4.3參數示例........................................................................................................................................11

2.4.4參數說明........................................................................................................................................13

2.附錄...............................................................錯誤!未定義書簽。

附表1返回結果編碼表................................................................14

附表2作業(yè)類型代碼表................................................................14

附表3終端接入廠家白名單信息登記表..................................................15

信息登記之后發(fā)送至郵箱：..............................................................15

精準作業(yè)平臺負責開通終端白名單，開通后返回以下指標...................................15

接口登錄賬號：91130101681*******............................................................................................................15

接口登錄密碼：********................................................................15

廠家ID:9788101********1............................................................................................................................15

1.接口設計

1.1.接口設計流程說明

首先需要經過用戶中心鑒權是否通過，鑒權失敗則返回失敗信息，鑒權通過則開始數據傳輸,

傳輸完成則返回成功信息，否則返回失敗信息。

1.2.接口接入說明

D精準作業(yè)平臺為第三方接入廠家分配賬號和密碼，在向平臺接入數據時需要校驗賬

號、密碼、IP、廠家ID號碼四個屬性值，通過才可以備份數據。

驗證屬性屬性說明

account賬號：精準作業(yè)平臺分配

password密碼：精準作業(yè)平臺分配

factoryld廠家ID：白名單開通后，由作業(yè)平臺分配

infoGuidUUID:接入方接入GUID,由作業(yè)平臺分配

2接口設計

2.1.無人機信息接入接口

2.1.1.接口地址

URL：:8084/gpcsConnect_UAV/action/connect?handler=receiveUavlnfo

2.1.2.請求參數和返回結果

請求參數:

名稱是否必填類型說明

jsontrueString同步參數及信息

返回結果:

名稱是否必填類型說明

NStatus狀態(tài)碼

NDesc是否成功

Result返回結果

2.1.3.參數示例

請求參數示例：

{

"account":"DFHK4419",

"password":"k3htlh",

"factoryld":"JFHK_JW_201601",

"infoGuid":"cc50eaafc86447c8aa7666f0290c7630",

"data":[

{

"uav_name":"312345",

"uav_fuselage_code":"243523",

"uav_flight_num":"234234",

"uav_province":"黑龍江省"，

"uav_city":"哈爾濱市"，

"uav_district":"阿城區(qū)"，

"uav_coop":"利新合作社"，

"id_card":'"\

"owner_name":"方法",

"owner_phone":""

},{

"uav_name":"312345",

"uav_fuselage_coden:“243523”，

"uav_flight_num":"234234",

“uav_province“：“黑龍江省二

"uav_city":"哈爾濱市二

"uav_district":“阿城區(qū)二

“uav_coop”：“利新合作社:

"id_card":"849655",

“ownejname":“三十東方二

"owner_phone":""

}

]

}支持一次添加多架無人機

返回結果示例：

{"NStatus":0,"NDesc":"success","Result":"")

POSTkxatx?E9999/gpC5C<MW?eCT_UAV/acoonZconnea??wndler^e<eti?<Uv1nfo

Body?

"?ctounf：FBJZMM9-.

*paswor<T:,kJIrtlh-,

?**CtoryM-：J?_M_2?1W7?51715llMl-,

*info6uid-：-*Me?afcM447ca7M6yMM",

*Mv_fu?elMe_c?>**：,M5523,,

-w?v_fli^teg-：-2J47J4".

-wav_provliKe-：?堡尼江6J

?ww.clty"：?哈爾奉市，

strict,:“阿城區(qū))

--："wa&fftt,.

"M_<?rd"?"J3232W,

-ownejIMMe-F法■.

-O?*er_ph<W:*45645641231i-

uavnaae":??1254S*,

8v_%se1《ee_CB<:-M3523",

u^_nifht_nu?-：-2342M',

ijrovlnc，"：?以龍(1省”,

?Mw.city-：?哈爾IS用?.

?w?,dlrtrirt-：Hj?Ew.

MV-COOP*：?和色合作?f..

id.cwd*:*M%515615?l$1615*t

ger_?e”:■■三十東方一.

<Maer_phone*:*UMM7BW

Body!(tMUKXMO*Timetl

PrettyTea=5

f?:?success",-TJUeRL:-陶力

2.1.4.參數說明

終端信息推接口僅支持單條數據傳輸。

序名稱是否必類型說明

號填

accounttrueString接入方授權賬號

passwordtrueString接入方授權密碼

factoryIdtrueString廠家1D

deviceIdtrueString終端設備號

infoGuidtrueString接入方接入GUID

uav_nametrueString無人機名稱

uav_fuselage_co

trueString機身碼

de

uav_flight_numtrueStringK控編號

uav_provincetrueString隸屬單位省

uav_citytrueString隸屬單位市

uav_districttrueString隸屬單位區(qū)縣

uav_cooptrueString隸屬單位合作社

id_cardtrueString身份證

ownerenametrueString機主名

owner_phonetrueString機主電話

注:上述數據均為必填項。每天定時推送一次數據

2.2作業(yè)信息接入接口

2.2.1.接口地址

URL：:8084/gpcsConnect_UAV/action/connect?handler?handler=receiveWorklnfo

2.2.2.請求參數和返回結果

請求參數:

名稱是否必填類型說明

jsontrueString同步參數及信息

返回結果:

名稱是否必填類型說明

NStatus狀態(tài)碼

NDesc是否成功

Result返回結果

2.2.3.參數示例

請求參數示例：

{

"account":"：FHK4419\

"password":"k3htlh",

"factoryld":"3FHK_3W_201601",

"infoGuid":"cc50eaafc86447c8aa7666f0290c7630",

"data":[

(

"uav_fuselage_coden:”al2345”，

"area":"131",

,,area_vaildn:"131",

"latitude":"47.65864",

"longitude":"126.",

"operation_time":"542",

"diswork":"100",

"distance":"145",

"speed":"30",

"height":"800",

"spray":“50"，

"modes"：”自駕模式;

"status'1:"1",

"work__date":"2019-12-19",

',begin_timeu:"2019-12-1910:20:51",

“l(fā)oci"：“黑龍江省二

"loc2":"哈爾濱市二

"loc3":”雙城市”，

"loc4n:“大王鄉(xiāng)東南500米;

"end_time":"2019-12-1913:50:48",

"workType":"1"

},{

uav_fuselage_code":"al9846”，

"area":"131",

"area_vaild":"131",

"latitude":"47.65864",

"longitude":"126.",

"operation_time":"542”,

"diswork":"100",

"distance":"145",

"speed":"30",

"height":"800",

"spray":"50",

"modes":"自駕模式"，

"status":"1",

"work_date":"2019-12-19",

"begin_time":"2019-12-1910:20:51",

"loci":"黑龍江省"，

"loc2":"哈爾濱市"，

"loc3":"雙城市"，

"loc4":''大王鄉(xiāng)東南50。米”,

"end_time":"2019-12-1913:50:48",

"workType":"1"

}

]

}

返回結果示例：

{"NStatus":0,"NDesc":"success","Result":

便立信電

POST,kxA*MMC9999/gpcsC<xtnect.UAV/acUort/connc<i?han<*er**receweWdrtiJnfo

?Body?

?efornxtou?i-wwMrform-udencoded?raw?binary?GraphQl(SON?

1(

*KC<xmt-：-MBJBM419-,

"patMWd*:"k?tlh".

*???ctoryW:"MJZN.M.ZSlMTtSlTlSllMl",

)rnfoGulb:-ccS0ewfcM447caM7666f?2M<761?*t

6-?st.r(

(

*uav_Hy_code-:'aUMS",

"?re*-：-IM-.

1?

11,latitude"：-47.65864”.

12“l(fā)yHudel,1J6.4S1JJ120,

13*operatlon_tiae-：-M2",

14?tfisworf:?100-,

15"distance,:?145，

?tpee?":

17?height":-8W-.

1??spray*:??*,

1??BdeV:“白蜀俱式，

MT.

91-wx*_8tL：*?1912-19-,

22?betin.tUe-：-2819-U-19l?:2e：Sl*.

??jocr：

?IOCJ-J7爾高布

2S-1OC3-：-Wl?市)

2A,loc?-：?■大王鄉(xiāng)?東K5??米

,entf.ttae-S-J??-U-W!J:$e：4?",

}1,nortcType,:T

]

Coa*MKH?**1?E0)Tra(WcuitBSonusMOCKTWnrl

Pretty1-T?,三

1"?etc-:,Fewlt?:"成功不

2.2.4.參數說明

作業(yè)信息接入接口支持批量接入，按照json數組格式進行接入即可。

序號名稱是否必填類型說明

1.accounttrueString接入方授權賬號

2.passwordtrueString接入方授權密碼

3.factoryIdtrueString廠家ID

4.uav_fuselage_codetrueString機身碼

5.areatrueString合格面積

6.area_vaildtrueString作業(yè)面積

7.work_datetrueString作業(yè)日期(YYYY-MM-DD)

8.begin_timetrueString開始時間(YYYY-MM-DDHH24:MI:SS)

9.end_timetrueString結束時間(YYYY-MM-DDHH24:MI:SS)

10.distancetrueString行駛里程

11.disworktrueString作業(yè)里程

12.longitudetrueString作業(yè)地點經度

13.latitudetrueString作業(yè)地點緯度

14.operation_timetrueString作業(yè)時長單位分鐘

15.heighttrueString地面高度，單位:米（相對地面高度），精確度:小數

點后2位

16.spraytrueString噴幅，單位:米，精確度:小數點后2位

17.modestrueString飛行模式：自駕模式、AB作業(yè)等

18.statustrueString飛機狀態(tài)（1開始2結束）

19.work_typetrueString見附表2

20.depthtrueString耕深（厘米〈cm＞）

21.speedtrueString平均速度千米/時

22.locitrueString作業(yè)地點-省

23.loc2trueString作業(yè)地點-市

24.loc3trueString作業(yè)地點-區(qū)縣

25.loc4trueString作業(yè)地點-具體位置XXX鄉(xiāng)/村東南XXX米

注:是否必填列為true的為必須傳輸屬性,如沒有須填寫“0”

注:上述數據均為必填項。每天定時推送一次數據

2.3無人機最新實時定位信息接入接口

2.3.1接口地址

URL；:8084/gpcsConnect_UAV/action/connect?handler?handler=receiveUavRT

2.3.2請求參數和返回結果

請求參數:

名稱是否必填類型說明

jsontrueString同步參數及信息

返回結果:

名稱是否必填類型說明

NStatus狀態(tài)碼

NDesc是否成功

Result返回結果

2.3.3參數示例

請求參數示例：

{

"account":":JFHK4419”，

"password":,,k3htlhn,

"factoryld":"3FHK_3W__201601",

"infoGuid":"cc50eaafc86447c8aa7666f0290c7630'\

"data":[

(

,,uav_fuselage_code,':"al2389",

"gps_time":"2019-12-1910:20:51",

"latitude":"47.65482”，

"longitude":"126.84562",

"speed":"30、

"height":"30",

course“：“56”

},{

"uav_fuselage_code":"al2456'\

”即"2019-12-1910:20:51",

"latitude":"47.65482",

"longitude":"126.84562",

"speed'1:“30”，

"height":“30”,

"course":"152"

)

]

}

返回結果示例:

{"NStatus":0/'NDesc":"success","Result":"")

POST?loc4>x?E9999/B>uCannect,UAV/actt>n/connea?h4nc*er'>recetv?UMf(T

Body?

?none?fomwUuOx-wwwform-urlencoded?r?*?binary?GraphQC

??ccount":FB】ZWC9”,

*PMS?nrd*:-kJMlh-,

?f?ctor)rld-s*FBjai_h<l_2eiae7e5m51J6?l",

*lnfc6uU*:-cc5?e?afca6447cSM76?6f?29?c7639<,.

?d?t?r(

<

"uav_fuselogecode*:*al2J89",

-6二-2M91219

-latitude":MT.tSW,

"loneitude*:,126.M562,,

'W,

"height-：

?count-t'ib'

*uav_twel??e_code*:"?124W,

"C?5_tiw-：-2?912-19ie：n：5i-,

"latitude":?47.6M8”.

-10<Witudf："126.M562,,

?heifhf:??-,

?course*

Body

PnmyTE?三

1gT?e*c-：**ucces**,t?t?tus"!f.,U?ilf：-tfitf)T|

2.3.4參數說明

接口支持批量接入，按照json數組格式進行接入即可。

序號名稱是否必填類型說明

1.accounttrueString接入方授權賬號

2.passwordtrueString