Common Elements
Information Introduction
The fields of DJI WPML are introduced as follows:
- The fields used only in
template.kml
file are introduced in Template.kml. - The fields used only in
waylines.wpml
file are introduced in Waylines.wpml. - Common fields for
template.kml
file andwaylines.wpml
file are introduced in Common Elements.
Common Element
<wpml:droneInfo>
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:droneEnumValue | drone type | int | - | For the drone type enumeration value, please refer to the type in the Enumeration Values of Aircraft, RC and Dock in the Product Support page. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:droneSubEnumValue | drone sub type | int | - | For the drone sub type enumeration value, please refer to the sub_type in the Enumeration Values of Aircraft, RC and Dock in the Product Support page. | Note: This element is required when droneEnumValue is 67(M30/M30T). | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
<wpml:payloadInfo>
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadEnumValue | payload type | int | - | For the payload type enumeration value, please refer to the type field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:payloadPositionIndex | The position where the payload is mounted | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
<wpml:payloadParam>
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | payload position index | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:focusMode | payload focus mode | enum_string | - | firstPoint: Auto-focus on the first waypoint custom: Focus using calibrated focus value | - | M300 RTK, M350 RTK |
wpml:meteringMode | payload metering mode | enum_string | - | average: Global metering spot: Spot metering | - | M300 RTK, M350 RTK |
wpml:dewarpingEnable | dewarping enable | bool | - | 0: Disabled 1: Enabled | - | M300 RTK, M350 RTK |
wpml:returnMode | LiDAR return mode | enum_string | - | singleReturnStrongest: Single return dualReturn: Dual return tripleReturn: Triple return | - | M300 RTK, M350 RTK |
wpml:samplingRate | sampling rate | int | Hz | 60000, 80000, 120000, 160000, 180000, 240000 | - | M300 RTK, M350 RTK |
wpml:scanningMode | scanning mode | enum_string | - | repetitive: Repetitive scanning nonRepetitive: Non-repetitive scanning | - | M300 RTK, M350 RTK |
wpml:modelColoringEnable | model coloring enable | bool | 0: No coloring 1: True color coloring | - | M300 RTK, M350 RTK | |
wpml:imageFormat | image format list | enum_string | wide: Stores wide-angle lens photos zoom: Stores zoom lens photos ir: Stores infrared lens photos narrow_band: Stores narrow-band lens photos visible: Visible light photos * Note: To store photos from multiple lenses, format as " <wpml:imageFormat>wide,ir</wpml:imageFormat> " | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
<wpml:waypointHeadingParam> & <wpml:globalWaypointHeadingParam>
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:waypointHeadingMode | Heading mode | enum | - | followWayline :Along course direction. The nose of the aircraft follows the course direction to the next waypoint.manually : The user can manually control the nose orientation of the aircraft during the flight to the next waypoint.fixed : The nose of the aircraft maintains the yaw angle of the aircraft to the next waypoint after the waypoint action has been performed.smoothTransition : Customized. The target yaw angle for a waypoint is given by "wpml:waypointHeadingAngle" and transitions evenly to the target yaw angle of the next waypoint during the flight segment.towardPOI : The aircraft heading faces the point of interest. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:waypointHeadingAngle | Yaw Angle of aircraft | float | ° | [-180, 180] The target yaw angle for a given waypoint and a uniform transition to the target yaw angle for the next waypoint over the course of the flight segment. | Yes Note: Required if "wpml:waypointHeadingMode" is "smoothTransition". | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:waypointPoiPoint | Point of interest | - | - | Data format: Latitude, Longitude, Altitude Note: This field is only effective when wpml:waypointHeadingMode is set to towardPOI. Currently, the Z-direction orientation towards the point of interest is not supported, so the altitude can be set to 0. When the wpml:waypointHeadingMode for a specific waypoint is set to towardPOI, the aircraft's heading will face the point of interest while flying from that waypoint to the next waypoint. | Yes Note: Required if "wpml:waypointHeadingMode" is "towardPOI". | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:waypointHeadingPathMode | Direction of rotation of the aircraft yaw angle | enum | - | clockwise counterClockwise followBadArc : Rotation of the aircraft yaw angle along the shortest path. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
<wpml:waypointTurnParam>
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:waypointTurnMode | waypoint turn mode | enum | - | coordinateTurn : Coordinated turns, no dips, early turns.toPointAndStopWithDiscontinuityCurvature : Fly in a straight line and the aircraft stops at the point.toPointAndStopWithContinuityCurvature : Fly in a curve and the aircraft stops at the point.toPointAndPassWithContinuityCurvature : Fly in a curve and the aircraft will not stop at the point.Note: The setting method of "Turns before waypoint. Flies through." mode in DJI Pilot2/FlightHub 2 is 1) Set the "wpml:waypointTurnMode" to "toPointAndPassWithContinuityCurvature". 2) Set the "wpml:useStraightLine" to 1. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:waypointTurnDampingDist | waypoint turn damping distance | float | m | (0, the maximum length of wayline segment] * Note: The wayline segment between two waypoints should be greater than the sum of the turn intercepts of two waypoints. This element defines how far to the waypoint that the aircraft should turn. | Yes Required if "wpml:waypointTurnMode" is "coordinateTurn", "wpml:waypointTurnMode" is "toPointAndPassWithContinuityCurvature" and "wpml:useStraightLine" is 1 | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
<wpml:autoRerouteInfo>
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:missionAutoRerouteMode | mission auto reroute mode | bool | - | 0: Disable 1: Enable | Yes | M3D/M3TD, M4E/M4T |
wpml:transitionalAutoRerouteMode | transitional auto reroute mode | bool | - | 0: Disable 1: Enable | Yes | M3D/M3TD, M4E/M4T |
<wpml:actionGroup>
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:actionGroupId | action group Id Note: The ID is unique within a kmz file. It is recommended that it be monotonically and continuously incremented from 0. | int | - | [0, 65535] | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:actionGroupStartIndex | Waypoints where the action group starts to take effect. | int | - | [0, 65535] | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:actionGroupEndIndex | Waypoints where the action group stops to take effect. * Note: When the actionGroupStartIndex is the same as the actionGroupEndIndex, it means that the action group is only valid at that waypoint. | int | - | [0, 65535] Note: This element must be larger than or equal to "actionGroupStartIndex". | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:actionGroupMode | action group mode | enum | - | sequence : This means that the actions within the action group are executed sequentially. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:actionTrigger | action trigger | - | - | - | - | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:action | action list | - | - | - | - | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
<wpml:actionTrigger>
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:actionTriggerType | trigger type | enum | - | reachPoint : Executed on arrival at the waypoint.betweenAdjacentPoints : Flight routine segment trigger. Rotate the gimbal evenly.multipleTiming : Same time trigger.multipleDistance : Same distance trigger.* Note: “betweenAdjacentPoints” should be used with "gimbalEvenlyRotate". "multipleTiming" combining with "takePhoto" can achieve equal-time interval capture. "multipleDistance" combining with "takePhoto" can achieve equal-distance interval capture. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:actionTriggerParam | trigger param | float | s or m | > 0 Note:When "actionTriggerType" is "multipleTiming", this element indicates the interval time in s. When "actionTriggerType" is "multipleDistance", this element indicates the interval distance in m. | - | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
<wpml:action>
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:actionId | action id Note:The ID is unique within an action group. It is recommended that it be monotonically and continuously incremented from 0. | int | - | [0, 65535] | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:actionActuatorFunc | action type | enum | - | takePhoto startRecord stopRecord focus zoom customDirName : Create new folder.gimbalRotate : Gimbal rotation.rotateYaw : Drone rotates around the yaw axis.hover : Hover and wait.gimbalEvenlyRotate: Rotate the gimbal pitch angle evenly during the wayline segment. accurateShoot: AI Spot-Check action.(Maintenance stop. orientedShoot is recommended.) orientedShoot: Take Photo (Fixed Angle) action. panoShot: Panorama action (Supported by M30/30T, M3D/M3TD, M4E/M4T) | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:actionActuatorFuncParam | action param | - | - | - | - | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
<wpml:actionActuatorFuncParam>
takePhoto
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | The position where the payload is mounted | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:fileSuffix | The file suffix | string | - | This suffix is appended to the name of the generated media file. | Yes | M300 RTK and M350 RTK(H20/H20T/H20N/H30/H30T), M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:payloadLensIndex | Storage type of photo | List of photo format | enum-string (list) | zoom: Storing the photo taken with zoom lens wide: Storing the photo taken with wide lens ir: Storing the photo taken with infrared lens narrow_band: Storing the photo taken with narrow-band lens visable: Visible Photos * Note: Storing photos taken by multi-lens, the format is like," <wpml:payloadLensIndex>wide,ir,narrow_band</wpml:payloadLensIndex> ". It means wide lens, infrared lens, and wide-band lens are used.* | Yes | M30/M30T, M3D/M3TD, M4E/M4T |
wpml:useGlobalPayloadLensIndex | Whether use the global storage type | bool | - | 0: not use the global set 1: use the global set | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
startRecord
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | The position where the payload is mounted | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:fileSuffix | The file suffix | string | - | This suffix is appended to the name of the generated media file. | Yes | M300 RTK and M350 RTK (H20/H20T/H20N/H30/H30T), M30/M30T, M3E/M3T/M3M |
wpml:payloadLensIndex | Storage type of video | List of video format | enum-string(list) | zoom: Storing the video taken with zoom lens wide: Storing the video taken with wide lens ir: Storing the video taken with infrared lens narrow_band: Storing the video taken with narrow-band lens * Note: Storing videos taken by multi-lens, the format is like " <wpml:payloadLensIndex>wide,ir,narrow_band</wpml:payloadLensIndex> ". It means wide lens, infrared lens, and wide-band lens are used.* | Yes | M30/M30T, M3D/M3TD, M4E/M4T |
wpml:useGlobalPayloadLensIndex | Whether use the global storage type | bool | - | 0: not use the global set 1: use the global set | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
stopRecord
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | The position where the payload is mounted | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:payloadLensIndex | Storage type of video | List of video format | enum-string(list) | zoom: Storing the video taken with zoom lens wide: Storing the video taken with wide lens ir: Storing the video taken with infrared lens narrow_band: Storing the video taken with narrow-band lens * Note: Storing videos taken by multi-lens, the format is like " <wpml:payloadLensIndex>wide,ir,narrow_band</wpml:payloadLensIndex> ". It means wide lens, infrared lens, and wide-band lens are used.* | Yes | M30/M30T |
focus
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | The position where the payload is mounted | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:isPointFocus | Whether to focus | bool | - | 0 : Area Focusing. 1 : Point Focusing | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:focusX | Focal position | float | - | [0, 1] Note: The upper left corner of the focus point or focus area is at the X-axis (width) coordinates of the screen. 0 is the leftmost and 1 is the rightmost. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:focusY | Focal position | float | - | [0, 1] Note: The upper left corner of the focus point or focus area is at the X-axis (width) coordinates of the screen. 0 is the leftmost and 1 is the rightmost. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:focusRegionWidth | Focusing region width ratio | float | - | [0, 1] Note: The size of the focus area as a proportion of the overall picture, this is the width ratio. | Yes Note: Required if "isPointFocus" is "0" (area focus). | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:focusRegionHeight | Focusing region height ratio | float | - | [0, 1] Note: The size of the focus area as a proportion of the overall picture, this is the height ratio. | Yes Note: Required if "isPointFocus" is "0" (area focus). | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:isInfiniteFocus | Whether infinite focus | bool | - | 0: Not infinite focus 1: infinite focus | Yes | M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
zoom
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | The position where the payload is mounted | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:focalLength | focal length | float | mm | > 0 | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
customDirName
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | The position where the payload is mounted | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:directoryName | The name of the new folder | string | - | - | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
gimbalRotate
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | The position where the payload is mounted | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:gimbalHeadingYawBase | gimbal yaw angle rotation coordinate system | enum | - | north : Relative geographic north. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:gimbalRotateMode | gimbal rotation mode | enum | - | absoluteAngle :The angle relative to the North. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:gimbalPitchRotateEnable | Whether to enable pitch rotation of the gimbal. | bool | - | 0 : disable1 : enable | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:gimbalPitchRotateAngle | Pitch rotation angle | float | - | Note: Different gimbals can be turned in different ranges. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:gimbalRollRotateEnable | Whether to enable roll rotation of the gimbal. | bool | - | 0 : disable1 : enable | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:gimbalRollRotateAngle | roll rotation angle | float | - | Note: Different gimbals can be turned in different ranges. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:gimbalYawRotateEnable | Whether to enable yaw rotation of the gimbal. | bool | - | 0 : disable1 : enable | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:gimbalYawRotateAngle | yaw rotation angle | float | - | Note: Different gimbals can be turned in different ranges. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:gimbalRotateTimeEnable | Whether to turn on the gimbal rotation time | bool | - | 0 : disable1 : enable | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:gimbalRotateTime | Time to complete rotation of the gimbal. | float | s | - | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
gimbalEvenlyRotate
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:gimbalPitchRotateAngle | Pitch rotation angle | float | - | Note: Different gimbals can be turned in different ranges. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:payloadPositionIndex | The position where the payload is mounted | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
Note: "gimbalEvenlyRotate" rotates the pitch angle of gimbal evenly during the segments of the flight route. The trigger must be "betweenAdjacentPoints".
rotateYaw
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:aircraftHeading | Drone target yaw angle (relative to geographic north) | float | ° | [-180, 180] 0° is due north. 90° is due east. -90° is due west. -180°/180° is due south. | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
wpml:aircraftPathMode | Yaw rotation mode of drone | enum | - | clockwise counterClockwise | Yes | M300 RTK, M350 RTK |
hover
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:hoverTime | hover time | float | s | > 0 | Yes | M300 RTK, M350 RTK, M30/M30T, M3E/M3T/M3M, M3D/M3TD, M4E/M4T |
accurateShoot
Note: For M30/M30T models, the drone firmware version after V06.01.10.02 is no longer maintained and upgrades the accurateShoot. orientedShoot is recommended.
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:gimbalPitchRotateAngle | Pitch rotation angle | float | ° | [-120, 45] | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:gimbalYawRotateAngle | yaw rotation angle | float | ° | [-180, 180] | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:focusX | Horizontal coordinate of the target region center | int | px | (0, 960) Note: The upper left corner of the picture is the coordinate origin. Horizontal direction is the x-axis. Vertical direction is the y-axis. | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:focusY | Vertical coordinate of the target region center | int | px | (0, 720) Note: The upper left corner of the picture is the coordinate origin. Horizontal direction is the x-axis. Vertical direction is the y-axis. | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:focusRegionWidth | Focusing region width ratio | int | px | (0, 960) | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:focusRegionHeight | Focusing region height ratio | int | px | (0, 720) | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:focalLength | Focal length | float | mm | > 0 | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:aircraftHeading | Yaw angle of drone target (relative to the true north) | float | ° | [-180, 180] Note: Drone will rotate to this target yaw angle. 0° is true north. 90° is true east. -90° is true west. -180°/180° is true south. | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:accurateFrameValid | Whether select the target of AI Spot-Check | bool | - | 1: Selected 0: Not selected Note: This value sets to 1. Then the drone will automatically find the target and capture photos. This value sets to 0. Then the drone will repeat action according to the drone attitude and payload attitude. It will not automatically find the target. | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:payloadPositionIndex | Payload mounting location | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:payloadLensIndex | Image capturing storage type | - | enum-string | zoom: Store the image shot by the zoom camera wide: Store the image shot by the wide camera ir: Store the image shot by the infrared camera *Note: Storing the image from more than one camera needs to use the format like “ <wpml:payloadLensIndex>wide,ir</wpml:payloadLensIndex> ”. It means storing images of wide and infrared cameras. | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:useGlobalPayloadLensIndex | Whether use the global storage type | bool | - | 0: Not used 1: Used | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:targetAngle | Angle of target box | float | ° | [0, 360] Note: The rotation angle. (Based on the y-axis and rotate clockwise.) | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:imageWidth | Width of picture | int | px | 960 | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:imageHeight | Height of picture | int | px | 720 | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:AFPos | AF motor location | int | - | - | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:gimbalPort | Gimbal port number | int | - | Capturing camera installation position Note: This value of M30/M30T models are 0. | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:accurateCameraType | Camera type | int | - | 52 (Model: M30 dual light camera), 53 (Model: M30T tripple light camera), 42 (Model: H20), 43 (Model: H20T), 82 (Model: H30), 83 (Model: H30T) | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:accurateFilePath | File path of picture | string | - | - | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:accurateFileMD5 | File MD5 of picture | string | - | - | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:accurateFileSize | File size of picture | int | Byte | Real image file size | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:accurateFileSuffix | File suffix of picture | string | - | File suffix is added when the generated media files are named. | Yes | M300 RTK, M350 RTK, M30/M30T |
wpml:accurateCameraApertue | Aperture size | int | - | Note: This value is the real aperture x 100 | Yes | M30/M30T |
wpml:accurateCameraLuminance | Environment luminance | int | - | - | Yes | M30/M30T |
wpml:accurateCameraShutterTime | Shutter time | float | second | - | Yes | M30/M30T |
wpml:accurateCameraISO | ISO | int | - | - | Yes | M30/M30T |
orientedShoot
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:gimbalPitchRotateAngle | Pitch rotation angle | float | ° | M30/M30T: [-120, 45] M3E/M3T: [-90, 35] M3D/M3TD, M4E/M4T: [-90, 30] | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:gimbalYawRotateAngle | yaw rotation angle | float | ° | [-180, 180] *Note: For M3E/M3T and M3D/M3TD, M4E/M4T, wpml:gimbalYawRotateAngle should align with wpml:aircraftHeading | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:focusX | Horizontal coordinate of the target region center | int | px | (0, 960) *Note: The upper left corner of the image is the coordinate origin. The horizontal direction is the x-axis. The vertical direction is the y-axis. | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:focusY | Vertical coordinate of the target region center | int | px | (0, 720) Note: The upper left corner of the image is the coordinate origin. The horizontal direction is the x-axis. The vertical direction is the y-axis. | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:focusRegionWidth | Width of the target width | int | px | (0, 960) | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:focusRegionHeight | Height of the target region | int | px | (0, 720) | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:focalLength | Zoom focal length | float | mm | > 0 | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:aircraftHeading | Yaw angle of drone target (relative to the true north) | float | ° | [-180, 180] Note: Drone will rotate to this target yaw angle. 0° is true north. 90° is true east. -90° is true west. -180°/180° is true south. Note: For M3E/M3T and M3D/M3TD, M4E/M4T, wpml:gimbalYawRotateAngle should align with wpml:aircraftHeading | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:accurateFrameValid | Whether select the target of AI Spot-Check | bool | - | 1: Selected 0: Not selected *Note: This value sets to 1. Then the drone will automatically find the target and capture photos. This value sets to 0. Then the drone will repeat action according to the drone attitude and payload attitude. It will not automatically find the target. | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:payloadPositionIndex | The position where the payload is mounted | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:payloadLensIndex | Image capturing storage type | - | enum-string | zoom: Store the image shot by the zoom camera wide: Store the image shot by the wide camera ir: Store the image shot by the infrared camera *Note: Storing the image from more than one camera needs to use the format like “ <wpml:payloadLensIndex>wide,ir</wpml:payloadLensIndex> ”. It means storing images of wide and infrared cameras. | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:useGlobalPayloadLensIndex | Whether use the global storage type | bool | - | 0: not ues 1: use | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:targetAngle | Angle of target box | float | ° | [0, 360] Note: The rotation angle. (Based on the y-axis and rotate clockwise.) | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:actionUUID | Action UUID | - | - | Note: This value will be written to the image file during the capturing to associate the action and image file. | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:imageWidth | Image width | int | px | 960 | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:imageHeight | Image height | int | px | 720 | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:AFPos | AF motor location | int | - | - | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:gimbalPort | Gimbal port number | int | - | Capturing camera installation position Note: This value of M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T models are 0. | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:orientedCameraType | Camera type | int | - | 52 (Model: M30 dual light camera), 53 (Model: M30T tripple light camera) | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:orientedFilePath | Image file path | string | - | - | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:orientedFileMD5 | Image file MD5 | string | - | - | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:orientedFileSize | Image file size | int | Byte | Real image file size | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:orientedFileSuffix | Image file suffix | string | - | File suffix is added when the generated media files are named. | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:orientedCameraApertue | Aperture size | int | - | Note: This value is the real aperture x 100 | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:orientedCameraLuminance | Environment luminance | int | - | - | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:orientedCameraShutterTime | Shutter time | float | second | - | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:orientedCameraISO | ISO | int | - | - | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
wpml:orientedPhotoMode | Capturing mode | enum-string | - | normalPhoto: normal capturing lowLightSmartShooting: Smart Low-Light | Yes | M30/M30T, M3E/M3T, M3D/M3TD, M4E/M4T |
panoShot
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | Payload mounting location | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M30/M30T |
wpml:payloadLensIndex | Storage type of photo | List of photo format | enum-string (list) | zoom: Storing the photo taken with zoom lens wide: Storing the photo taken with wide lens ir: Storing the photo taken with infrared lens narrow_band: Storing the photo taken with narrow-band lens visable: Visible Photos * Note: Storing photos taken by multi-lens, the format is like," <wpml:payloadLensIndex>wide,ir,narrow_band</wpml:payloadLensIndex> ". It means wide lens, infrared lens, and wide-band lens are used.* | Yes | M30/M30T |
wpml:useGlobalPayloadLensIndex | Whether use the global storage type | bool | - | 0: not ues 1: use | Yes | M30/M30T, M3E/M3T |
wpml:panoShotSubMode | Panorama photo mode | string | - | panoShot_360: Panorama mode | Yes | M30/M30T, M3D/M3TD, M4E/M4T |
recordPointCloud
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | Payload mounting location | int | - | For the payload position index enumeration value, please refer to the gimbalindex field in type-subtype-gimbalindex in Enumeration Values of Camera in the Product Support page. | Yes | M300 RTK, M350 RTK |
wpml:recordPointCloudOperate | Point Cloud Operation | string | - | startRecord: Start the point cloud recording. pauseRecord: Pause the point cloud recording. resumeRecord: Continue the point cloud recording. stopRecord: Stop the point cloud recording. | Yes | M300 RTK, M350 RTK |
megaphone
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | Payload mounting location | int | - | 0 : Mount position of 1. The M300 RTK and M350 RTK models correspond to the front left of the drone. Other models correspond to the main gimbal. 1 : Mount position of 2. The M300 RTK and M350 RTK models correspond to the front right of the drone.2 : Mount position of 3. The M300 RTK and M350 RTK models correspond to the top of the drone. | Yes | M4D/M4TD |
wpml:actionUUID | Action UUID | string | - | - | Yes | M4D/M4TD |
wpml:megaphoneOperateType | Megaphone Operation Switch | int | - | 0: Start speaking 1: Stop speaking | Yes | M4D/M4TD |
wpml:megaphoneOperateVolume | Megaphone Operation Volume | int | - | Volume level, range: 0-100 | Yes | M4D/M4TD |
wpml:megaphoneOperateLoop | 是Single Track Loop Playback | bool | - | 0: Off 1: On | Yes | M4D/M4TD |
wpml:megaphoneOperateFilePath | Path of the Megaphone Audio File in KMZ | string | - | Path of the audio file in KMZ, e.g., /wpmz/res/audio/71b4cf0504a7b899.opus | Yes | M4D/M4TD |
wpml:megaphoneFileName | Name of the Megaphone Audio File | string | - | Name of the audio file in KMZ, e.g., 71b4cf0504a7b899.opus | Yes | M4D/M4TD |
wpml:megaphoneFileOriginalName | Display Name of the Megaphone Audio File During Playback | string | - | Name returned by the megaphone during playback, e.g., Megaphone Audio.mp3 | Yes | M4D/M4TD |
wpml:megaphoneFileMd5 | MD5 Value of the Megaphone Audio File | string | - | MD5 value of the megaphone audio file | Yes | M4D/M4TD |
wpml:megaphoneFileBitrate | Compression Bitrate of the Megaphone Audio File | int | - | 1: Bitrate 8000 2: Bitrate 16000 3: Bitrate 24000 4: Bitrate 32000 5: Bitrate 48000 6: Bitrate 64000 Note: Currently only supports 4, bitrate 32000 | Yes | M4D/M4TD |
searchlight
Element | Name | Type | unit | Value | Is it required (default) | Product Support |
---|---|---|---|---|---|---|
wpml:payloadPositionIndex | Payload mounting location | int | - | 0 : Mount position of 1. The M300 RTK and M350 RTK models correspond to the front left of the drone. Other models correspond to the main gimbal. 1 : Mount position of 2. The M300 RTK and M350 RTK models correspond to the front right of the drone.2 : Mount position of 3. The M300 RTK and M350 RTK models correspond to the top of the drone. | Yes | M4D/M4TD |
wpml:actionUUID | Action UUID | string | - | - | No | M4D/M4TD |
wpml:searchlightOperateType | Searchlight Operation Type | int | - | 0: Illumination 1: Flash 2: Turn off | Yes | M4D/M4TD |
wpml:searchlightBrightness | Brightness | int | - | Brightness level, range 0-100 | Yes | M4D/M4TD |