Geolocation模块管理设备位置信息,用于获取地理位置信息,如经度、纬度等。通过plus.geolocation可获取设备位置管理对象。虽然W3C已经提供标准API获取位置信息,但在某些平台存在差异或未实现,为了保持各平台的统一性,定义此规范接口获取位置信息。
1、方法
1.1、getCurrentPosition: 获取当前设备位置信息
void plus.geolocation.getCurrentPosition( successCB, errorCB, option );
说明:位置信息将通过手机GPS设备或其它信息如IP地址、移动网络信号获取,由于获取位置信息可能需要较长的时间,当成功获取位置信息后将通过successCB回调函数返回。
参数:
successCB: ( GeolocationSuccessCallback ) 必选 获取设备位置信息成功回调函数
errorCB: ( GeolocationErrorCallback ) 可选 获取设备位置信息失败回调函数
option: ( PositionOptions ) 可选 获取设备位置信息的参数
返回值:void : 无
平台支持:Android - 2.2+ (支持): 支持、iOS - 4.3+ (支持): 支持
示例:
- <!DOCTYPE html>
- <html>
- <head>
- <meta charset="utf-8">
- <title>Geolocation Example</title>
- <script type="text/javascript" >
- // 扩展API加载完毕后调用onPlusReady回调函数
- document.addEventListener( "plusready", onPlusReady, false );
- // 扩展API加载完毕,现在可以正常调用扩展API
- function onPlusReady() {
- plus.geolocation.getCurrentPosition( function ( p ) {
- alert( "Geolocation\nLatitude:" + p.coords.latitude + "\nLongitude:" + p.coords.longitude + "\nAltitude:" + p.coords.altitude );
- }, function ( e ) {
- alert( "Geolocation error: " + e.message );
- } );
- }
- </script>
- </head>
- <body >
- </body>
- </html>
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Geolocation Example</title>
<script type="text/javascript" >
// 扩展API加载完毕后调用onPlusReady回调函数
document.addEventListener( "plusready", onPlusReady, false );
// 扩展API加载完毕,现在可以正常调用扩展API
function onPlusReady() {
plus.geolocation.getCurrentPosition( function ( p ) {
alert( "Geolocation\nLatitude:" + p.coords.latitude + "\nLongitude:" + p.coords.longitude + "\nAltitude:" + p.coords.altitude );
}, function ( e ) {
alert( "Geolocation error: " + e.message );
} );
}
</script>
</head>
<body >
</body>
</html>
1.2、watchPosition: 监听设备位置变化信息
Number plus.geolocation.watchPosition( successCB, errorCB, option );
说明:位置信息将通过手机GPS设备或其它信息如IP地址、移动网络信号获取。当位置信息更新后将通过successCB回调函数返回。位置信息获取失败则调用回调函数errorCB。
参数:
successCB: ( GeolocationSuccessCallback ) 必选 设备位置信息更新成功回调函数
errorCB: ( GeolocationErrorCallback ) 可选 获取设备位置信息失败回调函数
option: ( PositionOptions ) 可选 监听设备位置信息的参数
返回值:Number : 用于标识位置信息监听器,可通过clearWatch方法取消监听。
平台支持:Android - 2.2+ (支持): 支持,iOS - 4.3+ (支持): 支持
示例:
- <!DOCTYPE html>
- <html>
- <head>
- <meta charset="utf-8">
- <title>Geolocation Example</title>
- <script type="text/javascript" >