PhoneGap API中文帮助文档——Geolocation（地理位置）

geolocation对象提供了对设备GPS传感器的访问。
Geolocation提供设备的位置信息，例如经度和纬度。位置信息的常见来源包括全球定位系统（GPS），以及通过诸如IP地址、RFID、WiFi和蓝牙的MAC地址、和GSM/CDMA手机ID的网络信号所做的推断。不能保证该API返回的是设备的真实位置信息。
这个API是基于W3C Geo location API Specification实现的。有些设备已经提供了对该规范的实现，对于这些设备采用内置实现而非使用PhoneGap的实现。对于没有地理位置支持的设备，PhoneGap的实现应该是完全兼容W3C规范。

方法：
geolocation.getCurrentPosition
geolocation.watchPosition
geolocation.clearWatch

参数：
geolocationSuccess
geolocationError
geolocationOptions

对象(只读)：
Position
PositionError
Coordinates

geolocation.getCurrentPosition

返回一个Position对象表示设备的当前位置。
navigator.geolocation.getCurrentPosition(geolocationSuccess,  

                                [geolocationError],  

                                [geolocationOptions]);
复制代码
参数：
geolocationSuccess：获取位置信息成功时调用的回调函数，参数为当前的位置信息。
geolocationError：（可选项）获取位置信息出错时调用的回调函数。
geolocationOptions：（可选项）地理位置选项。

说明：
geolocation.getCurrentPositon是一个异步函数。它回传一个包含设备当前位置信息的Position对象给geolocationSuccess回调函数。如果发生错误，触发geolocationError回调函数并传递一个PositionError对象。

支持的平台：
Android
BlackBerry (OS 4.6)
BlackBerry WebWorks (OS 5.0或更高版本)
iPhone

简单的范例：
    //  获取位置信息成功时调用的回调函数 

    //  该方法接受一个“Position”对象，包含当前GPS坐标信息 

    var onSuccess = function(position) { 

        alert('Latitude: '          + position.coords.latitude          + '\n' + 

            'Longitude: '         + position.coords.longitude         + '\n' + 

            'Altitude: '          + position.coords.altitude          + '\n' + 

            'Accuracy: '          + position.coords.accuracy          + '\n' + 

            'Altitude Accuracy: ' + position.coords.altitudeAccuracy  + '\n' + 

            'Heading: '           + position.coords.heading           + '\n' + 

            'Speed: '             + position.coords.speed             + '\n' + 

            'Timestamp: '         + new Date(position.timestamp)&nbs