HTML5 Geolocation API 封装在 navigator.geolocation 属性里,各种接口即是 navigator.geolocation 对象的方法。
下面是关于getCurrentPosition()函数的详细介绍
getCurrentPosition(successCallback,errorCallback,positionOptions)
successCallback:
表示调用getCurrentPosition函数成功以后的回调函数,该函数带有一个参数,对象字面量格式,表示获取到的用户位置数据。该对象包含两个属性 coords 和 timestamp。其中 coords 属性包含以下7个值: accuracy:精确度
latitude:纬度
longitude:经度
altitude:海拔
altitudeAcuracy:海拔高度的精确度
heading:朝向
speed:速度
errorCallback:
和 successCallback 函数一样带有一个参数,对象字面量格式,表示返回的错误代码。它包含以下两个属性: message:错误信息
code:错误代码。
其中错误代码包括以下四个值: UNKNOW_ERROR:表示不包括在其它错误代码中的错误,这里可以在 message 中查找错误信息
PERMISSION_DENIED:表示用户拒绝浏览器获取位置信息的请求
POSITION_UNAVALIABLE:表示网络不可用或者连接不到卫星
TIMEOUT:表示获取超时。必须在options中指定了timeout值时才有可能发生这种错误
positionOptions:
positionOptions 的数据格式为JSON,有三个可选的属性: enableHighAcuracy — 布尔值: 表示是否启用高精确度模式,如果启用这种模式,浏览器在获取位置信息时可能需要耗费更多的时间。
timeout — 整数: 表示浏览需要在指定的时间内获取位置信息,否则触发errorCallback。
maximumAge — 整数/常量: 表示浏览器重新获取位置信息的时间间隔。