一、 PhoneGap Geolocation 对象介绍
1、使应用程序可以访问地理位置信息。geolocation 对象提供了对设备 GPS 传感器的访问。Geolocation 提供设备的位置信息，例如经度和纬度。
2、位置信息的常见来源包括全球定位系统（GPS），以及通过诸如 IP 地址、RFID、WiFi 和蓝牙的 MAC 地址、和 GSM/CDMA 手机 ID 的网络信号所做的推断。
3、不能保证该 API 返 回的是设备的真实位置信息。这个 API 是基于 W3C Geo location API Specification 实现的。
4、有些设备已经提供 了对该规范的实现，对于这些设备采用内置实现而非使用 PhoneGap 的实现。
5、对于没有地理位置支持的设 备，PhoneGap 提供了统一的支持。
6、方法
geolocation.getCurrentPosition
geolocation.watchPosition
geolocation.clearWatch
7、参数
geolocationSuccess
geolocationError
geolocationOptions
二、 geolocation.getCurrentPosition
1、返回设备的当前位置，一个位置对象。
navigator.geolocation.getCurrentPosition(geolocationSuccess, [geolocationError], [geolocationOptions]);
2、参数
geolocationSuccess：通过当前位置的回调。
geolocationError：（可选）如果发生错误，执行的回调。
geolocationOptions：（可选）获取地理位置的选项，例如获取频率。它一般作为一个 JSON 对象，目前可设 置的属性如下
geolocationOptions{ enableHighAccuracy：提供一个表明应用程序希望获得最佳可能结果的提示。
timeout：允许的以毫秒为单位的最大时间间隔，该时间间隔是从 geolocation.getCurrentPosition 或 geolocation.watchPosition 的调用到相应的
geolocationSuccess 回调函数被调用，单位是毫秒。
maximumAge：保留上次缓存的最长时间，单位是毫秒。可以理解为获取地理位置信息的频率
3、注意： 除非 enableHighAccuracy 选项被设定为 true，否则 Android 2.X 模拟器不会返回一个地理位置结果 例如：
{ maximumAge: 3000, timeout: 5000, enableHighAccuracy: true }; }
三、 包含当前地理位置坐标信息的Position对象描述
1、Position 包含由 geolocation API 创建的 Position 坐标信息。
coords：一系列地理坐标。（Coordinates 类型）
timestamp：以毫秒为单位的 coords 的创建时间戳。
2、PositionError 当发生错误时，一个 PositionError 对象会传递给 geolocationError 回调函数。
code：一个在下面常量列表中定义的错误代码。
message：说明错误细节的错误信息。
PositionError.PERMISSION_DENIED：权限被拒绝
PositionError.POSITION_UNAVAILABLE：位置不可用
PositionError.TIMEOUT：超时
3、 Coordinates 一系列用来描述位置的地理坐标信息的属性。
latitude：以十进制表示的纬度。
longitude：以十进制表示的经度。
altitude：位置相对于椭圆球面的高度，单位为米。 海拔高度
accuracy：以米为单位的纬度和经度坐标的精度水平。
altitudeAccuracy：以米为单位的高度坐标的精度水平。（Android 设备上不支持该属性，返回值总是 nul）
heading：运动的方向，通过相对正北做顺时针旋转的角度指定。
speed：以米/秒为单位的设备当前地面速 度。
四、获取地理位置信息
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>phonegap_device_network_notification01</title>
<link href="../jquery.mobile-1.3.2.css" rel="stylesheet" type="text/css"/>
<script src="../jquery.js" type="text/javascript"></script>
<script src="../jquery.mobile-1.3.2.js" type="text/javascript"></script>
<script src="../cordova.js" type="text/javascript"></script>
<script type="text/javascript" charset="utf-8"> // 等待PhoneGap加载
document.addEventListener("deviceready", onDeviceReady, false); // 加载完成
function onDeviceReady() {
navigator.geolocation.getCurrentPosition(onSuccess, onError,{ maximumAge: 3000, timeout: 100000, enableHighAccuracy: true });
} // onSuccess 回调函数
// 接收包含当前地理位置坐标信息的Position对象
function onSuccess(position) {
alert(position.coords.latitude);
var element = document.getElementById('geolocation');
element.innerHTML = '纬度: ' + position.coords.latitude + '<br />' +
'经度: ' + position.coords.longitude + '<br />' +
'海拔高度: ' + position.coords.altitude + '<br />' +
'精确度: ' + position.coords.accuracy + '<br />' +
'海拔高度精确度: ' + position.coords.altitudeAccuracy + '<br />' +
'运动方向: ' + position.coords.heading + '<br />' +
'速度: ' + position.coords.speed + '<br />' +
'时间戳: ' + new Date(position.timestamp) + '<br />';
} // onError 回调函数， 接收包含具体错误信息的PositionError 对象
function onError(error) {
alert('错误代码: ' + error.code + '\n' + '详细信息: ' + error.message + '\n');
} </script> </head>
<body>
<div data-role="page">
<div data-role="header">
<h1>PhoneGap100实战</h1>
</div>
<div data-role="content">
<p id="geolocation">定位中。。。</p>
</div>
<div data-role="footer">
<h4> </h4>
</div>
</div> </body>
</html>
五、 动态获取地理位置信息
1. geolocation.watchPosition 定期获取设备的地理位置信息
navigator.geolocation.watchPosition(onSuccess, onError, options);
2. navigator.geolocation.clearWatch 停止定期获取设备的地理位置信息
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>phonegap_device_network_notification01</title>
<link href="../jquery.mobile-1.3.2.css" rel="stylesheet" type="text/css"/>
<script src="../jquery.js" type="text/javascript"></script>
<script src="../jquery.mobile-1.3.2.js" type="text/javascript"></script>
<script src="../cordova.js" type="text/javascript"></script>
<script type="text/javascript" charset="utf-8"> //等待PhoneGap加载
document.addEventListener("deviceready", onDeviceReady, false); var watchID = null; //加载完成
function onDeviceReady() {
// Update every 3 seconds
var options = { frequency: 3000 };
watchID = navigator.geolocation.watchPosition(onSuccess, onError, options);
} // onSuccess 回调函数
// 接收包含当前地理位置坐标信息的Position对象
function onSuccess(position) {
var element = document.getElementById('geolocation');
element.innerHTML = '纬度: ' + position.coords.latitude + '<br />' +
'经度: ' + position.coords.longitude + '<br />' +
'<hr />' + element.innerHTML;
} //取消获取地理位置信息
function clearWatch() {
if (watchID != null) {
navigator.geolocation.clearWatch(watchID);
watchID = null;
}
} // onError 回调函数， 接收包含具体错误信息的PositionError 对象
function onError(error) {
alert('code: ' + error.code + '\n' +
'message: ' + error.message + '\n');
} </script> </head>
<body>
<div data-role="page">
<div data-role="header">
<h1>PhoneGap100实战</h1>
</div>
<div data-role="content">
<p id="geolocation">监测地理位置信息中。。。</p>
<button onclick="clearWatch();">取消监测地理位置信息</button>
</div>
<div data-role="footer">
<h4> </h4>
</div>
</div> </body>
</html>