1.navigator.geolocation
HTML5中的地理位置相關(guān)的主要對(duì)象是navigator.geolocation,它有一些方法和屬性,檢測(cè)瀏覽器對(duì)HTML5地理位置的支持性也就是檢測(cè)該對(duì)象。
2.getCurrentPosition、watchPosition和clearWatch方法
這是geolocation的兩個(gè)核心方法。第一個(gè)方法只獲取地理位置信息,后一個(gè)方法以一定時(shí)間間隔獲取地理位置信息,它們的參數(shù)相同,但返回值不同,后者返回一個(gè)watchId,將watchId作為參數(shù)傳遞給clearWatch方法可以終止對(duì)地理位置信息的請(qǐng)求。
getCurrentPosition形如:
void getCurrentPosition(in PositionC all back successCallback, in optional PositionErrorCallback errorCallback, in optional PositionOptions options);
第一個(gè)參數(shù)是一個(gè)函數(shù),用于處理成功接收到的地理位置信息,它通常接收一個(gè)position對(duì)象作為參數(shù),并提供接收到的地理位置信息。
第二格參數(shù)是可選的,也是一個(gè)函數(shù),用于錯(cuò)誤處理,該函數(shù)通常接收一個(gè)error對(duì)象作為參數(shù),error含有錯(cuò)誤信息。
第三個(gè)參數(shù)用于進(jìn)一步控制地理位置信息,也是可選的。它通常用花括號(hào)括起來,它通常有三個(gè)值:
enableHighAccuracy:用于控制精度,它的效果可能會(huì)有副作用。
timeout:用于指定地理位置信息請(qǐng)求的超時(shí)時(shí)間,單位是毫秒。
maximumAge:用于指定地理位置信息的更新頻率,單位是毫秒。
一個(gè)示例如下:
navigator.geolocation.getCurrentPosition(up date Location,han dl eLocationError, {timeout:10000});
3.psition對(duì)象
其定義如下:
interface Position { readonly attribute Co ord inates coords; readonly attribute DOMTimeStamp timestamp; };
它有一個(gè)子對(duì)象coords和一個(gè)屬性timestamp。
coords:是一個(gè)Coordinates對(duì)象,其定義如下:
interface Coordinates { readonly attribute double latitude; //維度 readonly attribute double lon git ude; //經(jīng)度 readonly attribute double? altitude; //高程(/m) readonly attribute double accuracy; //經(jīng)度和維度的精確度(/m) readonly attribute double? altitudeAccuracy; //高程精確度(/m) readonly attribute double? head ing; //移動(dòng)方向(/deg) readonly attribute double? speed; //移動(dòng)速度(/m/s) };
其中帶問號(hào)的屬性在許多瀏覽器和設(shè)備中不會(huì)實(shí)現(xiàn),如果沒有這些屬性,通過編程 獲取的值將是null。
latitude,longitude和accuracy三個(gè)屬性,分別用于提供請(qǐng)求到的維度,經(jīng)度和精 度信息。經(jīng)緯度用小數(shù)表示,精度單位是米。
timestamp:時(shí)間戳。
4.error對(duì)象
error對(duì)象有一個(gè)code屬性,用于指定錯(cuò)誤類型,可以認(rèn)為code是一個(gè)枚舉類型,它有四個(gè)值:0(UNKNOWN_ERROR1,1(PERMISSION_DENIED),2(POSITION_UNAVAILABLE)和
3(TIMEOUT)。
另外,error還有一個(gè)message屬性,用于提供錯(cuò)誤的詳細(xì)信息。