HomeGuides
Log In
Guides
These docs are for v4.19. Click to read the latest docs for v5.14.

Importing routes

UgCS software allows route import in several formats: .JSON, .KML and .CSV.

JSON file import:

Click on the "Add new route" button

46

Browse for the file in .json format and click the button "Next".

568

KML file import:

Click on the "Add new route" button;
Browse for the file in .kml format and click the button "Next"

570

While importing KML UgCS read elements from Placemark. If Placemark contains MultiGeometry with several elements all of them will be imported.

LineString - while importing can be converted into Waypoint, Corridor mapping, Vertical Scan, or Lidar corridor by user choice. For Vertical scan, Corridor mapping and Lidar corridor points altitude will be ignored. Waypoint will save altitude mode and altitude value from KML.

LineRing - while importing can be converted into AreaScan, Photogrammetry, Perimeter or Lidar area, by user choice. Waypoint mode and points altitude will be ignored.

CSV file import:

Click on the "Add new route" button;
Browse for the file in .kml format and click the button "Next"

568

There are two ways to describe data in CSV:

•without column names (headers) - in that case, a column order defines a data meaning;
•with column names (header) - in that case, column names (headers) a data meaning.

CSV sch****ema without column names (header):
CSV file must have 3 mandatory fields: "Latitude", "Longitude", "AltitudeAGL". The fourth field "Speed" is optional. Please note the header is ignored if it contains letters.

CSV schema with column names (header):
To recognize data column names are used. CSV file can contain any number of columns, but only columns with the following names are used to get data:

Column name

Values

Required

Data meaning

WP

Int

No

The waypoint number in the route.
If not specified then the waypoints are ordered by row number.

Latitude

Double

Yes

The latitude of the waypoint.

Longitude

Doube

Yes

The longitude of the waypoint.

AltitudeAGL

Double

Required if AltitudeAMSL not specified

The AGL altitude of the waypoint.

AltitudeAMSL

Double

Required if AltitudeAGL not specified

The AMSL altitude of the waypoint

Speed

Double

No

"Flight speed" attribute value of the waypoint. If not specified then 5 m/s.

Picture

False (case insensitive)

No

If true then "Set camera mode" action with option "Shot" is created for the waypoint.

UavYaw

Double 0.00-360.00 If the value is out of the range then it is automatically converted to the value in the range

No

Drone Yaw (degrees relative to the north).

If specified then the "Change yaw" action with corresponding "Yaw" relative to the north is created for the waypoint.

CameraTilt

Double 0.00-360.00 If the value is out of the range then it is automatically converted to the value in the range

No

Camera till (degrees). If specified then the "Set camera attitude" action with corresponding "Tilt" is created for the waypoint.

WaitTime

Double

No

Wait time (seconds). If specified then the "Wait" action with corresponding "Wait duration, s" is created for the waypoint.

Separator - ',' (comma)

Example:

Latitude,Longitude,AltitudeAMSL,Speed,Picture,WP,CameraTilt,UavYaw

1.331213958,103.7424341,130,1,FALSE,1

1.331433271,103.7422533,131.7965138,1,TRUE,2,0,-145.4353298

1.331479854,103.7421857,131.7965138,1,TRUE,3,0,-145.4353298

1.331539018,103.7422265,131.7965138,1,FALSE,4

1.331596448,103.7421663,131.7965138,1,TRUE,5,0,-145.4353298

1.331643031,103.7420987,131.7965138,1,TRUE,6,0,-145.4353298

1.33167128,103.7420184,131.7965138,1,TRUE,7,0,-145.4353298

1.33169557,103.7419354,131.7965138,1,TRUE,8,0,-145.4353298

1.33171277,103.7418475,131.7965138,1,TRUE,9,0,-145.4353298

1.331749747,103.741873,126.7965138,1,FALSE,10