宜信同城网交流论坛技术专版技术专区Geolocation模块管理设备位置信息，用于获取地理位置信息，如经度、纬度等。通过plus. ...方法： getCurrentPosition: 获取当前设备位置信息watchPosition: 监听设备位置变化信息clearWatch: 关 ...

admin 发表于 2023-2-16 18:54:53

Geolocation模块管理设备位置信息，用于获取地理位置信息，如经度、纬度等。通过plus. ...

<div id="article_content" class="article_content clearfix">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/kdoc_html_views-1a98987dfd.css">
 <link rel="stylesheet" href="https://csdnimg.cn/release/blogv2/dist/mdeditor/css/editerView/ck_htmledit_views-6e43165c0a.css">
 <div id="content_views" class="htmledit_views">
 <h2 style="margin-left:.8em;">方法：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122812578#plus.geolocation.getCurrentPosition">getCurrentPosition</a>: 获取当前设备位置信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122812578#plus.geolocation.watchPosition">watchPosition</a>: 监听设备位置变化信息</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122812578#plus.geolocation.clearWatch">clearWatch</a>: 关闭监听设备位置信息</li></ul>
<h2 style="margin-left:.8em;">对象：</h2>
<ul><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122812578#plus.geolocation.Position">Position</a>: JSON对象，设备位置信息数据</li><li><ahref="https://www.html5plus.org/doc/zh_cn/geolocation.html#plus.geolocation.Address">Address</a>: JSON对象，地址信息</li><li><ahref="https://www.html5plus.org/doc/zh_cn/geolocation.html#plus.geolocation.Coordinates">Coordinates</a>: JSON对象，地理坐标信息</li><li><ahref="https://www.html5plus.org/doc/zh_cn/geolocation.html#plus.geolocation.PositionOptions">PositionOptions</a>: JSON对象，监听设备位置信息参数</li><li><ahref="https://blog.csdn.net/qq_40575646/article/details/122812578#plus.geolocation.GeolocationError">GeolocationError</a>: JSON对象，定位错误信息</li></ul>
<h2 style="margin-left:.8em;">回调方法：</h2>
<ul><li><ahref="https://www.html5plus.org/doc/zh_cn/geolocation.html#plus.geolocation.GeolocationSuccessCallback">GeolocationSuccessCallback</a>: 获取设备位置信息成功的回调函数</li><li><ahref="https://www.html5plus.org/doc/zh_cn/geolocation.html#plus.geolocation.GeolocationErrorCallback">GeolocationErrorCallback</a>: 获取设备位置信息失败的回调函数</li></ul>
<h2 style="margin-left:.8em;">权限：</h2>
5+功能模块（permissions）
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
{
// ...
"permissions":{
// ...
"Geolocation": {
"description": "位置信息"
}
}
}
</code></code></pre>
<h1 style="margin-left:0;">getCurrentPosition</h1>
获取当前设备位置信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.geolocation.getCurrentPosition(successCB, errorCB, option);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
位置信息将通过手机GPS设备或其它信息如IP地址、移动网络信号获取，由于获取位置信息可能需要较长的时间，当成功获取位置信息后将通过successCB回调函数返回。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/geolocation.html#plus.geolocation.GeolocationSuccessCallback">GeolocationSuccessCallback</a> ) 必选 获取设备位置信息成功回调函数 </li><li>errorCB: ( <ahref="https://www.html5plus.org/doc/zh_cn/geolocation.html#plus.geolocation.GeolocationErrorCallback">GeolocationErrorCallback</a> ) 可选 获取设备位置信息失败回调函数 </li><li>options: ( <ahref="https://www.html5plus.org/doc/zh_cn/geolocation.html#plus.geolocation.PositionOptions">PositionOptions</a> ) 可选 获取设备位置信息的参数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 支持 </li><li>iOS - 4.3+ (支持) : 支持 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">watchPosition</h1>
监听设备位置变化信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
Number plus.geolocation.watchPosition(successCB, errorCB, option);
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
位置信息将通过手机GPS设备或其它信息如IP地址、移动网络信号获取。当位置信息更新后将通过successCB回调函数返回。位置信息获取失败则调用回调函数errorCB。
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>successCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122812578#plus.geolocation.GeolocationSuccessCallback">GeolocationSuccessCallback</a> ) 必选 设备位置信息更新成功回调函数 </li><li>errorCB: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122812578#plus.geolocation.GeolocationErrorCallback">GeolocationErrorCallback</a> ) 可选 获取设备位置信息失败回调函数 </li><li>option: ( <ahref="https://blog.csdn.net/qq_40575646/article/details/122812578#plus.geolocation.PositionOptions">PositionOptions</a> ) 可选 监听设备位置信息的参数 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
Number : 用于标识位置信息监听器，可通过clearWatch方法取消监听。
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 支持 </li><li>iOS - 4.3+ (支持) : 支持 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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.watchPosition(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>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">clearWatch</h1>
关闭监听设备位置信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void plus.geolocation.clearWatch(watchId);
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>watchId: ( Number ) 必选 需要取消的位置监听器标识，调用watchPosition方法的返回值。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">平台支持：</h2>
<ul><li>Android - 2.2+ (支持) : 支持 </li><li>iOS - 4.3+ (支持) : 支持 </li></ul>
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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
var wid = null;
function onPlusReady(){
wid = plus.geolocation.watchPosition(function(p){
alert('Geolocation\nLatitude:' + p.coords.latitude + '\nLongitude:' + p.coords.longitude + '\nAltitude:' + p.coords.altitude);
}, function(e){
alert('Geolocation error: ' + e.message);
});
}
function cancel(){
plus.geolocation.clearWatch(wid);
wid = null;
}
</script>
</head>
<body >
<input type="button" value="Cancel" onclick="cancel();"></input>
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">Position</h1>
JSON对象，设备位置信息数据
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface Position {
readonly attribute Coordinates coords;
readonly attribute String coordsType;
readonly attribute Number timestamp;
readonly attribute Address address;
readonly attribute String addresses;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>coords: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122812578#plus.geolocation.Coordinates">Coordinates</a> 类型 )地理坐标信息，包括经纬度、海拔、速度等信息</li><li>coordsType: (String 类型 )获取到地理坐标信息的坐标系类型 可取以下坐标系类型： "wgs84"：表示WGS-84坐标系； "gcj02"：表示国测局经纬度坐标系； "bd09"：表示百度墨卡托坐标系，仅百度定位支持； "bd09ll"：表示百度经纬度坐标系，仅百度定位支持。 </li><li>timestamp: (Number 类型 )获取到地理坐标的时间戳信息 时间戳值为从1970年1月1日至今的毫秒数。 </li><li>address: (<ahref="https://blog.csdn.net/qq_40575646/article/details/122812578#plus.geolocation.Address">Address</a> 类型 )获取到地理位置对应的地址信息 获取地址信息需要连接到服务器进行解析，所以会消耗更多的资源，如果不需要获取地址信息可通过设置PositionOptions参数的geocode属性值为false避免获取地址信息。如果没有获取到地址信息则返回undefined。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.3+ (支持) : 使用系统定位模块无法获取位置信息。 </li><li>iOS - 5.1+ (支持) : 系统定位模块也支持获取位置信息。 </li></ul></li><li>addresses: (String 类型 )获取完整地址描述信息 如果没有获取到地址信息则返回undefined。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.3+ (支持) : 使用系统定位模块无法获取位置信息。 </li><li>iOS - 5.1+ (支持) : 系统定位模块也支持获取位置信息。 </li></ul></li></ul>
<h1 style="margin-left:0;">Address</h1>
JSON对象，地址信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface Address {
readonly attribute String country;
readonly attribute String province;
readonly attribute String city;
readonly attribute String district;
readonly attribute String street;
readonly attribute String streetNum;
readonly attribute String poiName;
readonly attribute String postalCode;
readonly attribute String cityCode;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>country: (String 类型 )国家 如“中国”，如果无法获取此信息则返回undefined。 </li><li>province: (String 类型 )省份名称 如“北京市”，如果无法获取此信息则返回undefined。 </li><li>city: (String 类型 )城市名称 如“北京市”，如果无法获取此信息则返回undefined。 </li><li>district: (String 类型 )区（县）名称 如“朝阳区”，如果无法获取此信息则返回undefined。 </li><li>street: (String 类型 )街道信息 如“酒仙桥路”，如果无法获取此信息则返回undefined。 </li><li>streetNum: (String 类型 )获取街道门牌号信息 如“3号”，如果无法获取此信息则返回undefined。 </li><li>poiName: (String 类型 )POI信息 如“电子城．国际电子总部”，如果无法获取此信息则返回undefined。 </li><li>postalCode: (String 类型 )邮政编码 如“100016”，如果无法获取此信息则返回undefined。 </li><li>cityCode: (String 类型 )城市代码 如“010”，如果无法获取此信息则返回undefined。 </li></ul>
<h1 style="margin-left:0;">Coordinates</h1>
JSON对象，地理坐标信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface Coordinates {
readonly attribute double latitude;
readonly attribute double longitude;
readonly attribute double altitude;
readonly attribute double accuracy;
readonly attribute double altitudeAccuracy;
readonly attribute double heading;
readonly attribute double speed;
}
</code></code></pre>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>latitude: (Number 类型 )坐标纬度值 数据类型对象，地理坐标中的纬度值。 </li><li>longitude: (Number 类型 )坐标经度值 数据类型对象，地理坐标中的经度值。 </li><li>altitude: (Number 类型 )海拔信息 数据类型对象，如果无法获取此信息，则此值为空（null）。 </li><li>accuracy: (Number 类型 )地理坐标信息的精确度信息 数据类型对象，单位为米，其有效值必须大于0。 </li><li>altitudeAccuracy: (Number 类型 )海拔的精确度信息 数据类型对象，单位为米，其有效值必须大于0。如果无法获取海拔信息，则此值为空（null）。 </li><li>heading: (Number 类型 )表示设备移动的方向 数据类型对象，范围为0到360，表示相对于正北方向的角度。如果无法获取此信息，则此值为空（null）。如果设备没有移动则此值为NaN。 </li><li>speed: (Number 类型 )表示设备移动的速度 数据类型对象，单位为米每秒（m/s），其有效值必须大于0。如果无法获取速度信息，则此值为空（null）。 </li></ul>
<h1 style="margin-left:0;">PositionOptions</h1>
JSON对象，监听设备位置信息参数
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>enableHighAccuracy: (Boolean 类型 )是否高精确度获取位置信息 高精度获取表示需要使用更多的系统资源，默认值为false。 </li><li>timeout: (Number 类型 )获取位置信息的超时时间 单位为毫秒（ms），默认值为不超时。如果在指定的时间内没有获取到位置信息则触发错误回调函数。 </li><li>maximumAge: (Number 类型 )获取位置信息的间隔时间 单位为毫秒（ms），默认值为1000（即1秒）。调用plus.geolocation.watchPosition时为更新位置信息的间隔时间。注意：在不同定位模块下支持范围值可能不同，如百度定位模块的间隔范围为大于等于1秒，如果设置的值小于最小值则使用最小值。 </li><li>provider: (String 类型 )优先使用的定位模块 可取以下供应者： "system"：表示系统定位模块，支持wgs84坐标系； "baidu"：表示百度定位模块，支持gcj02/bd09/bd09ll坐标系； "amap"：表示高德定位模块，支持gcj02坐标系。默认值按以下优先顺序获取（amap>baidu>system），若指定的provider不存在或无效则返回错误回调。注意：百度/高德定位模块需要配置百度/高德地图相关参数才能正常使用。 <h3 style="margin-left:0;">平台支持</h3>
<ul style="margin-left:2em;"><li>Android - 2.2+ (支持)</li><li>iOS - 4.5+ (支持) : HBuilderX2.4.3+版本支持高德定位模块，默认使用优先级（amap>baidu>system）； HBuilderX2.4.2及以前版本不支持高德定位模块，默认使用系统定位模块。 </li></ul><pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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);
},{provider:'baidu'});
}
</script>
</head>
<body >
</body>
</html>
</code></code></pre> </li><li>coordsType: (String 类型 )指定获取的定位数据坐标系类型 可取以下坐标系类型： "wgs84"：表示WGS-84坐标系； "gcj02"：表示国测局经纬度坐标系； "bd09"：表示百度墨卡托坐标系； "bd09ll"：表示百度经纬度坐标系； provider为"system"时，支持wgs84坐标系，默认使用"wgs84"坐标系； provider为"baidu"时，支持gcj02/bd09/bd09ll坐标系，默认使用"gcj02"坐标系； provider为"amap"时，支持gcj02坐标系，默认使用"gcj02"坐标系。如果设置的坐标系类型provider不支持，则返回错误。 </li><li>geocode: (Boolean 类型 )是否解析地址信息 解析的地址信息保存到Position对象的address、addresses属性中，true表示解析地址信息，false表示不解析地址信息，返回的Position对象的address、addresses属性值为undefined，默认值为true。如果解析地址信息失败则返回的Position对象的address、addresses属性值为null。 </li></ul>
<h1 style="margin-left:0;">GeolocationError</h1>
JSON对象，定位错误信息
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
interface GeolocationError {
const Number PERMISSION_DENIED = 1;
const Number POSITION_UNAVAILABLE = 2;
const Number TIMEOUT = 3;
readonly attribute Number code;
readonly attribute String message;
}
</code></code></pre>
<h2 style="margin-left:.8em;">说明：</h2>
这里根据W3C规范定义了<ahref="https://developer.mozilla.org/en-US/docs/Web/API/GeolocationPositionError">定位标准错误码</a>，在此基础上5+ 扩展了错误码，参考 <ahref="https://ask.dcloud.net.cn/article/282#geolocation">5+ API错误代码中的“Geolocation模块错误”</a>
<h2 style="margin-left:.8em;">常量：</h2>
<ul><li>PERMISSION_DENIED: (Number 类型 )访问权限被拒绝 系统不允许程序获取定位功能，错误代码常量值为1。 </li><li>POSITION_UNAVAILABLE: (Number 类型 )位置信息不可用 无法获取有效的位置信息，错误代码常量值为2。 </li><li>TIMEOUT: (Number 类型 )获取位置信息超时 无法在指定的时间内获取位置信息，错误代码常量值为3。 </li></ul>
<h2 style="margin-left:.8em;">属性：</h2>
<ul><li>code: (Number 类型 )错误代码 可取值：
<ul style="margin-left:2em;"><li>PERMISSION_DENIED - 用户拒绝授权</li><li>POSITION_UNAVAILABLE - 位置服务不可用，如系统定位服务关闭</li><li>TIMEOUT - 定位超时，定位时超过PositionOptions.timeout设置的时间触发，此时通常可以重试</li><li>其它错误 - 5+ 扩展错误码，参考 <ahref="https://ask.dcloud.net.cn/article/282#geolocation">5+ API错误代码中的“Geolocation模块错误”</a></li></ul> </li><li>message: (String 类型 )错误描述信息 详细错误描述信息。 </li></ul>
<h1 style="margin-left:0;">GeolocationSuccessCallback</h1>
获取设备位置信息成功的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
void onSuccess( position ) {
// Get Position code.
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>position: ( <ahref="https://www.html5plus.org/doc/zh_cn/geolocation.html#plus.geolocation.Position">Position</a> ) 必选 设备的地理位置信息，参考Position </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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);
console.log('Geolocation info: ' + JSON.stringify(p));
}, function(e){
console.log('Gelocation Error: code - ' + e.code + '; message - ' + e.message);
} );
}
</script>
</head>
<body >
</body>
</html>
</code></code></pre>
<ahref="https://uniapp.dcloud.io/use-html5plus">uni-app使用plus注意事项</a>
<h1 style="margin-left:0;">GeolocationErrorCallback</h1>
获取设备位置信息失败的回调函数
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
function void onGeolocationError( GeolocationError error ) {
// Handle error
var code = error.code; // 错误编码
var message = error.message; // 错误描述信息
}
</code></code></pre>
<h2 style="margin-left:.8em;">参数：</h2>
<ul><li>error: ( <ahref="https://www.html5plus.org/doc/zh_cn/geolocation.html#plus.geolocation.GeolocationError">GeolocationError</a> ) 必选 获取位置操作的错误信息 可通过error.code（Number类型）获取错误编码； 可通过error.message（String类型）获取错误描述信息。 </li></ul>
<h2 style="margin-left:.8em;">返回值：</h2>
void : 无
<h2 style="margin-left:.8em;">示例：</h2>
<pre class="has" style="margin-left:0;"><code class="language-prettyprint"><code>
<!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){
console.log('Geolocation\nLatitude:' + p.coords.latitude + '\nLongitude:' + p.coords.longitude + '\nAltitude:' + p.coords.altitude);
}, function(e){
console.log('Gelocation Error: code - ' + e.code + '; message - ' + e.message);
 switch(e.code) {
 case e.PERMISSION_DENIED:
 alert('User denied the request for Geolocation.');
 break;
 case e.POSITION_UNAVAILABLE:
 alert('Location information is unavailable.');
 break;
 case e.TIMEOUT:
 alert('The request to get user location timed out.');
 break;
 case e.UNKNOWN_ERROR:
 alert('An unknown error occurred.');
 break;
 }
} );
}
</script>
</head>
<body >
</body>
</html>
</code></code></pre>
 </div>
 </div>
 <div id="treeSkill"></div>

页: [1]

宜信同城网交流论坛's Archiver

Geolocation模块管理设备位置信息，用于获取地理位置信息，如经度、纬度等。通过plus. ...