HTML5 Gerlocation API概述

1.getCurrentPosition

    HTML5中的GPS定位功能主要用的是getCurrentPosition,该方法封装在navigator.geolocation属性里，是navigator.geolocation对象的方法。使用getCurrentPosition方法可以获取用户当 前的地理位置信息，该方法的定义如下：

    getCurrentPosition(successCallback,errorCallback.positionOptions);

    (1)successCallback

表示调用getCurrentPosition函数成功以后的回调函数，该函数带有一个参数，对象字面量格式，表示获取到的用户位置数据。该对象包含两个属性coords和timestamp,其中coords属性包含7个值：

    © accuracy：精确度。 

    © latitude：讳度。 

    © longitude：经度。

    © altitude：海拔。

    © altitudeAcuracy：海拔高度的精确度。 

    © heading：朝向。

    © speed：速度。

    (2)errorCallback

    和successCallback函数一样，有一个参数，对象字面量格式，表示返回的错误代码。它包含两个属性：

    © message：错误信息。

    © code：错误代码。

    其中错误代码包括以下四个值：

    © UNKNOW_ERROR：表示不包括在其他错误代码中的错误，这里可以在message中查找错误信息。

    © PERMISSION_DENIED：表示用户拒绝浏览器获取位置信息的请求。 

    © POSITION_UNAVALIABLE:表示网络不可用或者连接不到卫星。  

    © TIMEOUT：表示获取超时。必须在options中指定了timeou植时，才有可能发生这种错误。

    (3)positionOptions

    positionOptions的数据格式为JSON,有三个可选的属性：

    © enableHighAcuracy — 布尔值：表示是否启用高精确度模式，如果启用这种模式，浏览器在获取位置信息时，可能需要耗费更多的时间。

    © timeout — 整数：表示浏览需要在指定的时间内获取位置信息，否则触发errorCallback。

    © maximumAge — 整数/常量：表示浏览器重新获取位置信息的时间间隔。

2.watchCurrentPosition方法

    该方法用于定期自动地获取用户的当前位置信息，实例代码如下：

    watchCurrentPosition(successCallback,errorCallback,positionOptions);

    该方法返回一个数字，这个数字的使用方法与JavaScript中setlnterval方法的返回参数的使用方法类似。该方法也有三个参数，这三个参数的使用方法与getCurrentPosition方法中的参数说明与使用方法相同。

3.clearWatch方法

    该方法用于停止对当前用户地理位置信息的监视，它的定义如下：

    clearWatch(watchid);

    该方法的参数watchld是调用watchPosition方法监视地理位置信息时的返回参数