HTML5-Geolocation APIs的示例代码

1.navigator.geolocation
  html5中的地理位置相关的主要对象是navigator.geolocation，它有一些方法和属性，检测浏览器对html5地理位置的支持性也就是检测该对象。

2.getCurrentPosition、watchPosition和clearWatch方法
  这是geolocation的两个核心方法。第一个方法只获取地理位置信息，后一个方法以一定时间间隔获取地理位置信息，它们的参数相同，但返回值不同，后者返回一个watchId，将watchId作为参数传递给clearWatch方法可以终止对地理位置信息的请求。
  getCurrentPosition形如：
 

void getCurrentPosition(in PositionCallback successCallback,                            in optional PositionErrorCallback errorCallback,                            in optional PositionOptions options);

第一个参数是一个函数，用于处理成功接收到的地理位置信息，它通常接收一个position对象作为参数，并提供接收到的地理位置信息。
第二格参数是可选的，也是一个函数，用于错误处理，该函数通常接收一个error对象作为参数，error含有错误信息。
第三个参数用于进一步控制地理位置信息，也是可选的。它通常用花括号括起来，它通常有三个值：
enableHighAccuracy：用于控制精度，它的效果可能会有副作用。
timeout：用于指定地理位置信息请求的超时时间，单位是毫秒。
maximumAge：用于指定地理位置信息的更新频率，单位是毫秒。

一个示例如下：

navigator.geolocation.getCurrentPosition(updateLocation,handleLocationError,                                          {timeout:10000});

3.psition对象
其定义如下：

interface Position {      readonly attribute Coordinates coords;      readonly attribute DOMTimeStamp timestamp;   };

它有一个子对象coords和一个属性timestamp。
coords：是一个Coordinates对象，其定义如下：

立即学习“前端免费学习笔记（深入）”；

   interface Coordinates {         readonly attribute double latitude; //维度         readonly attribute double longitude; //经度         readonly attribute double? altitude; //高程（/m）         readonly attribute double accuracy; //经度和维度的精确度（/m）         readonly attribute double? altitudeAccuracy; //高程精确度（/m）         readonly attribute double? heading; //移动方向（/deg）         readonly attribute double? speed; //移动速度（/m/s）      };

其中带问号的属性在许多浏览器和设备中不会实现，如果没有这些属性，通过编程     获取的值将是null。
     latitude，longitude和accuracy三个属性，分别用于提供请求到的维度，经度和精    度信息。经纬度用小数表示，精度单位是米。

timestamp：时间戳。

4.error对象
  error对象有一个code属性，用于指定错误类型，可以认为code是一个枚举类型，它有四个值：0（UNKNOWN_ERROR1，1（PERMISSION_DENIED），2（POSITION_UNAVAILABLE）和
3（TIMEOUT）。
  另外，error还有一个message属性，用于提供错误的详细信息。