Format specifications when importing a Timeline Mission

Missions created using external tools can be imported into Airpeak Base.

KML files

Airpeak Base supports the import of KML files with the following data formats.

• Keyframe position: Latitude, longitude, and altitude of the aircraft
• Camera-target position
• Altitude reference point (ground or sea level)
• Angle of Gimbal
• Photo shooting point and Movie recording period

For KML files, specify the following tags.

Sample 1

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Document>
    <name>SonyGroup</name>
    <Placemark>
      <altitudeMode>relativeToGround</altitudeMode>
      <LineString>
        <coordinates>
          139.74437852691824,35.63158873146365,80
          139.74322785925085,35.63167811325995,80
          139.74312325309927,35.630801731333435,80
          139.7444053490084,35.630694908003875,80
          139.74442948888952,35.63158655141858,80
        </coordinates>
      </LineString>
    </Placemark>
  </Document>
</kml>

Header

Tag	Explanation
<?xml version="1.0" encoding="UTF-8"?>	First line of a KML file Fixed value. No spaces or other characters may precede this line.

Namespaces

Tag	Explanation
<kml xmlns=http://www.opengis.net/kml/2.2> </kml>	Second line of a KML 2.2 file Fixed value.

Reguired Tags

Tag	Value	Explanation
<Document> </Document>	None	KML data structure
<name> </name>	String	Mission name Specify mission name using any string of characters.
<Placemark> </Placemark>	None	Mission data structure
<LineString> </LineString>	None	Flight path data structure
<altitudeMode> </altitudeMode>	relativeToGround (default) or absolute	Altitude reference point If you specify relativeToGround, the altitude reference point will be the ground, and altitude will be interpreted as the altitude above ground level. If you specify absolute, the altitude reference point will be sea level, and altitude will be interpreted as the altitude above sea level. If this entry is omitted or is entered as something other than relativeToGround or absolute, the altitude reference point will default to relativeToGround.
<coordinates> </coordinates>	longitude,latitude,altitude	longitude, latitude (WGS84 geodetic system) altitude (m) The altitude value is specified by <altitudeMode> and is that height when the reference point is 0. This section specifies all the keyframes the aircraft will traverse during the mission.

Sample 2

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
  <Document>
    <name>userguide</name>
    <Placemark>
      <LineString>
        <altitudeMode>relativeToGround</altitudeMode>
        <coordinates>
          139.74437852691824,35.63158873146365,80
          139.74322785925085,35.63167811325995,80
          139.74312325309927,35.630801731333435,80
          139.7444053490084,35.630694908003875,80
          139.74442948888952,35.63158655141858,80
        </coordinates>
      </LineString>
      <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
        <airpeak:timestamps>0 78877 152490 240442 315000</airpeak:timestamps>
        <airpeak:durationSec>315</airpeak:durationSec>
        <airpeak:onComplete>RTH</airpeak:onComplete>
      </ExtendedData>
    </Placemark>
    <Folder>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>0</airpeak:timestamp>
          <airpeak:headingRotation>-1</airpeak:headingRotation>
          <airpeak:longitudePOI>139.7416302647648</airpeak:longitudePOI>
          <airpeak:latitudePOI>35.630331826332196</airpeak:latitudePOI>
          <airpeak:altitudePOI>0</airpeak:altitudePOI>
          <airpeak:influence>1</airpeak:influence>
        </ExtendedData>
        <Camera>
          <heading>275.4595746219549</heading>
          <tilt>90</tilt>
        </Camera>
      </Placemark>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>78877</airpeak:timestamp>
          <airpeak:headingRotation>-1</airpeak:headingRotation>
        </ExtendedData>
        <Camera>
          <heading>275.4595746219549</heading>
          <tilt>90</tilt>
        </Camera>
      </Placemark>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>78997</airpeak:timestamp>
          <airpeak:photoShooting>1</airpeak:photoShooting>
          <airpeak:longitudePOI>139.74297136927225</airpeak:longitudePOI>
          <airpeak:latitudePOI>35.63026206376388</airpeak:latitudePOI>
          <airpeak:altitudePOI>0</airpeak:altitudePOI>
          <airpeak:influence>1</airpeak:influence>
        </ExtendedData>
      </Placemark>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>86377</airpeak:timestamp>
          <airpeak:headingRotation>-1</airpeak:headingRotation>
        </ExtendedData>
        <Camera>
          <heading>185.5412352473106</heading>
        </Camera>
      </Placemark>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>152490</airpeak:timestamp>
          <airpeak:headingRotation>-1</airpeak:headingRotation>
        </ExtendedData>
        <Camera>
          <heading>185.5412352473106</heading>
          <tilt>90</tilt>
        </Camera>
      </Placemark>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>153000</airpeak:timestamp>
          <airpeak:photoShooting>1</airpeak:photoShooting>
          <airpeak:longitudePOI>139.74436611796</airpeak:longitudePOI>
          <airpeak:latitudePOI>35.63014869946048</airpeak:latitudePOI>
          <airpeak:altitudePOI>1.1102230246251565e-16</airpeak:altitudePOI>
          <airpeak:influence>1</airpeak:influence>
        </ExtendedData>
      </Placemark>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>159990</airpeak:timestamp>
          <airpeak:headingRotation>-1</airpeak:headingRotation>
        </ExtendedData>
        <Camera>
          <heading>95.85259863593586</heading>
        </Camera>
      </Placemark>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>240247</airpeak:timestamp>
          <airpeak:photoShooting>1</airpeak:photoShooting>
        </ExtendedData>
      </Placemark>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>240442</airpeak:timestamp>
          <airpeak:headingRotation>-1</airpeak:headingRotation>
        </ExtendedData>
        <Camera>
          <heading>95.85259863593586</heading>
          <tilt>90</tilt>
        </Camera>
      </Placemark>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>240495</airpeak:timestamp>
          <airpeak:longitudePOI>139.7456643071232</airpeak:longitudePOI>
          <airpeak:latitudePOI>35.63007893673232</airpeak:latitudePOI>
          <airpeak:altitudePOI>0</airpeak:altitudePOI>
          <airpeak:influence>1</airpeak:influence>
        </ExtendedData>
      </Placemark>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>247942</airpeak:timestamp>
          <airpeak:headingRotation>-1</airpeak:headingRotation>
        </ExtendedData>
        <Camera>
          <heading>1.260576853622922</heading>
        </Camera>
      </Placemark>
      <Placemark>
        <ExtendedData xmlns:airpeak="https://base.airpeak.sony.com/trajectories">
          <airpeak:timestamp>315000</airpeak:timestamp>
          <airpeak:headingRotation>-1</airpeak:headingRotation>
        </ExtendedData>
        <Camera>
          <heading>1.260576853622922</heading>
          <tilt>90</tilt>
        </Camera>
      </Placemark>
    </Folder>
  </Document>
</kml>

Optional Tags

Tag	Value	Explanation
<ExtendedData> </ExtendedData>	None	Mission data structure of extended data xmlns:airpeak="https://base.airpeak.sony.com/trajectories"
<airpeak:durationSec> </airpeak:durationSec>	Int	Flight duration of mission (sec)
<airpeak:onComplete> </airpeak:onComplete>	String	Finish action of mission RTH: Return to home (=Take-off point) Hover: Hovering at the end point of mission
<airpeak:timestamps> </airpeak:timestamps>	Int []	Timestamps of keyframes in <LineString> Length of array shall be same as one of <coordinates>.
<Folder> </Folder>	None	Camera data structure Multiple <Placemark> are included.
<airpeak:timestamp> </airpeak:timestamp>	Int	Timestamp of camera data in <Folder> (msec)
<airpeak:headingRotation> </airpeak:headingRotation>	Int	Number of gimbal rotations Value at the start point is set to 0. Increment if gimbal rotate clockwise across the orientation to 0° (north), and decrement if rotate counterclockwise.
<airpeak:photoShooting> </airpeak:photoShooting>	1	Trigger of photo shooting Set 1 for shooting point. Delete tag itself for no trigger.
<airpeak:movieRecordingStart> </airpeak:movieRecordingStart>	1	Trigger of start video recording Set 1 for movie-rec start point. Delete tag itself for no trigger.
<airpeak:movieRecordingStop> </airpeak:movieRecordingStop>	1	Trigger of stop video recording Set 1 for movie-rec stop point. Delete tag itself for no trigger.
<airpeak:longitudePOI> </airpeak:longitudePOI>	Float	Longitude of camera target (WGS84 geodetic system)
<airpeak:latitudePOI> </airpeak:latitudePOI>	Float	Latitude of camera target (WGS84 geodetic system)
<airpeak:altitudePOI> </airpeak:altitudePOI>	Float	Altitude of camera target (m) Value is specified by <altitudeMode> and is that height when the reference point is 0.
<airpeak:influence> </airpeak:influence>	Float	Degree of influence of camera target Set the value between 0.0 and 1.0. If you set the value to 0.0, the camera will face the same direction as Direction with no influence from the target value. If you set the value to 1.0, the camera will face the direction of the target with no influence from the Direction value.
<Camera> </Camera>	None	Camera angle data structure
<heading> </heading>	Int	Pan angle of camera (°) Set the value between 0 and 360.Value is the angle when the north orientation is 0°.
<tilt> </tilt>	Int	Tilt angle of camera (°) Set the value between -180 and 180.Value is the angle when the ground orientation is 0°.
<roll> </roll>	Int	Roll angle of camera (°) Set the value between -180 and 180. Value is the angle when the horizontal orientation is 0°.