110.custom-flight-area

Function Overview

The Cloud API adds custom flight area functionality. Users can designate sensitive locations as restricted zone and synchronize this information with DJI Docks within the project. When the aircraft performs tasks, it will automatically bypass the restricted zone, ensuring the safety and compliance of operations. This function define the aircraft flight area via the custom flight area file. Click to download the Custom Flight Area File Template.

This function allows users to plan custom flight areas on the map. There are two types of custom flight areas:

1. Custom Operation Area: Within this area, the aircraft can take off and perform tasks but cannot fly out of the area.

2. Custom GEO Zone: Outside this area, the aircraft can operate but cannot fly into the area.

Interaction Sequence Diagram

sequenceDiagram

participant geo_service as Cloud Server
participant Dock as DJI Dock
participant Drone as Aircraft
participant web as Web Page

geo_service -->> geo_service: Package custom flight area file<br/>and<br/> upload to the storage bucket
geo_service -->> Dock: Notify custom flight area file update <br/>Topic: thing/product/{gateway_sn}/services <br/>Method: flight_areas_update
Dock -->> geo_service: Retrieve custom flight area file information <br/>Topic: thing/product/{gateway_sn}/requests <br/>Method: flight_areas_get
geo_service -->> Dock: Return latest custom flight area information from cloud
Dock -->> Drone: Turn on the aircraft<br/>request to upgrade custom flight area data, <br/>carrying file download URL and file MD5
Drone -->> Dock: Return the custom flight area file information of the aircraft
Dock -->> Dock: Check the custom flight area file version
alt File version matches
   Dock -->> geo_service: Report synchronization completion <br/>Topic: thing/product/{gateway_sn}/events <br/>Method: flight_areas_sync_progress
   geo_service -->> web: Return synchronization completed state 
else File version does not match (cloud version prevails if inconsistent)
   Dock -->> geo_service: Report synchronization in progress, enter data synchronization upgrade
   Dock -->> Drone: Download the latest file from the storage bucket <br/>and<br/> upload custom flight area data
   Drone -->> Dock: Send custom flight area synchronization progress state
   Dock -->> geo_service: Report custom flight area synchronization progress state <br/>Topic: thing/product/{gateway_sn}/events <br/>Method: flight_areas_sync_progress
   geo_service -->> geo_service: Local state persistence processing
   geo_service -->> web: Push latest custom flight area synchronization progress state
end
Drone -->> Dock: Aircraft pushes flight area information to the dock
Dock -->> geo_service: Push flight area alarm information <br/>Topic: thing/product/{gateway_sn}/events <br/>Method: flight_areas_drone_location
geo_service -->> web: Report aircraft and various area alarm information

Detailed API Realization

Custom Flight Area