html5 geolocation API

清单 1. 检查浏览器支持性
if (navigator.geolocation)

清单 2. 单次定位请求 API
void getCurrentPosition(updateLocation, optional handleLocationError, optional options);

清单 3. updateLocation() 函数使用示例
updateLocation() 函数是getCurrentPosition的必选参数，也是浏览器指明位置数据可用时应调用的函数。获取位置操作可能需要较长时间才能完成，用户不希望在检索位置时浏览器被锁定，这个参数就是异步收到实际位置信息后，进行数据处理的地方。它同时作为一个函数，只接受一个参数：位置对象 position。
function updateLocation(position) {
　　var latitude = position.coords.latitude;
　　var longitude = position.coords.longitude;
　　var accuracy = position.coords.accuracy;

　　document.getElementById(“纬度”).innerHTML = latitude;
　　document.getElementById(“经度”).innerHTML = longitude;
　　document.getElementById(“准确度”).innerHTML = accuracy + “米”;
}

清单 4. 使用错误处理函数
该 API 已经定义了所有需要处理的错误情况的错误编号。错误编号 code 设置在错误对象中，错误对象作为 error 参数传递给错误处理程序。这些错误编号有：
　　UNKNOWN_ERROR (0)：不包括在其它错误编号中的错误，需要通过 message 参数查找错误的详细信息。
　　PERMISSION_DENIED (1)：用户拒绝浏览器获得其位置信息。
　　POSITION_UNVAILABLE (2)：尝试获取用户信息失败。
　　TIMEOUT (3)：在 options 对象中设置了 timeout 值，尝试获取用户位置超时。

　　function handleLocationError(error) {
　　　　switch (error.code) {
　　　　　　case 0:
　　　　　　　　updateStatus(“尝试获取您的位置信息时发生错误：” + error.message);
　　　　　　　　break;
　　　　　　case 1:
　　　　　　　　updateStatus(“用户拒绝了获取位置信息请求。”);
　　　　　　　　break;
　　　　　　case 2:
　　　　　　　　updateStatus(“浏览器无法获取您的位置信息。”);
　　　　　　　　break;
　　　　　　case 3:
　　　　　　　　updateStatus(“获取您位置信息超时。”);
　　　　　　　　break;
　　　　}
　　}

清单 5. 包含 options 的更新位置请求
　　navigator.geolocation.getCurrentPosition(updateLocation, handleLocationError,{timeout: 10000});

可选参数 options 对象可以调整 HTML5 Geolocation 服务的数据收集方式。该对象有三个可选参数：
enableHighAccuracy：如果启动该参数，浏览器会启动 HTML5 Geolocation 服务的高精确度模式，这将导致机器花费更多的时间和资源来确定位置，应谨慎使用。默认值为 false；
timeout：单位为 ms，告诉浏览器获取当前位置信息所允许的最长时间。如果在这个时间段内未完成，就会调用错误处理程序。默认值为 Infinity，即无穷大（无限制）；
maximumAge：以 ms 为单位，表示浏览器重新获取位置信息的时间间隔。默认值为 0，这意味着浏览器每次请求时必须立即重新计算位置。
使用可选参数 options 更新我们的位置请求，让其包含一个使用 JSON 对象表示的可选参数

清单 6. 重复性位置更新请求 API
void watchPosition(updateLocation, optional handleLocationError, optional options);

清单 7. watchPosition 和 clearWatch 的使用
关闭更新也很简单，如果应用程序不需要再接收用户的位置更新消息，只需要使用 clearWatch() 函数。参照清单 7 给的例子。
var watchId = navigator.geolocation.watchPosition(updateLocation, handleLocationError);
// 基于持续更新的位置信息实现一些功能…
// 停止接收位置更新消息
navigator.geolocation.clearWatch(watchId);

参考：使用 HTML5 Geolocation 构建基于地理位置的 Web 应用

　　　浏览器地理位置(Geolocation)API 简介