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属性，用于提供错误的详细信息。