背景

很多地图 App 都会有一个当前定位的标记，该标记可以根据用户手持手机的朝向不同而改变方向。如图：
CoreLocation 中的 Course 和 Heading 简析 - 图1

如果要实现这个带方向定位的标记点，需要什么数据呢？

  • 定位数据
  • 手机朝向数据

定位数据获取很简单，调用 CLLocationManager 的 startUpdatingLocation() 方法，然后在 didUpdateLocations 的回调方法中可以得到的 CLLocation 属性值。

CLLocation 对象中，除了有我们需要的 coordinate 位置数据外，还有一个 course 属性。

这个 course 属性是不是我们需要的手机朝向数据呢？

course: The direction in which the device is traveling, measured in degrees and relative to due north.

Course values are measured in degrees starting at due north and continue clockwise around the compass. Thus, north is 0 degrees, east is 90 degrees, south is 180 degrees, and so on. Course values may not be available on all devices. A negative value indicates that the course information is invalid.

从文档的解释来看，它是一个相对于地理北极以顺时针方向的角度数据，手机朝着正北方是 0 度，朝着东边是 90度，依次类推。

看起来是我们想要的值。但是从实际测试(真机室内测试)结果看，这个值一直是返回 -1 。（负数代表此值当前不可用）

排除使用方式的不对，我们从文档 Getting Heading and Course Information 发现，我们要获取的其实是 heading 的数据。

通过调用 CLLocationManager 中的

  1. startUpdatingHeading()

然后在 locationManager(_:didUpdateHeading:) 的回调方法中就可以获取到 heading 的数据了。

Course 和 Heading

从字面意思上我们可以将它们区分为 航向 和 朝向

Course(航向)信息 反映的是设备移动的速度和方向，并且仅在具有GPS硬件条件的设备上可用。

注意不要将 Course(航向) 与 Heading(朝向) 混淆。Course(航向) 反映的是设备移动时的方向，是从GPS信息中获取到，它与设备的物理方向无关。

而 Heading(朝向)信息 则是通过计算手机上传感器的值而获取到的相对于地理北极的角度信息。

Course

Course 常常是用在进行导航的情况下。比如平时我们开车进行导航的时候，有时候车子转弯过快，会发现导航上的朝向并没有及时更新到正确的方向，要过一会才会更新，这就是因为 GPS 信息没有及时更新过来，故 Course 信息也就无法有足够的数据支持它更新。

Heading

Heading 是与物理设备有关的值，所以我们在获取 Heading 信息的时候，注意要配置 CLLocationManager 的 headingOrientation 属性。

headingOrientation 默认值是 portrait ，即我们平时正面拿着手机。而当我们正面横着拿手机的时候，需要将 headingOrientation 属性根据实际情况改成 landscapeLeft 或者 landscapeRight，这样系统才能通过手机的持有方位计算正确的 Heading 值，不然 Heading 就一直是默认以 portrait 的形式计算得到。