14、PhoneGap的指南针与网络连接API使用指南

PhoneGap的指南针与网络连接API使用指南

1. 指南针API简介

指南针API允许PhoneGap程序在大致对应地球表面的二维平面上确定设备的朝向。许多现代智能手机都有物理指南针（集成在芯片上），该API只需查询芯片，就能返回一个0到360之间的角度，指示设备所指的方向。其中，0表示指向北方，90表示指向东方，180表示指向南方，270表示指向西方。不过，并非所有智能手机都配备指南针，例如iPhone系列设备一直都有指南针，但RIM直到黑莓7操作系统设备才添加了这一功能。

1.1 获取设备朝向

要查询设备的朝向，可调用以下方法：

navigator.compass.getCurrentHeading(successFunction, errorFunction);

该API会根据操作结果调用两个函数。当成功读取数据时，会调用 successFunction ；当读取指南针数据出错时，则调用 errorFunction 。

successFunction 会传入 compassHeading 对象，该对象包含以下组件：
- magneticHeading ：设备当前的朝向，以度为单位，范围从0到359.99。
- trueHeading ：设备相对于地理北极的当前朝向，以度为单位，范围从0到359.99。负值表示无法确定该值。