HTML5-Geolocation APIs的示例代码
HTML5中的地理位置相关的主要对象是navigator.geolocation,它有一些方法和属性,检测浏览器对HTML5地理位置的支持性也就是检测该对象。
2.getCurrentPosition、watchPosition和clearWatch方法
这是geolocation的两个核心方法。第一个方法只获取地理位置信息,后一个方法以一定时间间隔获取地理位置信息,它们的参数相同,但返回值不同,后者返回一个watchId,将watchId作为参数传递给clearWatch方法可以终止对地理位置信息的请求。
getCurrentPosition形如:
void getCurrentPosition(in PositionC all back successCallback, in optional PositionErrorCallback errorCallback, in optional PositionOptions options);
第一个参数是一个函数,用于处理成功接收到的地理位置信息,它通常接收一个position对象作为参数,并提供接收到的地理位置信息。
第二格参数是可选的,也是一个函数,用于错误处理,该函数通常接收一个error对象作为参数,error含有错误信息。
第三个参数用于进一步控制地理位置信息,也是可选的。它通常用花括号括起来,它通常有三个值:
enableHighAccuracy:用于控制精度,它的效果可能会有副作用。
timeout:用于指定地理位置信息请求的超时时间,单位是毫秒。
maximumAge:用于指定地理位置信息的更新频率,单位是毫秒。
一个示例如下:
navigator.geolocation.getCurrentPosition(up date Location,han dl eLocationError, {timeout:10000});
3.psition对象
其定义如下:
interface Position { readonly attribute Co ord inates coords; readonly attribute DOMTimeStamp timestamp; };
它有一个子对象coords和一个属性timestamp。
coords:是一个Coordinates对象,其定义如下:
interface Coordinates { readonly attribute double latitude; //维度 readonly attribute double lon git ude; //经度 readonly attribute double? altitude; //高程(/m) readonly attribute double accuracy; //经度和维度的精确度(/m) readonly attribute double? altitudeAccuracy; //高程精确度(/m) readonly attribute double? head ing; //移动方向(/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属性,用于提供错误的详细信息。
以上就是HTML5-Geolocation APIs的示例代码的详细内容,更多请关注其它相关文章!