PhoneGapAPI帮助文档翻译整理9Geolocation 定位.docx

PhoneGapAPI帮助文档翻译整理9Geolocation 定位.docx

《PhoneGapAPI帮助文档翻译整理9Geolocation 定位.docx》由会员分享，可在线阅读，更多相关《PhoneGapAPI帮助文档翻译整理9Geolocation 定位.docx（20页珍藏版）》请在冰豆网上搜索。

PhoneGapAPI帮助文档翻译整理9Geolocation定位

Geolocation （定位）

Methods

geolocation.getCurrentPosition（获得当前位置）

返回Position对象作为当前设备的位置

navigator.geolocation.getCurrentPosition（geolocationSuccess,

[geolocationError],

[geolocationOptions]）;

参数

∙geolocationSuccess:

使用当前位置作为参数的回调函数

∙geolocationError:

（可选）如果有错误发生则调用此回调函数

∙geolocationOptions:

（可选）地理位置选项

说明

geolocation.getCurrentPositon是一个异步函数.他通过回调携带以Position对象为参数的geolocationSuccess方法返回设备当前位置。

支持的平台

∙Android

∙BlackBerry（OS4.6）

∙BlackBerryWebWorks（OS5.0andhigher）

∙iPhone

简单的例子

//onSuccessCallback

//Thismethodacceptsa`Position`object,whichcontains

//thecurrentGPScoordinates

//

varonSuccess=function（position）{

alert（'Latitude:

'+position.coords.latitude+'\n'+

'Longitude:

'+position.coords.longitude+'\n'+

'Altitude:

'+position.coords.altitude+'\n'+

'Accuracy:

'+position.coords.accuracy+'\n'+

'AltitudeAccuracy:

'+position.coords.altitudeAccuracy+'\n'+

'Heading:

'+position.coords.heading+'\n'+

'Speed:

'+position.coords.speed+'\n'+

'Timestamp:

'+newDate（position.timestamp）+'\n'）;

};

//onErrorCallbackreceivesaPositionErrorobject

//onError :

本回调函数接收PositionError对象

functiononError（error）{

alert（'code:

'+error.code+'\n'+

'message:

'+error.message+'\n'）;

}

navigator.geolocation.getCurrentPosition（onSuccess,onError）;

完整的例子

DOCTYPEHTMLPUBLIC"-//W3C//DTDHTML4.01//EN""http:

//www.w3.org/TR/html4/strict.dtd">

//WaitforPhoneGaptoload

//等待加载PhoneGap

functiononLoad（）{

document.addEventListener（"deviceready",onDeviceReady,false）;

}

//PhoneGapisready

//PhoneGap加载完毕

functiononDeviceReady（）{

navigator.geolocation.getCurrentPosition（onSuccess,onError）;

}

//onSuccessGeolocation

//onSuccess定位

functiononSuccess（position）{

varelement=document.getElementById（'geolocation'）;

element.innerHTML='Latitude:

'+position.coords.latitude+'
'+

'Longitude:

'+position.coords.longitude+'
'+

'Altitude:

'+position.coords.altitude+'
'+

'Accuracy:

'+position.coords.accuracy+'
'+

'AltitudeAccuracy:

'+position.coords.altitudeAccuracy+'
'+

'Heading:

'+position.coords.heading+'
'+

'Speed:

'+position.coords.speed+'
'+

'Timestamp:

'+newDate（position.timestamp）+'
';

}

//onErrorCallbackreceivesaPositionErrorobject

//此回调函数接收PositionError对象

functiononError（error）{

alert（'code:

'+error.code+'\n'+

'message:

'+error.message+'\n'）;

}

Findinggeolocation...

geolocation.watchPosition（监控位置变化）

监控设备当前位置的变化情况

varwatchId=navigator.geolocation.watchPosition（geolocationSuccess,

[geolocationError],

[geolocationOptions]）;

参数

geolocationSuccess:

Thecallbackthatiscalledwiththecurrentposition.

geolocationSuccess:

以设备当前位置为参数的回调函数

geolocationError:

（Optional）Thecallbackthatiscallediftherewasanerror.

geolocationError:

（可选）如果发生了错误，则此回到函数被调用

geolocationOptions:

（Optional）Thegeolocationoptions.

geolocationOptions:

（可选）地理定位选项

返回

String:

返回位置监控器的句柄,此句柄可用于geolocation.clearWatch函数，以停止对位置改变的监控

说明

geolocation.watchPosition是一个异步函数,当检测到设备的当前位置发生改变时,此函数会回报系统当前位置.当设备被置于一个新的位置,使用Position对象作为参数的回调函数geolocationSuccess将呗调用.如果发生错误,使用PositionError对象作为参数的geolocationError将被调用。

支持的平台

∙Android

∙BlackBerry（OS4.6）

∙BlackBerryWebWorks（OS5.0andhigher）

∙iPhone

简单的例子

//onSuccessCallback

//Thismethodacceptsa`Position`object,whichcontains

//thecurrentGPScoordinates

//onSuccess

//这个方法接收一个定位对象,这个定位对象包含了当前GPS坐标数据

functiononSuccess（position）{

varelement=document.getElementById（'geolocation'）;

element.innerHTML='Latitude:

'+position.coords.latitude+'
'+

'Longitude:

'+position.coords.longitude+'
'+

'

'+element.innerHTML;

}

//onErrorCallbackreceivesaPositionErrorobject

//onError回调函数接收一个PositionError对象

functiononError（error）{

alert（'code:

'+error.code+'\n'+

'message:

'+error.message+'\n'）;

}

//Options:

retrievethelocationevery3seconds

//Options：

每三秒接收一次定位数据

varwatchID=navigator.geolocation.watchPosition（onSuccess,onError,{frequency:

3000}）;

完整的例子

DOCTYPEHTMLPUBLIC"-//W3C//DTDHTML4.01//EN""http:

//www.w3.org/TR/html4/strict.dtd">

//WaitforPhoneGaptoload

//等待加载PhoneGap

functiononLoad（）{

document.addEventListener（"deviceready",onDeviceReady,false）;

}

varwatchID=null;

//PhoneGapisready

//PhoneGap加载完毕

functiononDeviceReady（）{

//Updateevery3seconds

varoptions={frequency:

3000};

watchID=navigator.geolocation.watchPosition（onSuccess,onError,options）;

}

//onSuccessGeolocation

//onSuccess获得定位信息

functiononSuccess（position）{

varelement=document.getElementById（'geolocation'）;

element.innerHTML='Latitude:

'+position.coords.latitude+'
'+

'Longitude:

'+position.coords.longitude+'
'+

}

//onErrorCallbackreceivesaPositionErrorobject

//回调函数onError接收一个PositionError对象

functiononError（error）{

alert（'code:

'+error.code+'\n'+

'message:

'+error.message+'\n'）;

}

Watchinggeolocation...

geolocation.clearWatch（停止对GPS数据的监控）

以watchID作为参数，用于停止对设备位置信息的监控

参数

∙watchID:

由watchPosition返回的操作句柄

说明

函数geolocation.clearWatch使用watchID作为参数，用于停止对设备位置变化的监控

支持的平台

∙Android

∙BlackBerry（OS4.6）

∙BlackBerryWebWorks（OS5.0andhigher）

∙iPhone

简单的例子

//可选参数:

每三秒获得一次定位信息

varwatchID=navigator.geolocation.watchPosition（onSuccess,onError,{frequency:

3000}）;

//...lateron...

navigator.geolocation.clearWatch（watchID）;

完整的例子:

DOCTYPEHTMLPUBLIC"-//W3C//DTDHTML4.01//EN""http:

//www.w3.org/TR/html4/strict.dtd">

//WaitforPhoneGaptoload

//等待加载PhoneGap

functiononLoad（）{

document.addEventListener（"deviceready",onDeviceReady,false）;

}

varwatchID=null;

//PhoneGapisready

//PhoneGap加载完毕

functiononDeviceReady（）{

//Updateevery3seconds

//每3秒更新一次数据

varoptions={frequency:

3000};

watchID=navigator.geolocation.watchPosition（onSuccess,onError,options）;

}

//onSuccessGeolocation

//成功获得GPS数据

functiononSuccess（position）{

varelement=document.getElementById（'geolocation'）;

element.innerHTML='Latitude:

'+position.coords.latitude+'
'+

'Longitude:

'+position.coords.longitude+'
'+

'

}

//clearthewatchthatwasstartedearlier

//清除先前对GPS数据的监控

functionclearWatch（）{

if（watchID !

=null）{

navigator.geolocation.clearWatch（watchID）;

watchID=null;

}

}

//onErrorCallbackreceivesaPositionErrorobject

//错误处理函数接收一个PositionError对象

functiononError（error）{

alert（'code:

'+error.code+'\n'+

'message:

'+error.message+'\n'）;

}

Watchinggeolocation...

ClearWatch

Arguments（参数）

geolocationSuccess（成功获得信息）

当得到一个有效地理位置时，此回调函数被调用

function（position）{

//Dosomething

//结果处理

}

参数:

∙position:

设备韩慧的地理位置

例子:

functiongeolocationSuccess（position）{

alert（'Latitude:

'+position.coords.latitude+'\n'+

'Longitude:

'+position.coords.longitude+'\n'+

'Altitude:

'+position.coords.altitude+'\n'+

'Accuracy:

'+position.coords.accuracy+'\n'+

'AltitudeAccuracy:

'+position.coords.altitudeAccuracy+'\n'+

'Heading:

'+position.coords.heading+'\n'+

'Speed:

'+position.coords.speed+'\n'+

'Timestamp:

'+newDate（position.timestamp）+'\n'）;

}

geolocationError（错误处理函数）

当地理位置相关函数发生错误的时候，此回调函数将被调用

function（error）{

//Handletheerror

//处理错误

}

参数

∙error:

设备返回的错误（PositionError对象）

geolocationOptions（选项）

用于定制地理定位操作的可选参数

{maximumAge:

3000,timeout:

5000,enableHighAccuracy:

true};

Options：

选项

∙frequency：

检测位置信息的周期间隔.这个选项并非W3C规范的一部分，并且此选项未来将被移除，maxmumAge将替代此选项（缺省值：

10000）

∙enableHighAccuracy：

指示本程序需要接受最合理的结果

∙timeout:

从调用geolocation.getCurrentPosition或者geolocation.watchPosition开始直到对应的回调函数geolocationSuccess被调用，这之间最多被允许的最大时间差可用timeout选项设置。

∙maximumAge:

被缓存的地理信息的存在时间不允许超过此参数所指定毫秒数

Android的独特之处

除非enableHighAccuracy被设定为true,否则Adroid2.x模拟器不会返回一个地理位置

{enableHighAccuracy:

true}

Objects（Read-Only）对象（只读）

Position（位置）

由geolocationAPI建立的位置坐标对象

属性:

∙地理坐标的数据集合

∙建立coords的时间戳（以毫秒为单位）

说明

Position对象由PhoneGap建立并填写,此对象会作为会作为回调函数的参数返回给用户

支持的平台

∙Android

∙BlackBerry（OS4.6）

∙BlackBerryWebWorks（OS5.0andhigher）

∙iPhone

简单的例子

//onSuccessCallback

//成功获取信息后调用的回调函数

varonSuccess=function（position）{

alert（'Latitude:

'+position.coords.latitude+'\n'+

'Longitude:

'+position.coords.longitude+'\n'+

'Altitude:

'+position.coords.altitude+'\n'+

'Accuracy:

'+position.coords.accuracy+'\n'+

'AltitudeAccuracy:

'+position.coords.altitudeAccuracy+'\n'+

'Heading:

'+position.coords.heading+'\n'+

'Speed:

'+position.coords.speed+'\n'+

'Timestamp:

'+newDate（position.timestamp）+'\n'）;

};

//onErrorCallbackreceivesaPositionE