Dji Terra
Dji Terra
Dji Terra
User Manual
v2.1 2019.09
Content
Disclaimer 2
Warning 2
Introduction 2
Mission Type 5
Waypoints 5
Mapping 5
Oblique 5
Corridor 5
Interface Introduction 6
Main Screen 6
Mission Editing View 8
Create a Mission 9
Perform Mission 11
Start Mission 11
Stop Mission 11
Special Cases 12
Mission Complete 12
More Functions 24
Purchase Licenses 24
Activate Licenses and Bind Devices 25
Reconstruction 25
Output Coordinate System Settings 35
GCP Management 36
View and Export Logs 38
© 2019 DJI All Rights Reserved. 1
Disclaimer
Read this disclaimer and the terms in DJI TERRATM (hereinafter referred to as “product”) carefully
before using this product. By using this product, you hereby agree to this disclaimer and the Terms
of Use and signify that you have read it fully. Please install and use this product in strict accordance
with the User Manual. SZ DJI TECHNOLOGY CO., LTD. and its affiliated companies assume no
liability for damage(s) or injuries incurred directly or indirectly from using this product improperly.
DJITM is a trademark of SZ DJI TECHNOLOGY CO., LTD. (abbreviated as “DJI”) and its affiliated
companies. Names of products, brands, etc., appearing in this manual are trademarks or registered
trademarks of their respective owner companies. This product and manual are copyrighted by DJI
with all rights reserved. No part of this product or manual shall be reproduced in any form without
the prior written consent of or authorization from DJI.
This disclaimer is produced in various languages. In the event of variance among different versions, the
Chinese version shall prevail when the product in question is purchased in China, and the English version
shall prevail when the product in question is purchased in any other region.
Warning
1. Ensure your flight area is safe before each flight.
2. Be sure to maintain a visual line of sight (VLOS) to your aircraft at all times.
3. The aircraft will continue its mission, meaning Failsafe RTH will not be triggered, if the remote
controller signal is lost during the mission.
4. When the GNSS signal is strong and the RTH button is pressed and held during a mission, the
aircraft will stop the mission immediately and begin RTH. Users can resume the mission if required.
5. When there is only sufficient battery power for RTH during a mission, the remote controller will
alert for a few moments, the aircraft will pause the mission, and begin RTH. After replacing the
battery, the mission can resume from the paused point
6. When using an aircraft with obstacle avoidance function, check that the Sensing System is
operational in the current surroundings. If it is not, disable it in DJI Terra (go to > ), or flight
may be adversely affected.
7. All of the altitude values in DJI Terra are relative to the altitude of the takeoff point. In the same
mission, the altitude above sea level for the same point during the mission will vary if taking off at
different altitudes.
Introduction
DJI Terra is a PC software designed to improve mission performance efficiency for industrial
applications including — but not limited to — agricultural plant protection, search and rescue,
and firefighting. It can control a DJI aircraft* to fly along a planned 2D or 3D route and provides
functions such as 2D map reconstruction, 3D model reconstruction, field planning, and more.
* Support for DJI devices will be added as testing and development continues. Visit the DJI Terra product
page on dji.com for a complete list. https://www.dji.com/dji-terra
DJI Terra has three versions: Basic, Advanced, and Pro. To purchase DJI Terra, visit the DJI Online
Store or the official DJI website. After purchasing, activate licenses and bind devices using DJI
Terra. For more information, refer to “More Functions” on p.24.
Basic version includes functions such as real-time 2D mapping, 2D map reconstruction (for field
and fruit tree scenes), and agriculture applications.
Advanced version includes all the functions of Basic version with additional functions such as
importing KML files, 2D map reconstruction (for urban scenes), and outpurt cordinate system settings.
Pro version includes all the functions from Advanced version with additional functions such as 3D
model reconstruction, 3D Mission Planning, and GCP management.
NOTE: The Basic version is only available in China.
NOTE:
The requirements for 2D map reconstruction / 3D model reconstruction / 3D point cloud are
equally applicable to real-time 2D mapping. There are no mandatory requirements on the graphics
card for real-time 2D mapping. However, using a low-performance computer for real-time 2D
mapping may result in delayed performance. If using an NVIDIA graphics card, the processing
speed will be faster.
It is recommended to use the graphics cards listed above. If using other models, please contact
DJI Support before use.
Make sure that the graphics card driver is up-to-date regardless of the models.
1. Visit the DJI Terra product page on dji.com using your computer to download and install the software.
2. Launch DJI Terra and log in with your DJI account.
© 2019 DJI All Rights Reserved. 3
Connect the Remote Controller and Aircraft
Using Phantom 4 RTK / Phantom 4 Pro V2.0 / Phantom 4 Pro+ V2.0
Connect the remote controller to the computer using a USB-C cable (for the Phantom 4 RTK) or
Micro USB cable (for the Phantom 4 Pro V2.0 / Phantom 4 Pro+ V2.0), then power on the remote
controller and aircraft. The location and status information of the aircraft will display on DJI Terra.
When using the Phantom 4 Pro V2.0, make sure to connect the remote controller to the
computer first and then power it on. Otherwise, DJI Terra cannot recognize the device.
Currently, the Phantom 4 RTK (SDK) remote controller (which refers to the Phantom 4 RTK
remote controller without a display device) is not supported by DJI Terra.
If you want to use DJI GO 4 or other apps on a mobile device connected to the USB port on
the remote controller, be sure to switch the remote controller communication mode to App
mode in DJI Terra. The switching procedure is similar to the one above. The only difference
is choosing “App Mode.”
Set a waypoint flight path, then define waypoint actions for each waypoint.
Mapping
DJI Terra automatically generates efficient flight paths after user has set their required
flight area and camera parameters. The aircraft will then follow this route throughout
its mission. Real-time 2D mapping or real-time 3D point cloud (of low accuracy)
during a mission can be enabled. After the mission is complete, users can also
import the original images into DJI Terra for 2D map reconstruction or 3D model
reconstruction (of high accuracy).
Oblique
This function automatically generates five flight paths after users have set their
required flight area and parameters. These include a single flight path with a gimbal
pitch angle of -90°, indicating a downward facing direction. Subsequently, this is
followed by four flight paths with a customizable gimbal pitch of more than -90°
to capture photos from multiple angles such as forward, backward, leftward, and
rightward. After the mission is complete, users can import the original images onto
DJI Terra for 3D model reconstruction of different resolutions.
Corridor
DJI Terra automatically generates corridor flight area and several independent
flight paths after the user has set the corridor points, expansion distance, and
flight band cutting distance. After the mission is complete, users can import the
original images into DJI Terra for 2D map or 3D model reconstruction.
© 2019 DJI All Rights Reserved. 5
Interface Introduction
Main Screen
11 22 33 44 55 66 77 88 99
TERRA
TERRA PHANTOM
PHANTOM 44
12
12
Fly
Fly Safe
Safe 100%
100%
18
18 Mission
Mission Library
Library
10
10
New
New Waypoint
Waypoint Mission
Mission 11
11
12
12
Created
Createdon:
on:12/03/2019
12/03/2019
Last
Lastupdate:
update:23/06/2019
23/06/2019
Edit
Edit More
More 13
13
14
14
SS
15
15
256m
256m
Home
Home Distance
Distance Altitude
Altitude Speed
Speed Time
Time
New
New Mission
Mission 0000 m
0000 m 0000 m
0000 m 00.00 m/s
00.00 m/s 00.00
00.00
17
17 16
16
10. Search
: Input names to search on the map.
11. Self Mapping List
: Click to show a self mapping list. Choose a map or multi maps to display in the map view.
Maps will not display if not chosen.
© 2019 DJI All Rights Reserved. 7
DJI TERRA User Manual
: Map — This icon will appear only in Mapping, Oblique, and Corridor missions. Click to
enter the reconstruction page for 2D map reconstruction or 3D model reconstruction. For more
information, refer to “More Functions” on p.24.
: Copy — Click to create a copy of this mission. The flight path and parameter settings will
be the same.
: Open Folder — Click to open the folder where the current mission is located.
: Export — Click to export the mission with the current settings and its files such as photos,
2D maps, and 3D models. The exported file can be used to create a mission via “Import”.
The mission name of the exported mission is the same as the one in DJI Terra. It will not be
changed when importing it to create a mission even if the exported file’s name is changed.
1 Fly Safe
12
Waypoints 100%
2D/3D N/A
S
Route Settings Waypoint Settings
Camera
Phantom 4
Ratio
4: 3
2
Completion Action
Hover
Aircraft Heading
Follow Route
Capture Mode
Timed Shot
1. Back
Click to return to the main screen.
2. Parameter List
This list includes the common screen elements below. The other settings vary according to
different mission types. Refer to Parameter Setting Introduction for details.
/ : Collapse / Expand — Click to collapse or expand the list.
Mission Name: Click the button on the right to edit the mission name.
: Save — Click to save current seetings.
: KML Import — Click to import a KML file. The data in the KML file will be converted to waypoints
or edge points and displayed on the map for planning. Refer to “Create a Mission” on p. 9 for details.
: Map — This icon will appear only in Mapping, Oblique, and Corridor missions. Click to
enter the reconstruction page for 2D map reconstruction or 3D model reconstruction. For more
information, refer to “More Functions” on p.24.
Mission Information: Information varies according to different mission types. These include:
route distance, estimated flight route time, estimated total flight route time, waypoint count,
cover area, estimated photo count, etc.
8 © 2019 DJI All Rights Reserved.
DJI TERRA User Manual
Sliders and -/+: Move to the left or right to adjust values. Click -/+ for fine-tuning.
Waypoint / Edge Point Edit:
Longitude
114.201491394043
Latitude
纬titude
22.707180906966
Click the box to input values. Click the arrow keys on the right for fine tufing. Up and down
adjust latitude while left and right adjust longitude.
Mission Button (aircraft connection is required):
a. Start: Click to start the mission after parameters are set.
b. Stop: During the mission, click to stop the mission. The aircraft hovers and records its
location as a breakpoint and users can control the aircraft manually. Users can then choose
an operation after stopping the mission from the prompted list in the software.
c. Pause / Continue: During a Waypoints mission, click to pause the mission, and the aircraft
will hover. Users can control the aircraft to fly forward or backward along the flight path, but
the aircraft heading cannot be controlled. Click “Continue,” and the aircraft continues the
mission from its current position.
Create a Mission
1. New Mission
Create a mission via the following two methods:
a. Click the “New Mission” button on the lower left corner, choose the mission type, input the
mission name, and then click “OK” to enter Mission Editing mode.
b. Click in the right section of the mission library to import a mission file from the computer.
Click to select the imported mission and then click “Edit” to enter Mission Editing mode. The
imported mission cannot be edited, if it has already been finished before export.
© 2019 DJI All Rights Reserved. 9
DJI TERRA User Manual
For Waypoints missions, users can plan flight paths based on a 2D map, 3D model or point
cloud generated in DJI Terra. Make sure that there is no waypoint added, then click on the
right of the 2D/3D section in the parameter list, select a desired 2D map or 3D model, and
click “Import.” The imported map or model will be displayed in the map view. Add waypoints
based on the 2D map or 3D model using the above methods.
The functions for importing 2D maps or 3D models, flight path planning based on a 2D map,
and flight path planning based on a 3D model (called “3D Mission Planning” in a Waypoints
mission) are included in the DJI Terra Pro version. Please purchase a license and then
activate it before use. For information related to purchase and activation, refer to “More
Functions” on p.24.
During 3D mission planning, waypoints can only be added when the 3D model is
displayed in top view. Click to switch to the top view automatically.
path.
: Set your aircraft’s current position as a waypoint/edge point — Click to set the aircraft
position as a waypoint or edge point.
During 3D Mission Planning, hold down the mouse wheel and drag to adjust the display view
of the 3D model, and different icons will be displayed on the selected waypoint to indicate the
directions in which this waypoint can be adjusted. indicates that the position in horizontal
direction can be adjusted, and indicates that the position in vertical direction can be
adjusted. Drag the waypoint in the corresponding direction to adjust its position. The image
of viewing the model from the selected waypoint’s perspective is displayed on the lower right
corner on the screen.
Waypoint quantity in the generated flight path cannot exceed 99. The distance between
two waypoints should be between 3 and 2000 m. The whole distance of the flight path
cannot exceed 5000 m.
Edge points of a flight area should not be too close. Otherwise, it will fail to generate flight
path.
The above requirements are also applicable when importing a KML file to plan a flight path.
Perform Mission
Start Mission
1. Select a mission in the mission library. Click “Edit” and then click “Start.” A flight preparation list
will appear.
2. Wait for the flight path to upload to the aircraft. Check and adjust the aircraft according to the list
that appears until all items are green, indicating that takeoff is permitted. Items in yellow require
adjustment, but the aircraft can take off without doing so. Only flying when all items are green is
highly recommended.
3. Click “Start.” The aircraft will fly along the pre-set flight path to perform the mission.
4. In a Mapping mission, if Real-Time 2D Mapping or Real-Time 3D Point Cloud is enabled, the
real-time mapping result or 3D point cloud will display on the map during the mission as follows:
a. The aircraft flies to the starting point of the flight path and start shooting.
b. When photo count (shown in the flight telemetry at the bottom of the screen) is more than 10, the
real-time mapping pictures or 3D point cloud will be shown at the corresponding position on the
map. No picture display may be due to the map display level. Zoom in or out to view the result.
c. As the mission progresses, the mapping result of the flight area will be shown on the map
gradually.
Stop Mission
During a mission, click the “Stop” button on the screen and the aircraft will hover in place and
record the current position as a breakpoint. The aircraft can then be flown freely and a menu will
pop up with additional control options. In a Mapping mission, the pop-up menu display will vary
depending on whether “Real-Time 2D Mapping” or “Real-Time 3D Point Cloud” is enabled.
© 2019 DJI All Rights Reserved. 11
DJI TERRA User Manual
Cancel Mission: The aircraft will stop and exit from the current mission. The mission cannot be
continued.
If “Save waypoint route info and mission status” is chosen, users can select from the list below as
required after connecting the aircraft and entering the same mission again:
Resume from break point: The aircraft will continue the mission from the recorded breakpoint.
Resume from previous waypoint: The aircraft will continue the mission from the previous waypoint
before the recorded breakpoint.
Resume from next waypoint: The aircraft will continue the mission from the next waypoint after the
recorded breakpoint.
Restart: The aircraft will fly to the start point and restart the mission.
Cancel Mission: DJI Terra will clear the recorded breakpoint information in the current mission and
exit from the mission.
Back to Mission List: Back to the mission library. To check this menu again, select the required
mission and click “Continue”.
Special Cases
1. During any mission, the aircraft will exit from its mission and enter a normal flight mode if
positioning is not available due to a weak GNSS signal. Users can choose to continue the
mission if the signal is strong. When continuing, the aircraft will continue from its last recorded
point.
2. Smart Low-Battery Level: When there is only sufficient battery level for RTH, an audio prompt will
emit from the remote controller. After a few seconds, the aircraft will stop the mission and begin
RTH. Users can cancel the RTH by pressing the Smart RTH button on the remote controller.
The mission can be continued and the aircraft will continue the mission from the point where
recording stopped after replacing battery.
3. Low Battery Level / Critically Low Battery Level: When the battery level is lower than the Low
Battery value pre-set in the app*, an audio prompt will sound from the remote controller. When
the battery level is lower than the Critically Low Battery value pre-set in the app, an audio prompt
will sound from the remote controller. The aircraft will stop the mission and land automatically.
The mission can be continued and the aircraft will continue the mission from the point where
recording stopped after replacing battery.
* App refers to all the apps used with the aircraft, for example DJI GO 4.
Mission Complete
After finishing a mission, the aircraft will perform the pre-set “Completion Action.” The aircraft can
be controlled freely afterward.
For a Mapping mission:
If Real-Time 2D Mapping or Real-Time 3D Point Cloud is enabled, DJI Terra will enter post-
processing stage after mission completion to process the captured photos again for mapping result
of higher accuracy with more zoom levels. After post-processing completion, users can zoom in to
view the more accurate result.
If the option is disabled, after mission completion, users can use the Reconstruction function to
process the captured phots for reconstruction. Refer to “Reconstruction” on p. 25 for details.
Waypoints Settings
Route Settings
Capture Mode
Capture Mode
Route Settings
Route Settings
Waypoint Settings
Waypoint Settings
Timed Shot Timed Shot
Coordinated Coordinated
Turn Turn Interval Interval 2.5 s 2.5 s
Camera Camera
Route Altitude
Route Altitude 100 m 100 m
Phantom 4 Phantom 4
Ratio Ratio
Route SpeedRoute Speed 4 m/s 4 m/s
4: 3 4: 3
Completion Action
Completion Action
Initial Speed Initial Speed 10 m/s 10 m/s
Hover Hover
Aircraft Heading
Aircraft Heading Gimbal PitchGimbal
Angle Pitch Angle -20° -20°
Follow RouteFollow Route
2. Camera
DJI Terra can recognize the camera model of the aircraft. Unless otherwise specified, users
don’t need to set it.
3. Ratio
Refers to the ratio of the width and height of the photos captured during the mission.
Return and Hover: The aircraft will return to the starting point of the flight path and hover after the
mission is complete. The altitude when returning to the starting point is the same as RTH altitude.
Make sure that the endpoint of the flight path is suitable for landing when completion action
is set to “Land in Place” to avoid potential flight accidents.
7. Interval
This setting will appear when capture mode is set to Timed Shot.
If capture mode, route speed, or gimbal pitch angle are set in “Route Settings,” the capture
mode, speed, or gimbal pitch angle setting in “Waypoint Settings” will automatically change
to the same as the one in “Route Settings.”
Waypoint Settings
Waypoint 01 Waypoint 01
Speed Speed 10 m/s 10 m/s
Capture Mode Capture Mode
Min Angle Min Angle Turn Radius Turn Radius 8.2 m 8.2 m
Select a waypoint (it will turn blue when selected) then set waypoint parameters. Click or to
switch to the previous or next waypoint. The keyboard shortcut “Ctrl+ ← ” or “Ctrl+ → ” can also be
used to switch accordingly.
1. Capture Mode
Waypoint Hovering Shot: The aircraft will hover and capture at the selected waypoint.
Time Shot: The aircraft will capture in a fixed time interval as it flies from the selected waypoint to
the next waypoint. The aircraft will not hover during capturing. Users can set the time interval.
2. Turning Mode
The aircraft rotation direction when flying to the next waypoint. This option will be available only if
“Set Waypoint Separately” is set for “Aircraft Heading” in “Route Settings”. “Min Angle” and “Max
Angle” respectively indicate that the aircraft will rotate in the direction with a min or max rotation
angle to adjust its heading to the pre-set value of the next waypoint.
3. Interval
This setting will appear when capture mode is set to Timed Shot.
4. Altitude
Set the relative altitude of each waypoint between the aircraft and the takeoff point. The range
can be set from -120 m to 500 m with a negative value lower than the takeoff point and a positive
value higher than the takeoff point. When the altitude of the start point is set to a negative value,
indicating that the start point is lower than the takeoff point, make sure to click for the setting,
read and comply with the warning message: To ensure flight safety, when the altitude of the first
waypoint is lower than the takeoff point altitude, fly the aircraft to an obstacle-free environment
before starting the flight mission.
During 3D mission planning, the altitude at each waypoint is the relative altitude between the
aircraft and the scene in the 3D model below the corresponding waypoint.
5. Speed
The aircraft will ascend/descend to the flight speed set here when flying to the selected waypoint
and then contitues flying at this speed. The range can be set from 0.2 to 13 m/s.
© 2019 DJI All Rights Reserved. 15
DJI TERRA User Manual
7. Turn Radius
This is the aircraft’s turn radius when flying past a waypoint. Radius can range from 0.2 to 1000 m.
This option will be available only if “Coordinated Turn” is enabled in “Route Settings”. Note that
the “Turn Radius” setting is unavailable for start and stop points, and the sum of the turn radius
of two neighboring waypoints should not exceed the distance between the two waypoints.
8. Action
Click to enter. Up to 15 actions can be added. Delete actions or re-order them.
Add Actions: Click to add. Actions will be performed in the order they are added unless re-
ordered.
a. Hover: The aircraft will hover at the waypoint. Set hovering time from 0 to 30000 ms.
b. Capture: Capture on arrival at a waypoint. Note that Capture cannot be performed if the
camera is recording.
c. Start Recording: Start recording on arrival at a waypoint.
d. Stop Recording: Stop recording on arrival at a waypoint.
e. Aircraft Heading: Adjust the aircraft heading on arrival at a waypoint. North is 0° with a
negative value representing clockwise and the range is -180° to 180°.
f. Gimbal Pitch: Adjust the gimbal pitch angle on arrival at this waypoint. Pitch angle can range
from -90° to 0°, with downward represented by -90° and forward represented by 0°. If “Gimbal
Pitch Angle” is set as a value in “Waypoint Settings”, the aircraft will fly to the waypoint with
the defined Gimbal Pitch Angle then adjust it according to the Gimbal Pitch settings defined
when adding an Action for the current waypoint.
Delete Action: Click on the right side of the desired action to delete it.
Re-Order: Click and hold on the left side of the desired action, drag it to the desired position
and release.
DO NOT add Start Recording after Capture. Otherwise recording cannot be started.
DO NOT add Capture after Stop Recording. Otherwise a picture cannot be captured.
Basic Settings
Basic Basic
Advanced Advanced
Camera Camera Basic Basic
Advanced Advanced
Camera Camera
Real-Time
Real-Time 2D Mapping2D Mapping CompletionCompletion
Action Action
Return to Home
Return to Home
Real-Time
Real-Time 3D 3D Point Cloud
Point Cloud
GSD GSD 2.74 cm/pixel
2.74 cm/pixel
Mapping Scenes
Mapping Scenes Mission Altitude
Mission Altitude 100 m 100 m
Field Field
Speed
Speed (Nadir View)(Nadir View) 10 m/s 10 m/s
CompletionCompletion
Action Action
Return to Home
Return to Home
Max. SpeedMax. Speed 13m/s
13m/s Set Set
Mission Altitude
Mission Altitude 100 m 100 m
Route 3 Route 3 4
Route Route 4
Mapping Oblique
Real-time 3D point cloud is only available when using the Phantom 4 RTK, Phantom 4 Pro
V2.0+ or Phantom 4 Pro V2.0 aircraft. The real-time 2D mapping and real-time 3D point
cloud cannot be enabled simultaneously.
© 2019 DJI All Rights Reserved. 17
DJI TERRA User Manual
Make sure that the end poit of the flight path is suitablefor landing when completion action
is set to “Land in Place” to avoid potential flight accidents.
5. GSD
Ground Sample Distance. This value is the actual ground distance represented by each pixel
in the original image captured, and is automatically calculated by DJI Terra based on the flying
altitude and camera model.
For Oblique missions, if required, users can adjust the location of the start point for each
flight route after planning the routes. Click the start point or end point to switch the two.
Advanced Settings
Basic Basic
Advanced Advanced
Camera Camera
Side OverlapSide
RatioOverlap Ratio 74% 74%
Forward Overlap
Forward
RatioOverlap Ratio 74% 74%
Basic Basic
Advanced Advanced
Camera Camera
Side OverlapSide
RatioOverlap Ratio 74% 74% Side OverlapSide
RatioOverlap
(Oblique)
Ratio (Oblique)66% 66%
Forward Overlap
Forward
RatioOverlap Ratio 66% 66% Forward Overlap
Forward
RatioOverlap
(Oblique)
Ratio (Oblique)
66% 66%
Course AngleCourse Angle 287º 287º Course AngleCourse Angle 287º 287º
Relative Height
Relative Height 30 m 30 m Relative Height
Relative Height 30 m 30 m
Mapping Oblique
4. Margin
Expand (positive value) or narrow (negative value) the area margin for control over the area of
flight. The range can be set from -30 to +30m.
© 2019 DJI All Rights Reserved. 19
DJI TERRA User Manual
Users can adjust the overlap ratios, altitude, and gimbal pitch angle (for Oblique mission
only) according to actual situations. Reduce overlap ratio accordingly for areas with
less terrain fluctuations. Increase overlap ratio accordingly for areas with more terrain
fluctuations. However, it is recommended to set a side overlap ratio of no less than 60%
and a forward overlap ratio of no less than 65%. For objects that require highly detailed
results, create multiple missions to cover more perspectives of the desired area or object.
Camera Settings
Basic Advanced
Basic Camera
Advanced Camera
Camera Camera
Phantom 4 RTK Phantom 4 RTK
Basic Advanced
Basic Camera
Advanced Camera
Ratio Ratio
Camera Camera
4:3 4:3
Phantom 4 RTK Phantom 4 RTK
Field Field S S
Exposure Compensation
Exposure Compensation
-0.3 -0.3
Undistortion Undistortion
Mapping Oblique
1. Camera
DJI Terra can recognize the camera model of the aircraft. Unless otherwise specified, users
don’t need to set it.
2. Ratio
Set the photo ratio of the photos captured during the mission. 4:3 is recommended.
3. Balance
Field is set by default. Users can select other options according to the application.
5. Undistortion
This option will appear when using the Phantom 4 RTK. It is disabled by default. If enabled, the
software can automatically correct the distortion when capturing, but the quality of the photos
captured may be lower than the photo quality when this option is disabled. It is recommended to
disable this option when original photos are needed for post processing.
Corridor Settings
Completion Action
Basic Settings
1. Route Preview
When enabled, the flight route generated according to the current settings can be previewed on
the map. During route preview, users cannot edit the corridor points on the center line.
6. GSD
Ground Sample Distance. This value is the actual ground distance represented by each pixel
in the original image captured, and is automatically calculated by DJI Terra based on the flying
altitude and camera model.
8. Speed
The flight speed of the aircraft during mission. When flying out of the flight path such as flying
from the current position to the starting point when mission starts, or flying back after mission
completion, the flight speed will be 13 m/s, which cannot be customized.
Advanced Settings
Basic Advanced Camera
Collection Mode
Full Coverage
Relative Height 30 m
Full Coverage: An additional route will be added on both left and right edges of the corridor
flight area when generating the flight route.
High Efficiency: The generated flight route can only cover the corridor flight area.
Ratio
Camera
4:3
Phantom 4 RTK
White Balance
Ratio
Field
4:3
Field S
1. Camera
DJI Terra can recognize the camera model of the aircraft. Unless otherwise specified, users
don’t need to set it.
2. Ratio
Set the photo ratio of the photos captured during the mission. 4:3 is recommended.
3. Balance
Field is set by default. Users can select other options according to the application.
5. Undistortion
This option will appear when using the Phantom 4 RTK. It is disabled by default. If enabled, the
software can automatically correct the distortion when capturing, but the quality of the photos
captured may be lower than the photo quality when this option is disabled. It is recommended to
disable this option when original photos are needed for post processing.
More Functions
KML files can be imported onto DJI Terra to add waypoints or edge points of a flight area. In a
Waypoints mission, 2D / 3D Mission Planning based on an existing or newly created reconstruction
is available. For Mapping missions, there are various functions available such as Real-Time 2D
Mapping, 2D Map Reconstruction (for field, fruit tree, and urban scenes), Agricultural Application,
Real-Time 3D Point Cloud, Output Coordinate System Selection, 3D Model Reconstruction, and
GCP Management. For Oblique missions, users can create flight missions resulting in more detailed
3D models. For Corridor missions, 2D Map Reconstruction and 3D Model Reconstruction are also
available.
See the table below which provides an overview of DJI Terra's more advanced features and funcrions.
Features Advanced Pro
Real-time 2D Mapping √ √
Agricultural application √ √
KML file import √ √
2D Reconstruction (Field) √ √
2D Reconstruction (Urban) √ √
Output Coordinate System √ √
3D Reconstruction √
3D Mission planning √
GCP √
Purchase Licenses
Users can purchase licenses for DJI Terra Advanced or Pro version on the product page on the official DJI
website. DJI will send the activation code via an email once purchased successfully. See the details below.
Launch DJI Terra > > Activated License(s) > Buy New License(s). Users will be redirected to
the official DJI website to get the details about the functions of different versions. Users can also
be redirected to the official DJI website by clicking the corresponding button where Real-Time 2D
Mapping, Real-Time 3D Point Cloud, Reconstrctun, Output Coordinate System, GCP Management,
Agriculture, KML File Import, or 2D/3D function is required.
To purchase DJI Terra Advanced or Pro, visit the DJI Terra product page at https://www.dji.com/
dji-terra . Input your information on the contact form, and then wait for a DJI authorized dealer to
respond to your request.
Reconstruction
After a Mapping, Oblique, or Corridor mission is complete, users can use the Reconstruction
function with the original photos captured by the aircraft to obtain a high-precision 2D map or 3D
model. After a model has been produced, users have the option to add annotation and perform
a variety of measurements. For Mapping and Corridor missions, both 2D reconstruction and 3D
reconstruction are achievable, and agriculture-specific functions can be done based on a 2D
map. For Oblique missions, only 3D reconstruction is available. If the imported photos include a
PPK result file from the Cloud PPK Service of the Phantom 4 RTK, this PPK file can be used for
2D or 3D reconstructions at a higher accuracy. If the imported photos are captured using the P4
Multispectral, you can reconstruct 2D multispectral maps.
2D Reconstruction
If “Real-Time 2D Mapping” is disabled during a mission, the user can perform 2D map
reconstruction after the aircraft has completed its mission. If “Real-Time 2D Mapping” is enabled,
2D map reconstruction cannot be performed in the corresponding mapping mission. Users should
create a new Mapping mission to perform map reconstruction.
Reconstruction Procedure
1. Click the desired mission on the mission library. Then enter the reconstruction page through one
of the following methods:
© 2019 DJI All Rights Reserved. 25
DJI TERRA User Manual
a. Click .
b. Click to enter Mission Editing View, and then click in the parameter list.
Add Photo
Resolution Medium
Start Reconstruction
It is recommended to select at least six photos on two main paths for reconstruction.
3. After import, the icon will appear on the upper right corner of the map view. Click to turn it
blue indicating that capture location display is enabled. The corresponding location of the photos
captured will be displayed on the map as a dot. Click on the right to manage the photos. The
photos are grouped by the folders they are located. Expand the list to view and manage photos.
If capture location display is enabled, click the name of the photo to turn it blue and the
corresponding dot on the map will turn orange. Similarly, when you click the dot on the map, its
corresponding photo name in the list will turn blue.
Double-click a photo to view in a large size and zoom in or out.
Click “Manage,” select photos and then click “Delete” to delete photos. Click “Cancel” to exit
management.
Click to return to the reconstruction page.
4. Select “2D Map” as the reconstruction type.
5. Select the desired mapping scene. Field is suitable for open areas with objects of small height
difference such as farmland, Urban is suitable for areas with more buildings, and Fruit Tree is
suitable for areas with objects of large height difference such as orchard.
If Fruit Tree is selected, DJI Terra will recognize in the reconstruction result to mark different
areas such as fruit trees, buildings, and ground. After reconstruction, in Agriculture page, users
can add boundary points of a flight area and calibration point(s) in the Fruit Tree tag and DJI
Terra can automatically generate a flight path according to the recognition results. For more
information, refer to “Agricultural Application” on p. 29.
6. Select the desired resolution. High refers to the original resolution, Medium refers to 1/2 of the
original resolution (i.e. the length and width are both 1/2 of the original photo), and Low refers
to 1/3 of the original resolution (i.e. the length and width are both 1/3 of the original photo). For
example, if the original photo resolution is 6000x6000, the high resolution is the same, while the
medium resolution is 3000x3000, and the low resolution is 2000x2000.
7. Set the output coordinate system and manage GCPs if required. Refer to the section below for
details.
8. Click “Start Reconstruction,” a pop-up window will appear to ask if a user wants to copy the
photos to the mission folder. If a user chooses to save a copy, the added photos will be copied
to the current mission folder and they will be included in the mission file when exporting a
mission. If the user does not save a copy, the added photos will not be copied and will not be
included when exporting a mission. Then click “Continue” to start reconstruction. The progress
bar at the bottom will show the mapping progress. Click “Stop” to stop mapping, and the
progress will be saved.
9. Multiple reconstruction missions can be started. Before the first mission finishes, other missions
will be lined up and processed in order.
10. After mapping, the result will be shown in the map view. Zoom in or out to view the map at different
levels. Annotation and measurement and agriculture applications are also available.
11. Click “Quality Report” to view and save a report in html format. The report includes reconstruction
result overview, RTK status, camera calibration information and process information. Refer to the
document How to Read a DJI Terra Quality Report for 2D Maps on the official DJI website for details.
Measurement
Coordinate Manage
Measurement 1
Measurement 2
© 2019 DJI All Rights Reserved. 27
DJI TERRA User Manual
Coordinate
1. Click to enter Coordinate Adding mode.
2. Click on the map to add a coordinate. Drag to adjust its position. Click on top to delete the
coordinate. The box below the coordinate shows the name, longitude, and latitude, indicating
that the coordinate is in editing status. Click the text box of the name to input the name, then
click “Save” to exit editing.
Coordinate
Longitude 114.191106276392
Latitude 22.358588422040
Save
3. The coordinate list displays the added coordinates. Click to expand the information to view
the longitude and latitude and change the name.
Distance
4. Make sure that there is no coordinate in editing status. Click “Manage,” and select coordinates
Horizontal Distance 2199.28m
(the outer box of the coordinate will turn blue when selected) to export or delete them.
Cancel Save
Distance
1. Click to enter distance measurement mode.
2. Click the left mouse button on the map to add measurement points. Drag to adjust the position.
The selected point is red, while the unselected
Coordinate
point is gray. Click on top to delete the selected
point. Click to delete all the points in this114.191106276392
measurement. Click the right mouse button to end
Area
Longitude
in editing status when the measurement is not ended or saved. To exit editing status, end the
measurement and save.
Distance
Coordinate
Horizontal
Longitude Distance 2199.28m
114.191106276392
Latitude 22.358588422040
Cancel Save
Save
3. The process to view and manage distance measurements is the same as the one used for
coordinates.
Area
Distance
Area
Area
Horizontal Distance 5667.84m
2199.28m
2
The only difference is that there are three measurements points required before ending the
measurement, which is achievable by clicking the right mouse button.
Area
Area 5667.84m2
Save
Agricultural Application
Click on the right of Agricultural Application bar to enter the page. Users can plan operations for
fields or fruit trees on the 2D map. Planning includes Boundary, Polygon Obstacle, Round Obstacle,
and Calibration Point.
Field
New Mapping Mission
Choose Type
Create Next
Boundary
1. Click “Boundary” and click the desired positions on the map to add edge points for the field.
2. After adding edge points for one field, click “Create” to add edge points for the next field.
3. Click “Next” to switch between different fields.
4. Click a point shown on the map to select it, drag to adjust its position, click to delete it, and
click to clear information of all types.
5. The panel will display the number and area of the current field and the number, longitude, and
latitude of the current edge point. Users can adjust the edge point position via typing longitude
and latitude values and using the arrow keys.
Polygon Obstacle
1. Click “Polygon Obstacle” and click the desired positions on the map to add edge points for the
field.
2. After adding edge points for one obstacle, click “Create” to add edge points for the next
obstacle.
3. Click “Next” to switch between different obstacles.
4. Click a point shown on the map to select it, drag to adjust its position, click to delete it, and
click to clear information of all types.
5. The panel will display the number and area of the current obstacle zone and the number,
longitude, and latitude of the current obstacle edge point. Users can adjust the edge point
position via typing longitude and latitude values and using the arrow keys.
Round Obstacle
1. Click “Round Obstacle” and click the desired position on the map. Then a dot will appear on the
map. Drag it to adjust the radius of the round obstacle.
© 2019 DJI All Rights Reserved. 29
DJI TERRA User Manual
Calibration Point
1. Click “Calibration Point” and click the desired position on the map to add a calibration point.
Users can add several calibration points.
2. Drag a calibration point to adjust its position, click to delete it, and click to clear
information of all types.
3. The panel will display the number, longitude, and latitude of the current calibration point. Users
can adjust the calibration point position via typing longitude and latitude values and using the
arrow keys.
Planning Complete
1. Click to save the mission.
2. Click and the mission will be uploaded to DJI Agriculture Management Platform. Agras
aircraft users can download the mission from the platform to the DJI MG app.
3. Click and the mission will be exported to the microSD card in the remote controller connected
to the computer. Insert the card into the Agras remote controller and import the mission in the
prompted menu in DJI MG.
Fruit Tree
Spraying Type
Continuous Spraying
Spot Spraying
Modify Result
Generate Route
1. Select Spraying Type. When using an Agras aircraft to perform the flight mission generated by
DJI Terra, the aircraft will spray according to the selected type. Continuous spraying refers to
spraying when flying within a recognized fruit tree area. Spot spraying refers to spraying only
when flying to the tree crown center of the recognized fruit tree area.
2. If Display Result is enabled, recognition for different areas such as fruit trees, buildings, ground,
water and poles will be displayed on the map.
3. Click Modify Result to modify the recognition result manually. Operation varies for different
spraying types.
• When continuous spraying is selected, use the corresponding brush for each type of area to
paint on the map to modify the recognition result.
• When spot spraying is selected, circles will be displayed on the map to mark the tree crown
centers. Click to edit them. Click the recognized tree crown center to select it, then click
to delete. Click on the map to add a tree crown center marker.
4. Click and to add boundary points and calibration points in the area that includes fruit trees.
Click the icon or to show or hide the planned farmland and calibration points.
5. Click “Generate Route.” DJI Terra will automatically generate a route for fruit tree operations.
Users can enable or disable route display and obstacle sensing, and configure route altitude,
route width, and route angle.
6. Click to save the operation. Click and the operation will be exported to the microSD
card in the remote controller connected to the computer. Insert the card into the Agras remote
controller and import the operation in the prompted menu on the DJI MG app.
3D Reconstruction
3D reconstruction is available for Mapping, Oblique, and Corridor missions, and the procedure and
result are completely the same. If “Real-Time 3D Point Cloud” is disabled during a mission, the user
can perform 3D reconstruction after the aircraft has completed its mission. If “Real-Time 3D Point
Cloud” is enabled, 3D reconstruction cannot be performed in the corresponding mission. Users
should create a new mission to perform 3D reconstruction.
Reconstruction Procedure
1. The method to enter the reconstruction page and add photos is similar to that used for 2D
reconstruction.
3D reconstruction occupies more computer resources. To ensure smooth 3D reconstruction
processes by adding an adequate amount of photos, refer to the number of photos
corresponding to the following computer configurations.
6. Point cloud option: If enabled, a 3D point cloud will be generated. The default format for the
point cloud is pnts. If LAS is selected, the point cloud output will also include a file in the las
format.
To run the reconstruction, it is required to enable at least one of the options for model or
point cloud.
7. Click “Start Reconstruction,” a pop-up window will appear to ask if users want to copy the photos
to the mission folder. If a user chooses to save a copy, the added photos will be copied to the
current mission folder and they will be included in the mission file when exporting a mission.
If a user does not save a copy, the added photos will not be copied and will not be included
when exporting a mission. Then click “Continue” to start reconstruction. The progress bar at the
bottom will show the mapping progress. Click “Stop” to stop modeling, and the progress will be
saved. If a user selects to continue after stopping a modeling session, DJI Terra will track back
slightly from the saved progress and then continue modeling.
8. Multiple reconstruction missions can be started. Before the first mission finishes, other missions
will be lined up and processed in order.
9. After modeling, users can translate and rotate the model, and zoom in or out to view it from
different angles.
There will be three icons on the right screen and the model can be viewed at different settings.
: Shows the orthographic projection of the 3D model. In this view, hold down the left mouse
button and drag to translate model.
/ : Displays the 3D model in top view or front view. In any of the two views, hold down the
left mouse button and drag to translate the model, scroll the mouse wheel or hold down the right
mouse button and drag to zoom in or out, and hold down the mouse wheel and drag to rotate.
10. Click “Quality Report” to view and save a report in html format. The report includes an overview
of the reconstruction result, RTK status, camera calibration information and process information.
Refer to the document How to Read a DJI Terra Quality Report for 3D Models on the official DJI
website for details.
© 2019 DJI All Rights Reserved. 33
DJI TERRA User Manual
The Annotation and Measurement of the 3D model also includes the function to display the camera
pose when adding coordinates.
1. Enable “Camera Pose” and the green patterns indicates the camera pose when the photo was
captured.
2. Click to enter Coordinate Adding mode.
3. Click on the model to select a point. The camera pose display of the photos including the
selected point will turn yellow, and a photo preview from the camera's perspective will be
displayed at the bottom of the screen.
4. The yellow cross in the preview photo indicates the position of the point on the model in the
photo. Click the photo, and the corresponding camera pose display will turn blue. Double-click
the photo to view in a large size and zoom in or out.
GCP Management
Ground Control Points (GCPs) are marked points on the ground with known coordinates
and are clearly visible in an image. GCPs can be obtained using photogrammetry
methods such as GPS-RTK or a total station. GCPs are used to optimize the result of aerial
triangulation. There are also check points that are used to check for the absolute accuracy
of aerial triangulation.
When generating 2D or 3D reconstructions, users can import GCPs after importing images to help
increase the robustness and accuracy of aerial triangulation, check the accuracy of the aerial
triangulation against actual measurements, and convert the aerial triangulation result into the one in
the GCP’s coordinate system. Note that the positioning and pose of the camera should be included
in the added images.
Click on the right of GCP Management bar to enter the page. The page includes GCP list,
GCP information, photo gallery, aerial triangulation view, and marking view. The marking view will
appear on the left of the aerial triangulation view after an image is selected in the photo gallery, as
shown below. Users can add GCPs, mark points, and conduct aerial triangulation calculation and
optimization.
GCP List
GCP Information
Photo
Gallery
Aerial Triangulation
In the GCP management page, DJI Terra will process the added images, and the camera
positioning and attitude information will be shown on the map when complete. Click
“Aerotriangulation” at the bottom of the screen to start aerial triangulation calculation. The result
will be shown on the screen when complete, including camera positioning and attitude and aerial
triangulation points.
Optimization
Import a GCP file and mark points on the images to optimize the aerial triangulation.
2. Importing GCPs
Click , and select the desired GCP file to import it. Users can also import GCPs with marked
points by clicking . After importing, the GCPs will be shown in both the aerial triangulation
view and GCP list.
You can only import GCP files in the json format that are exported in DJI Terra when using
to import GCPs.
3. Editing GCPs
Click to select a GCP. It will turn blue in the aerial triangulation view and GCP list when selected.
The camera position of the images that contain the selected GCP will turn yellow. The blue cross
on the thumbnail in the photo gallery represents the GCP’s projected result on the image. When
“Only display photos with GCP” is enabled, only the images on which the current GCP can be
projected and images including marking points will be displayed.
Press and hold the Ctrl key on the keyboard and click the GCPs to select multiple GCPs. Click
to delete the selected GCPs.
Click to add a GCP. Set the GCP as a control point or a check point , and input its
horizontal accuracy, vertical accuracy, and coordinates in the coordinate system the GCPs are in.
Marking
1. Select a GCP, and click one of the images including the selected GCP in the photo gallery. The
marking view will display on the left of the aerial triangulation view. The blue cross in the marking
view represents the GCP’s projected result on the image.
© 2019 DJI All Rights Reserved. 37
DJI TERRA User Manual
2. In the marking view, hold the left button on the mouse to drag the image, scroll to zoom in and
out. Click on the image using the yellow cross to mark the GCP’s actual location in the image.
The marked point is displayed in the marking view and photo gallery with a green cross, and
there will be a check mark on the upper right corner of the image in the photo gallery, indicating
that this is an image with a marked point.
3. Delete marked points: Select the images with marked points in the photo gallery, and press the
Delete key on the keyboard or click on the top of the marking view.
4. Export GCP file: Click to export a json file including GCPs and marked points, which can be
applied to other missions including the same images with marked points.
5. For the same GCP, the blue cross location will be updated according to the marked point
location after each marking from the third image on. The reprojection error and 3D point error will
also be updated.
To ensure the robustness of the post aerial triangulation optimization, it is recommended to
mark at least four images for each GCP and make sure that the GCPs with marked points
are as evenly distributed as possible in the mapping area. The recommended number of
GCPs is no less than four (the type of the point should be set to GCP). Check points can be
set according to the demand of the mission.
Optimization
1. After marking points, click “Optimize” at the bottom of the screen for aerial triangulation
optimization. The aerial triangulation display will be updated when complete.
2. Select one of the GCPs to view the reprojection error and 3D point error after aerial triangulation
optimization in the GCP information section. If the 3D point error is too large, adjust the marked
points and repeat optimization until the error meets your requirements.
Aerial triangulation optimization can be done repeatedly. Remember to click “Optimize”
to update the aerial triangulation result once you adjust the marked points, change the
coordinate system, and edit the GCPs. If optimization is not run after adjustment, when you
back to the reconstruction page, the reconstruction will be done using the previous aerial
triangulation result.