代码拉取完成，页面将自动刷新
从API Version 7 开始，该接口不再维护，推荐使用新接口
@ohos.geolocation。本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
import geolocation from '@system.geolocation';
ohos.permission.LOCATION
getLocation(Object): void
获取设备的地理位置。
系统能力： SystemCapability.Location.Location.Lite
参数:
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| timeout | number | 否 | 超时时间，单位为ms，默认值为30000。 设置超时，是为了防止出现权限被系统拒绝、定位信号弱或者定位设置不当，导致请求阻塞的情况。超时后会使用fail回调函数。 取值范围为32位正整数。如果设置值小于等于0，系统按默认值处理。 |
| coordType | string | 否 | 坐标系的类型，可通过getSupportedCoordTypes获取可选值，缺省值为wgs84。 |
| success | Function | 否 | 接口调用成功的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
| complete | Function | 否 | 接口调用结束的回调函数。 |
success返回值：
| 参数名 | 类型 | 说明 |
|---|---|---|
| longitude | number | 设备位置信息：经度。 |
| latitude | number | 设备位置信息：纬度。 |
| altitude | number | 设备位置信息：海拔。 |
| accuracy | number | 设备位置信息：精确度。 |
| time | number | 设备位置信息：时间。 |
fail返回错误代码：
| 错误码 | 说明 |
|---|---|
| 601 | 获取定位权限失败，失败原因：用户拒绝。 |
| 602 | 权限未声明。 |
| 800 | 超时，失败原因：网络状况不佳或GPS不可用。 |
| 801 | 系统位置开关未打开。 |
| 802 | 该次调用结果未返回前接口又被重新调用，该次调用失败返回错误码。 |
示例：
export default {
getLocation() {
geolocation.getLocation({
success: function(data) {
console.log('success get location data. latitude:' + data.latitude);
},
fail: function(data, code) {
console.log('fail to get location. code:' + code + ', data:' + data);
},
});
},
}
getLocationType(Object): void
获取当前设备支持的定位类型。
系统能力： SystemCapability.Location.Location.Lite
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | Function | 否 | 接口调用成功的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
| complete | Function | 否 | 接口调用结束的回调函数。 |
success返回值：
| 参数名 | 类型 | 说明 |
|---|---|---|
| types | Array<string> | 可选的定位类型['gps', 'network']。 |
示例：
export default {
getLocationType() {
geolocation.getLocationType({
success: function(data) {
console.log('success get location type:' + data.types[0]);
},
fail: function(data, code) {
console.log('fail to get location. code:' + code + ', data:' + data);
},
});
},
}
subscribe(Object): void
订阅设备的地理位置信息。多次调用的话，只有最后一次的调用生效。
系统能力： SystemCapability.Location.Location.Lite
参数：
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| coordType | string | 否 | 坐标系的类型，可通过getSupportedCoordTypes获取可选值，默认值为wgs84。 |
| success | Function | 是 | 位置信息发生变化的回调函数。 |
| fail | Function | 否 | 接口调用失败的回调函数。 |
success返回值：
| 参数名 | 类型 | 说明 |
|---|---|---|
| longitude | number | 设备位置信息：经度。 |
| latitude | number | 设备位置信息：纬度。 |
| altitude | number | 设备位置信息：海拔。 |
| accuracy | number | 设备位置信息：精确度。 |
| time | number | 设备位置信息：时间。 |
fail返回错误代码：
| 错误码 | 说明 |
|---|---|
| 601 | 获取定位权限失败，失败原因：用户拒绝。 |
| 602 | 权限未声明。 |
| 801 | 系统位置开关未打开。 |
示例：
export default {
subscribe() {
geolocation.subscribe({
success: function(data) {
console.log('get location. latitude:' + data.latitude);
},
fail: function(data, code) {
console.log('fail to get location. code:' + code + ', data:' + data);
},
});
},
}
unsubscribe(): void
取消订阅设备的地理位置信息。
系统能力： SystemCapability.Location.Location.Lite
示例：
export default {
unsubscribe() {
geolocation.unsubscribe();
},
}
getSupportedCoordTypes(): Array<string>
获取设备支持的坐标系类型。
系统能力： SystemCapability.Location.Location.Lite
返回值：
| 类型 | 非空 | 说明 |
|---|---|---|
| Array<string> | 是 | 表示坐标系类型，如[wgs84, gcj02]。 |
示例：
export default {
getSupportedCoordTypes() {
var types = geolocation.getSupportedCoordTypes();
},
}
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。
马建仓 AI 助手
