Instance Property


The device orientation to use when computing heading values.


@property(assign, nonatomic) CLDeviceOrientation headingOrientation;


When computing heading values, the location manager assumes that the top of the device in portrait mode represents due north (0 degrees) by default. For apps that run in other orientations, this may not always be the most convenient orientation. This property allows you to specify which device orientation you want the location manager to use as the reference point for due north.

Although you can set the value of this property to CLDeviceOrientationUnknown, CLDeviceOrientationFaceUp, or CLDeviceOrientationFaceDown, doing so has no effect on the orientation reference point. The original reference point is retained instead.

Changing the value in this property affects only those heading values reported after the change is made.

See Also

Initiating Heading Updates

- startUpdatingHeading

Starts the generation of updates that report the user’s current heading.

- stopUpdatingHeading

Stops the generation of heading updates.

- dismissHeadingCalibrationDisplay

Dismisses the heading calibration view from the screen immediately.


The minimum angular change (measured in degrees) required to generate new heading events.


A constant indicating that all header values should be reported.


Constants indicating the physical orientation of the device.