Hansadrone API Reference

API reference



getCordata
URL https://hansadrone.com/api/getCorData
Supported Methods get | post
Parameters apiKey (String), mandatory
Response fields lat (float) The latitide of the corridor root
long (float) The longitude of the corridor root
alt (int) The altitude of the corridor root in m
comp (int) The compass angle of the corridor in degrees
inc (float) The inclination angle of the corridor in degrees
Called by Mobile Device | Drone flight management system
Error 403 forbidden

getCorImage
URL https://storage.googleapis.com/corridor_image/<apiKey>.jpg;
Supported Methods get
Parameters none, add apiKey directly to path
Response fields <apiKey>.jpg (base64 encoded JPG image file)
Called by Drone flight management system
Error 403 forbidden

getDeviations
URL https://hansadrone.com/api/getDeviations
Supported Methods get | post
Parameters apiKey (String), mandatory
Response fields devX (float) The horizontal deviation from corridor center in degrees
devY (float) The vertical deviation from corridor center in degrees
Called by Drone flight management system
Error 403 forbidden

getDroneStatus
URL https://hansadrone.com/api/getDroneStatus
Supported Methods get | post
Parameters apiKey (String), mandatory
Response fields status (Enum) The status of the drone
unknown (default)
connected
available
underway
atfixpoint
arrived
completed
aborted
Called by Mobile Device | Drone flight management system
Error 403 forbidden

getFixpoint
URL https://hansadrone.com/api/getFixpoint
Supported Methods get | post
Parameters apiKey (String), mandatory
altitude (int), mandatory
Response fields fixLat (float) The latitude of the fixpoint
fixLong (float) The longitude of the fixpoint
Called by Drone flight management system
Error 403 forbidden

getMobileStatus
URL https://hansadrone.com/api/getMobileStatus
Supported Methods get | post
Parameters apiKey (String), mandatory
Response fields status (Enum) The status of the mobile device
unknown (default)
connected
defined
recognized
aborted
Called by Mobile Device | Drone flight management system
Error 403 forbidden

saveCorImage
URL https://hansadrone.com/api/saveCorImage
Supported Methods post
Parameters apiKey (String), mandatory
image (base64 encoded String), mandatory
Response fields 201 created
Called by Mobile Device
Error 403 forbidden

setCorData
URL https://hansadrone.com/api/setCorData
Supported Methods get | post
Parameters apiKey (String), mandatory
latitude (float) Corridor root latitude in degrees, mandatory
longitude (float) Corridor root longitude in degrees, mandatory
pressure (int) atmospheric pressure in mbar at corridor root, mandatory
compass (int) Corridor compass angle in degrees, mandatory
inclination (float) Corridor inclination angle in degrees, mandatory
Response fields 201 created
Called by Mobile Device
Error 403 forbidden

setDeviations
URL https://hansadrone.com/api/setDeviations
Supported Methods get | post
Parameters apiKey (String), mandatory
devX (float) Horizontal deviation in degrees, mandatory
devY (float) Vertical deviation in degrees, mandatory
Response fields 201 created
Called by Mobile Device
Error 403 forbidden

setDroneStatus
URL https://hansadrone.com/api/setDroneStatus
Supported Methods get | post
Parameters apiKey (String) mandatory
status (Enum) Status of the drone, mandatory
unknown (default)
connected
available
underway
atfixpoint
arrived
completed
aborted
Response fields 201 created
Called by Drone flight management system
Error 403 forbidden

setMobileStatus
URL https://hansadrone.com/api/setMobileStatus
Supported Methods get | post
Parameters apiKey (String) mandatory
status (Enum) Status of the mobile device, mandatory
unknown (default)
connected
defined
recognized
aborted
Response fields 201 created
Called by Mobile device
Error 403 forbidden