文档中心

@system.geolocation (地理位置)

Wearable18+Lite Wearable12+

更新时间: 2026-08-29 09:41

复制页面

本模块仅提供GNSS定位、网络定位等基本功能。

说明

本模块首批接口从API version 3开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
对于Lite Wearable设备类型，该模块长期维护，正常使用。
对于支持该模块的其他设备类型，该模块从API Version 9开始，该接口不再维护，推荐使用新接口geoLocationManager。

导入模块

收起
自动换行
深色代码主题
复制
import geolocation from '@system.geolocation';

权限列表

ohos.permission.LOCATION

geolocation.getLocation^(deprecated)

Wearable18+Lite Wearable12+

getLocation(options?: GetLocationOption): void

获取设备的地理位置。

说明

除Lite Wearable外，从API version 9开始废弃，建议使用geoLocationManager.getCurrentLocation替代。

需要权限：ohos.permission.LOCATION

系统能力： SystemCapability.Location.Location.Lite

参数：

展开

参数名	类型	必填	说明
options	GetLocationOption	否	单次定位请求的配置参数。

JS示例：

收起
自动换行
深色代码主题
复制
<div class="container">
  <text class="title" style="font-size: {{fontSize}}; color: {{fontColor}};">
    getLocation
  </text>
  <input type="button" value="获取设备的地理位置" style="width: 240px; height: 50px;" onclick="getLocation"></input>
</div>

收起
自动换行
深色代码主题
复制
.container {
  display: flex;
  flex-direction: column;
  align-items: center;
  left: 0px;
  top: 0px;
  width: 454px;
  height: 454px;
}

.title {
  font-size: 100px;
  text-align: center;
  width: 200px;
  height: 100px;
}

.button {
  font-size: 30px;
  text-align: center;
  width: 200px;
  height: 100px;
}

收起
自动换行
深色代码主题
复制
export default {
  getLocation() {
    geolocation.getLocation({
      success: function(data) {
        console.info('success get location data. latitude:' + data.latitude);
      },
      fail: function(data, code) {
        console.info('fail to get location. code:' + code + ', data:' + data);
      }
    });
  },
}

geolocation.getLocationType^(deprecated)

Wearable18+Lite Wearable12+

getLocationType(options?: GetLocationTypeOption): void

获取当前设备支持的定位类型。

说明

除Lite Wearable外，从API version 9开始废弃。位置服务子系统仅支持gnss和network两种定位类型，后续不再提供接口查询支持的定位类型。

系统能力： SystemCapability.Location.Location.Lite

参数：

展开

参数名	类型	必填	说明
options	GetLocationTypeOption	否	回调函数，用于接收查询结果，或者接收查询失败的结果。

JS示例：

收起
自动换行
深色代码主题
复制
<div class="container">
  <text class="title" style="font-size: {{fontSize}}; color: {{fontColor}};">
    getLocationType
  </text>
  <input type="button" value="获取当前设备支持的定位类型" style="width: 240px; height: 50px;" onclick="getLocationType"></input>
</div>

收起
自动换行
深色代码主题
复制
.container {
  display: flex;
  flex-direction: column;
  align-items: center;
  left: 0px;
  top: 0px;
  width: 454px;
  height: 454px;
}

.title {
  font-size: 100px;
  text-align: center;
  width: 200px;
  height: 100px;
}

.button {
  font-size: 30px;
  text-align: center;
  width: 200px;
  height: 100px;
}

收起
自动换行
深色代码主题
复制
export default {
  getLocationType() {
    geolocation.getLocationType({
      success: function(data) {
        console.info('success get location type:' + data.types[0]);
      },
      fail: function(data, code) {
        console.info('fail to get location. code:' + code + ', data:' + data);
       },
     });
  },
}

geolocation.subscribe^(deprecated)

Wearable18+Lite Wearable12+

subscribe(options: SubscribeLocationOption): void

订阅设备的地理位置信息。多次调用的话，只有最后一次的调用生效。

说明

除Lite Wearable外，从API version 9开始废弃，建议使用geoLocationManager.on('locationChange')替代。

需要权限：ohos.permission.LOCATION

系统能力： SystemCapability.Location.Location.Lite

参数：

展开

参数名	类型	必填	说明
options	SubscribeLocationOption	是	持续定位的配置参数。

JS示例：

收起
自动换行
深色代码主题
复制
<div class="container">
  <text class="title" style="font-size: {{fontSize}}; color: {{fontColor}};">
    subscribe
  </text>
  <input type="button" value="订阅设备的地理位置信息" style="width: 240px; height: 50px;" onclick="subscribe"></input>
</div>

收起
自动换行
深色代码主题
复制
.container {
  display: flex;
  flex-direction: column;
  align-items: center;
  left: 0px;
  top: 0px;
  width: 454px;
  height: 454px;
}

.title {
  font-size: 100px;
  text-align: center;
  width: 200px;
  height: 100px;
}

.button {
  font-size: 30px;
  text-align: center;
  width: 200px;
  height: 100px;
}

收起
自动换行
深色代码主题
复制
export default {
  subscribe() {
    geolocation.subscribe({
      success: function(data) {
        console.info('get location. latitude:' + data.latitude);
      },
      fail: function(data, code) {
        console.info('fail to get location. code:' + code + ', data:' + data);
      },
    });
  },
}

geolocation.unsubscribe^(deprecated)

Wearable18+Lite Wearable12+

unsubscribe(): void

取消订阅设备的地理位置信息。

说明

除Lite Wearable外，从API version 9开始废弃，建议使用geoLocationManager.off('locationChange')替代。

需要权限：ohos.permission.LOCATION

系统能力： SystemCapability.Location.Location.Lite

JS示例：

收起
自动换行
深色代码主题
复制
<div class="container">
  <text class="title" style="font-size: {{fontSize}}; color: {{fontColor}};">
    unsubscribe
  </text>
  <input type="button" value="取消订阅设备的地理位置信息" style="width: 240px; height: 50px;" onclick="unsubscribe"></input>
</div>

收起
自动换行
深色代码主题
复制
.container {
  display: flex;
  flex-direction: column;
  align-items: center;
  left: 0px;
  top: 0px;
  width: 454px;
  height: 454px;
}

.title {
  font-size: 100px;
  text-align: center;
  width: 200px;
  height: 100px;
}

.button {
  font-size: 30px;
  text-align: center;
  width: 200px;
  height: 100px;
}

收起
自动换行
深色代码主题
复制
export default {
  unsubscribe() {
    geolocation.unsubscribe();
  },
}

geolocation.getSupportedCoordTypes^(deprecated)

Wearable18+Lite Wearable12+

getSupportedCoordTypes(): Array<string>

获取设备支持的坐标系类型。

说明

除Lite Wearable外，从API version 9开始废弃。位置服务子系统仅支持WGS-84坐标系，后续不再提供接口查询支持的坐标系类型。

系统能力： SystemCapability.Location.Location.Lite

返回值：

展开

类型	非空	说明
Array<string>	是	表示坐标系类型，如[wgs84, gcj02]。

JS示例：

收起
自动换行
深色代码主题
复制
<div class="container">
  <text class="title" style="font-size: {{fontSize}}; color: {{fontColor}};">
    getSupportedCoordTypes
  </text>
  <input type="button" value="获取设备支持的坐标系类型" style="width: 240px; height: 50px;" onclick="getSupportedCoordTypes"></input>
</div>

收起
自动换行
深色代码主题
复制
.container {
  display: flex;
  flex-direction: column;
  align-items: center;
  left: 0px;
  top: 0px;
  width: 454px;
  height: 454px;
}

.title {
  font-size: 100px;
  text-align: center;
  width: 200px;
  height: 100px;
}

.button {
  font-size: 30px;
  text-align: center;
  width: 200px;
  height: 100px;
}

收起
自动换行
深色代码主题
复制
export default {
  getSupportedCoordTypes() {
    var types = geolocation.getSupportedCoordTypes();
    console.info('getSupportedCoordTypes:' types);
  },
}

GetLocationOption^(deprecated)

Wearable18+Lite Wearable12+

单次定位请求的配置参数。

说明

除Lite Wearable外，从API version 9开始废弃，建议使用geoLocationManager.CurrentLocationRequest替代。

需要权限：ohos.permission.LOCATION

系统能力：SystemCapability.Location.Location.Lite

展开

名称	类型	必填	说明
timeout	number	否	超时时间，单位为ms，默认值为30000。设置超时，是为了防止出现权限被系统拒绝、定位信号弱或者定位设置不当，导致请求阻塞的情况。超时后会使用fail回调函数。取值范围为32位正整数。如果设置值小于等于0，系统按默认值处理。
coordType	string	否	坐标系的类型，可通过getSupportedCoordTypes获取可选值，缺省值为wgs84。
success	(data: GeolocationResponse) => void	否	接口调用成功的回调函数。
fail	(data: string, code: number) => void	否	接口调用失败的回调函数。data为错误信息，code为错误码。
complete	() => void	否	接口调用结束的回调函数。

fail返回错误代码：

展开

错误码	说明
601	获取定位权限失败，失败原因：用户拒绝。
602	权限未声明。
800	超时，失败原因：网络状况不佳或GNSS不可用。
801	系统位置开关未打开。
802	该次调用结果未返回前接口又被重新调用，该次调用失败返回错误码。

GeolocationResponse^(deprecated)

Wearable18+Lite Wearable12+

位置信息，包含经度、纬度、定位精度等信息。

说明

除Lite Wearable外，从API version 9开始废弃，建议使用geoLocationManager.Location替代。

系统能力：SystemCapability.Location.Location.Lite

展开

名称	类型	只读	可选	说明
longitude	number	否	否	设备位置信息：经度。
latitude	number	否	否	设备位置信息：纬度。
altitude	number	否	否	设备位置信息：海拔。
accuracy	number	否	否	设备位置信息：精确度。（该字段由GNSS定位芯片或网络定位服务提供，如果不支持该功能则返回默认值0。Wearable设备上该字段有效；Lite Wearable设备上该字段无效，返回默认值0。）
time	number	否	否	设备位置信息：时间。

GetLocationTypeOption^(deprecated)

Wearable18+Lite Wearable12+

查询定位类型接口的入参，用于存放回调函数，在查询成功或者失败时接收查询结果。

说明

除Lite Wearable外，从API version 9开始废弃。

系统能力：SystemCapability.Location.Location.Lite

展开

名称	类型	必填	说明
success	(data: GetLocationTypeResponse) => void	否	接口调用成功的回调函数。
fail	(data: string, code: number) => void	否	接口调用失败的回调函数。
complete	() => void	否	接口调用结束的回调函数。

GetLocationTypeResponse^(deprecated)

Wearable18+Lite Wearable12+

当前设备支持的定位类型列表

说明

除Lite Wearable外，从API version 9开始废弃。

系统能力：SystemCapability.Location.Location.Lite

展开

名称	类型	只读	可选	说明
types	Array<string>	否	否	可选的定位类型['gps', 'network']。

SubscribeLocationOption^(deprecated)

Wearable18+Lite Wearable12+

持续定位请求的配置参数。

说明

除Lite Wearable外，从API version 9开始废弃，建议使用geoLocationManager.CurrentLocationRequest替代。

需要权限：ohos.permission.LOCATION

系统能力：SystemCapability.Location.Location.Lite

展开

名称	类型	必填	说明
coordType	string	否	坐标系的类型，可通过getSupportedCoordTypes获取可选值，默认值为wgs84。
success	(data: GeolocationResponse) => void	是	位置信息发生变化的回调函数。
fail	(data: string, code: number) => void	否	接口调用失败的回调函数。

fail返回错误代码：

展开

错误码	说明
601	获取定位权限失败，失败原因：用户拒绝。
602	权限未声明。
801	系统位置开关未打开。

@system.geolocation (地理位置)

导入模块

权限列表

geolocation.getLocation(deprecated)

geolocation.getLocationType(deprecated)

geolocation.subscribe(deprecated)

geolocation.unsubscribe(deprecated)

geolocation.getSupportedCoordTypes(deprecated)

GetLocationOption(deprecated)

GeolocationResponse(deprecated)

GetLocationTypeOption(deprecated)

GetLocationTypeResponse(deprecated)

SubscribeLocationOption(deprecated)

geolocation.getLocation^(deprecated)

geolocation.getLocationType^(deprecated)

geolocation.subscribe^(deprecated)

geolocation.unsubscribe^(deprecated)

geolocation.getSupportedCoordTypes^(deprecated)

GetLocationOption^(deprecated)

GeolocationResponse^(deprecated)

GetLocationTypeOption^(deprecated)

GetLocationTypeResponse^(deprecated)

SubscribeLocationOption^(deprecated)