输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
文档管理中心

HarmonyOS元服务

输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
ASCF框架
ASCF框架API参考API位置

位置

更新时间: 2026-08-03 06:28
本文导读
展开章节

has.openLocation

has.openLocation(Object object)

使用引擎内置地图查看具体位置。

使用前，需参考开发准备完成基本准备工作。

起始版本： 1.0.0

参数：

参数为Object对象，包括以下字段。

展开
参数 类型 必填 描述
latitude number 是

纬度，范围为-90 ~ 90，负数表示南纬。

注：中国大陆、港澳地区，请使用gcj02，其他地区请使用wgs84。
longitude number 是

经度，范围为-180 ~ 180，负数表示西经。根据type字段决定使用哪套坐标系。

注：中国大陆、港澳地区，请使用gcj02，其他地区请使用wgs84。
name string 是 位置名。
address string 否 地址的详细说明。
success function 否 接口调用成功的回调函数。
fail function 否 接口调用失败的回调函数。
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）。

示例：

收起
自动换行
深色代码主题
复制
  1. has.openLocation({
  2.   longitude: 114.52845090013192,
  3.   latitude: 30.497287768914163,
  4.   name: 'name',
  5.   address: 'address',
  6.   success: () => {
  7.     console.info('openLocation success');
  8.   },
  9.   fail: (err) => {
  10.     console.error('openLocation fail', err);
  11.   },
  12.   complete: (res) => {
  13.     console.info('openLocation complete', res);
  14.   }
  15. });

has.getLocation

has.getLocation(Object object)

获取当前的地理位置、速度。开启高精度定位，接口耗时会增加，可指定 highAccuracyExpireTime 作为超时时间。

起始版本： 1.0.0

需要权限：

  1. 在module.json5中声明ohos.permission.LOCATION和ohos.permission.APPROXIMATELY_LOCATION。

  2. 使用has.authorize()申请scope.userLocation授权。

参数：

参数为Object对象，包括以下字段。

展开
参数 类型 默认值 必填 描述
type string wgs84 否

- wgs84：返回gps坐标。

- gcj02：返回国测局坐标。
altitude boolean false 否 传入 true 会返回高度信息，由于获取高度需要较高精确度，会减慢接口返回速度。
isHighAccuracy boolean false 否 开启高精度定位。
highAccuracyExpireTime number - 否 高精度定位超时时间(ms)，指定时间内返回最高精度，该值3000ms以上高精度定位才有效果。
success function - 否 接口调用成功的回调函数。
fail function - 否 接口调用失败的回调函数。
complete function - 否 接口调用结束的回调函数（调用成功、失败都会执行）。

success返回值：

展开
参数 类型 描述
latitude number 纬度，范围为-90~90，负数表示南纬，根据type参数确定使用坐标。
longitude number 经度，范围为-180~180，负数表示西经，根据type参数确定使用坐标。
speed number 速度，单位：m/s。
accuracy number 位置的精确度，反映与真实位置之间的接近程度，可以理解成：10，即与真实位置相差10m，越小越精确。
altitude number 高度，单位：m。
verticalAccuracy number 垂直精度，单位：m。

示例：

收起
自动换行
深色代码主题
复制
  1. has.authorize({
  2.   scope: 'scope.userLocation',
  3.   success: () => {
  4.     has.getLocation({
  5.       type: 'wgs84',
  6.       success: (res) => {
  7.         console.info('getLocation success', res);
  8.       },
  9.       fail: (err) => {
  10.         console.error('getLocation fail', err);
  11.       },
  12.       complete: (res) => {
  13.         console.info('getLocation complete', res);
  14.       }
  15.     });
  16.   }
  17. });

has.getFuzzyLocation

has.getFuzzyLocation(Object object)

获取当前的模糊地理位置。

起始版本： 1.0.0

需要权限：

  1. 在module.json5中声明ohos.permission.APPROXIMATELY_LOCATION。

  2. 使用has.authorize()申请scope.userFuzzyLocation授权。

参数：

参数为Object对象，包括以下字段。

展开
参数 类型 默认值 必填 描述
type string wgs84 否 wgs84返回gps坐标，gcj02 返回国测局坐标。
success function - 否 接口调用成功的回调函数。
fail function - 否 接口调用失败的回调函数。
complete function - 否 接口调用结束的回调函数（调用成功、失败都会执行）。

success返回值：

展开
参数 类型 描述
latitude number 纬度，范围为-90~90，负数表示南纬，根据type参数确定使用坐标。
longitude number 经度，范围为-180~180，负数表示西经，根据type参数确定使用坐标。

示例：

收起
自动换行
深色代码主题
复制
  1. has.authorize({
  2.   scope: 'scope.userFuzzyLocation',
  3.   success: () => {
  4.     has.getFuzzyLocation({
  5.       type: 'wgs84',
  6.       success: (res) => {
  7.         console.info('getFuzzyLocation success', res);
  8.       },
  9.       fail: (err) => {
  10.         console.error('getFuzzyLocation fail', err);
  11.       },
  12.       complete: (res) => {
  13.         console.info('getFuzzyLocation complete', res);
  14.       }
  15.     })
  16.   }
  17. });

has.chooseLocation

has.chooseLocation(Object object)

打开地图选择位置。

使用前，需参考开发准备完成基本准备工作。

起始版本： 1.0.0

参数：

参数为Object对象，包括以下字段。

展开
参数 类型 必填 描述
latitude number 否

目标地纬度。

注：中国大陆、港澳地区，请使用gcj02，其他地区请使用wgs84。
longitude number 否

目标地经度。

注：中国大陆、港澳地区，请使用gcj02，其他地区请使用wgs84。
success function 否 接口调用成功的回调函数。
fail function 否 接口调用失败的回调函数。
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）。

success返回值：

展开
参数 类型 描述
name string 位置名称。
address string 详细地址。
countryCode string 国家/地区码。
countryName string 国家名。
latitude number

纬度，范围为-90~90，负数表示南纬。

注：中国大陆、港澳地区，请使用gcj02，其他地区请使用 wgs84。
longitude number

经度，范围为-180~180，负数表示西经。

注：中国大陆、港澳地区，请使用gcj02，其他地区请使用 wgs84。

示例：

收起
自动换行
深色代码主题
复制
  1. has.chooseLocation({
  2.   longitude: 114.52845090013192,
  3.   latitude: 30.497287768914163,
  4.   success: (res) => {
  5.     console.info('chooseLocation success', res);
  6.   },
  7.   fail: (err) => {
  8.     console.error('chooseLocation fail', err);
  9.   },
  10.   complete: (res) => {
  11.     console.info('chooseLocation complete', res);
  12.   }
  13. });

has.startLocationUpdate

has.startLocationUpdate(Object object)

开启元服务进入前台时接收位置消息。

起始版本： 1.0.15

需要权限：

  1. 在module.json5中声明ohos.permission.APPROXIMATELY_LOCATION。

  2. 使用has.authorize()申请scope.userFuzzyLocation授权。

参数：

参数为Object对象，包括以下字段。

展开
参数 类型 默认值 必填 描述
type string gcj02 否 wgs84 返回 gps 坐标，gcj02 返回可用于 has.openLocation 的坐标。
success function - 否 接口调用成功的回调函数。
fail function - 否 接口调用失败的回调函数。
complete function - 否 接口调用结束的回调函数（调用成功、失败都会执行）。

示例：

收起
自动换行
深色代码主题
复制
  1. has.startLocationUpdate({
  2.   success: () => {
  3.     console.info('startLocationUpdate success');
  4.   },
  5.   fail: (err) => {
  6.     console.error('startLocationUpdate fail', err);
  7.   },
  8.   complete: (res) => {
  9.     console.info('startLocationUpdate complete', res);
  10.   }
  11. });

has.startLocationUpdateBackground

has.startLocationUpdateBackground(Object object)

开启元服务在前后台时均可接收位置消息。

起始版本： 1.0.15

需要权限：

  1. 在module.json5中声明ohos.permission.APPROXIMATELY_LOCATION。

  2. 使用has.authorize()申请scope.userFuzzyLocation授权。

  3. 开启后台定位，需要在module.json5中声明backgroundModes配置项：

    收起
    自动换行
    深色代码主题
    复制
    1. "module": {
    2.   "abilities": [
    3.     {
    4.       "backgroundModes": [
    5.         "location"
    6.       ]
    7.     }
    8.   ]
    9. }

参数：

参数为Object对象，包括以下字段。

展开
参数 类型 默认值 必填 描述
type string gcj02 否 wgs84返回gps坐标，gcj02返回可用于has.openLocation的坐标。
success function - 否 接口调用成功的回调函数。
fail function - 否 接口调用失败的回调函数。
complete function - 否 接口调用结束的回调函数（调用成功、失败都会执行）。

示例：

收起
自动换行
深色代码主题
复制
  1. has.startLocationUpdateBackground({
  2.   success: () => {
  3.     console.info('startLocationUpdateBackground success');
  4.   },
  5.   fail: (err) => {
  6.     console.error('startLocationUpdateBackground fail', err);
  7.   },
  8.   complete: (res) => {
  9.     console.info('startLocationUpdateBackground complete', res);
  10.   }
  11. });

has.stopLocationUpdate

has.stopLocationUpdate(Object object)

关闭监听实时位置变化，前后台都停止消息接收。

起始版本： 1.0.15

参数：

参数为Object对象，包括以下字段。

展开
参数 类型 必填 描述
success function 否 接口调用成功的回调函数。
fail function 否 接口调用失败的回调函数。
complete function 否 接口调用结束的回调函数（调用成功、失败都会执行）。

示例：

收起
自动换行
深色代码主题
复制
  1. has.stopLocationUpdate({
  2.   success: () => {
  3.     console.info('stopLocationUpdate success');
  4.   },
  5.   fail: (err) => {
  6.     console.error('stopLocationUpdate fail', err);
  7.   },
  8.   complete: (res) => {
  9.     console.info('stopLocationUpdate complete', res);
  10.   }
  11. });

has.onLocationChange

has.onLocationChange(function callback)

监听实时地理位置变化事件，需结合has.startLocationUpdateBackground、has.startLocationUpdate使用。

起始版本： 1.0.15

参数：

展开
参数 类型 必填 描述
callback function 是 实时地理位置变化事件的监听函数。

callback返回值：

Object类型，包括以下字段。

展开
参数 类型 描述
latitude number 纬度，范围为-90~90，负数表示南纬。使用gcj02国测局坐标系。
longitude number 经度，范围为-180~180，负数表示西经。使用gcj02国测局坐标系。
speed number 速度，单位：m/s。
accuracy number 位置的精确度。
altitude number 高度，单位：m。
verticalAccuracy number 垂直精度，单位：m。
horizontalAccuracy number 水平精度，单位：m。

示例：

收起
自动换行
深色代码主题
复制
  1. const onLocationChangeFn = function(res) {
  2.   console.info('onLocationChange callback triggered', res);
  3. };
  4. has.onLocationChange(onLocationChangeFn);

has.offLocationChange

has.offLocationChange(function callback)

移除实时地理位置变化事件的监听函数。

起始版本： 1.0.15

参数：

展开
参数 类型 必填 描述
callback function 否 has.onLocationChange传入的监听函数，不传此参数则移除所有监听函数。

示例：

收起
自动换行
深色代码主题
复制
  1. const onLocationChangeFn = function(res) {
  2.   console.info('onLocationChange callback triggered', res);
  3. };
  4. has.onLocationChange(onLocationChangeFn);
  5. has.offLocationChange(onLocationChangeFn);
Stats
画布
相关推荐
文档地图
文档设置
文档网络
文档@ohos.geolocation (位置服务)
文档申请位置权限开发指导
文档交互
文档系统信息
文档在地图上实现定位功能
文档授权
文档oh_location.h
简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明
在 ASCF框架 中进行搜索
请输入您想要搜索的关键词