DJI Mobile SDK Documentation

      class DJIHotpointMission

      @interface DJIHotpointMission : DJIMission
      Header:DJIHotpointMission.h
      Inherits From:DJIMission
      Description:

      This class represents a Hotpoint mission. In a Hotpoint mission, the aircraft will repeatedly fly circles of a constant radius around a specified point called a Hot Point. The user can control the aircraft to fly around the Hotpoint with a specific radius and altitude. During execution, the user can also use the physical remote controller to modify its radius and speed. It is not supported by Mavic Pro when using WiFi connection. It is not supported by Spark, Mavic Mini, Mavic Air 2, DJI Air 2S and Matrice 300 RTK.

      Class Members:
      Check Parameters
      method
      method checkParameters
      - (nullable NSError *)checkParameters
      Header:DJIHotpointMission.h
      Description:

      Checks if the configuration for mission is valid before calling startMission:withCompletion of DJIHotpointMissionOperator.

      Return:
      nullable NSError *Error found when checking parameters of the hotpoint. nil if all the parameters are valid.
      Coordinate
      property
      property hotpoint
      @property(nonatomic, assign) CLLocationCoordinate2D hotpoint
      Header:DJIHotpointMission.h
      Description:

      Sets the coordinate of the hotpoint.

      Start Point
      property
      property startPoint
      @property(nonatomic, assign) DJIHotpointStartPoint startPoint
      Header:DJIHotpointMission.h
      Description:

      Set aircraft's initial point on the circular flight path when starting the hotpoint mission.

      See Also:

      DJIHotpointStartPoint

      Heading
      property
      property heading
      @property(nonatomic, assign) DJIHotpointHeading heading
      Header:DJIHotpointMission.h
      Description:

      Aircraft's heading while flying around the hotpoint. It can be pointed toward or away from the hotpoint, forward or backward along its flight route, or can be manually controlled by the remote controller.

      See Also:

      DJIHotpointHeading

      Altitude
      property
      property altitude
      @property(nonatomic, assign) float altitude
      Header:DJIHotpointMission.h
      Description:

      Sets the altitude of the hotpoint orbit with a range [5,500] meters. The altitude is relative to the ground altitude from which the aircraft took off.

      Radius
      property
      property radius
      @property(nonatomic, assign) float radius
      Header:DJIHotpointMission.h
      Description:

      Sets the circular flight path radius with which the aircraft will fly around the hotpoint. The value of this property should be in the range of [DJIHotpointMinRadius, DJIHotpointMaxRadius] meters.

      Angular Velocity
      property
      property angularVelocity
      @property(nonatomic, assign) float angularVelocity
      Header:DJIHotpointMission.h
      Description:

      Sets the angular velocity in degrees/s of the aircraft as it orbits the hot point. The default value is 20 degrees/s. The maximum angular velocity allowed is relative to the orbit radius.

      const DJIHotpointMaxRadius
      DJI_API_EXTERN const float DJIHotpointMaxRadius
      Header:DJIHotpointMissionTypes.h
      Description:

      Maximum radius, in meters, of the circular path the aircraft will fly around the point of interest. Currently 500m.

      const DJIHotpointMinRadius
      DJI_API_EXTERN const float DJIHotpointMinRadius
      Header:DJIHotpointMissionTypes.h
      Description:

      Minimum radius, in meters, of the circular path the aircraft will fly around the point of interest.

      const DJIHotpointMaxAltitude
      DJI_API_EXTERN const float DJIHotpointMaxAltitude
      Header:DJIHotpointMissionTypes.h
      Description:

      Maximum altitude in meters for a Hotpoint mission.

      const DJIHotpointMinAltitude
      DJI_API_EXTERN const float DJIHotpointMinAltitude
      Header:DJIHotpointMissionTypes.h
      Description:

      Minimum altitude in meters for a Hotpoint mission.

      enum DJIHotpointStartPoint
      typedef NS_ENUM (NSUInteger, DJIHotpointStartPoint)
      Header:DJIHotpointMissionTypes.h
      Description:

      Aircraft starting point relative to the hotpoint.

      Enum Members:
      DJIHotpointStartPointNorthStart from the North.
      DJIHotpointStartPointSouthStart from the South.
      DJIHotpointStartPointWestStart from the West.
      DJIHotpointStartPointEastStart from the East.
      DJIHotpointStartPointNearestStart the circle surrounding the hotpoint at the nearest point on the circle to the aircraft's current location.
      enum DJIHotpointHeading
      typedef NS_ENUM (NSUInteger, DJIHotpointHeading)
      Header:DJIHotpointMissionTypes.h
      Description:

      Heading of the aircraft while orbiting the hotpoint.

      Enum Members:
      DJIHotpointHeadingAlongCircleLookingForwardHeading is in the forward direction of travel along the circular path.
      DJIHotpointHeadingAlongCircleLookingBackwardHeading is in the backward direction of travel along the circular path.
      DJIHotpointHeadingTowardHotpointHeading is toward the hotpoint.
      DJIHotpointHeadingAwayFromHotpointHeading of the aircraft is looking away from the hotpoint. It is in the direction of the vector defined from the hotpoint to the aircraft.
      DJIHotpointHeadingControlledByRemoteControllerHeading is controlled by the remote controller.
      DJIHotpointHeadingUsingInitialHeadingThe heading remains the same as the heading of the aircraft when the mission started.