Class

CLHeading

The azimuth (orientation) of the user's device, relative to true or magnetic north.

Declaration

@interface CLHeading : NSObject

Overview

A CLHeading object contains computed values for the device's azimuth (orientation) relative to true or magnetic north. It also includes the raw data for the three-dimensional vector used to compute those values. A navigation app might use the information to rotate a map so that it reflects the direction that the user is facing.

Typically, you do not create instances of this class yourself, nor do you subclass it. Instead, you receive instances of this class through the delegate assigned to the CLLocationManager object whose startUpdatingHeading method you called.

Topics

Accessing the Heading Attributes

magneticHeading

The heading (measured in degrees) relative to magnetic north.

trueHeading

The heading (measured in degrees) relative to true north.

headingAccuracy

The maximum deviation (measured in degrees) between the reported heading and the true geomagnetic heading.

timestamp

The time at which this heading was determined.

Accessing the Raw Heading Data

x

The geomagnetic data (measured in microteslas) for the x-axis.

y

The geomagnetic data (measured in microteslas) for the y-axis.

z

The geomagnetic data (measured in microteslas) for the z-axis.

Constants

CLHeadingComponentValue

A type used to report magnetic differences reported by the onboard hardware.

Relationships

Inherits From

See Also

Compass Headings

Getting Heading and Course Information

Use a device's orientation and course information for navigation.