`Core Location
`
`On This Page
`Overview
`See Also
`
`
`
`Documentation
`
`Article
`Getting Heading and Course Information
`
`Use a deviceʼs orientation and course information for navigation.
`
`Overview
`Heading and course information are commonly used by navigation apps to help guide the user
`to a destination. The heading of a userʼs device is its current orientation relative to magnetic or
`true north. Devices with GPS can report course information, which represents the direction in
`which the device is moving. The Compass app in iOS uses heading information to implement a
`magnetic compass interface, as shown in Figure 1. Augmented reality apps might use this
`information to determine which direction the user is facing.
`
`Figure 1 Heading information in the Compass app
`
`Get the Current Heading
`You use heading information to determine the current orientation of the userʼs device. For
`example, an augmented reality app might use the current heading to help determine what
`information to show on the userʼs screen. Headings are usually reported relative to the top of
`
`Getting Heading and Course Information
`
`Core Location
`
`Language: Swift
`
`API Changes:
`
`None
`
`Discover
`
`Design
`
`Develop
`
`Distribute
`
`Support
`
`Account
`
`Apple v. Maxell
`IPR2020-00407
`Maxell Ex. 2024
`
`Page 1 of 2
`
`
`
`the device, but you can configure how values are reported using the headingOrientation
`property of your CLLocationManager object.
`After determining whether heading information is available, call the startUpdating
`Heading() method of your CLLocationManager object to begin the delivery of heading
`updates. The location manager delivers updates to the locationManager(_:didUpdate
`Heading:) method of its delegate whenever the heading information changes.
`
`Note
`
`Heading information is available only on devices with a built-in magnetometer; itʼs not
`available in iOS Simulator. The magnetometer determines a deviceʼs orientation relative to
`magnetic north. When location data is available, Core Location also reports the deviceʼs
`orientation relative to true north.
`
`Get Course Information
`Course information reflects the speed and direction in which a device is moving and is available
`only on devices with GPS hardware. Donʼt confuse course information with heading information.
`Course direction reflects the direction in which the device is moving and is independent of the
`deviceʼs physical orientation. The most common use of course information is in navigation apps.
`Course information is included automatically in CLLocation objects delivered to your app as
`part of its location updates. When enough location data has been gathered to compute a
`course, the location manager fills in the speed and course properties of the location object
`with the appropriate values.
`
`See Also
`
`Compass Headings
`
`class CLHeading
`The azimuth (orientation) of the userʼs device, relative to true or magnetic north.
`
`Apple v. Maxell
`IPR2020-00407
`Maxell Ex. 2024
`
`Page 2 of 2
`
`