位置服务

2024-01-23 17:34 更新

位置服务提供GNSS定位、网络定位、地理编码、逆地理编码、国家码和地理围栏等基本功能。

说明

本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

申请权限

应用在使用系统能力前,需要检查是否已经获取用户授权访问设备位置信息。如未获得授权,可以向用户申请需要的位置权限,申请方式请参考下文。

系统提供的定位权限有:

  • ohos.permission.LOCATION

  • ohos.permission.APPROXIMATELY_LOCATION

  • ohos.permission.LOCATION_IN_BACKGROUND

访问设备的位置信息,必须申请权限,并且获得用户授权。

API9之前的版本,申请ohos.permission.LOCATION即可。

API9及之后的版本,需要申请ohos.permission.APPROXIMATELY_LOCATION或者同时申请ohos.permission.APPROXIMATELY_LOCATION和ohos.permission.LOCATION;无法单独申请ohos.permission.LOCATION。

使用的API版本

申请位置权限

申请结果

位置的精确度

小于9

ohos.permission.LOCATION

成功

获取到精准位置,精准度在米级别。

大于等于9

ohos.permission.LOCATION

失败

无法获取位置。

大于等于9

ohos.permission.APPROXIMATELY_LOCATION

成功

获取到模糊位置,精确度为5公里。

大于等于9

ohos.permission.APPROXIMATELY_LOCATION和ohos.permission.LOCATION

成功

获取到精准位置,精准度在米级别。

如果应用在后台运行时也需要访问设备位置,除需要将应用声明为允许后台运行外,还必须申请ohos.permission.LOCATION_IN_BACKGROUND权限,这样应用在切入后台之后,系统可以继续上报位置信息。

开发者可以在应用配置文件中声明所需要的权限,具体可参考授权申请指导。

导入模块

  1. import geoLocationManager from '@ohos.geoLocationManager';

ReverseGeoCodeRequest

逆地理编码请求接口。

系统能力:SystemCapability.Location.Location.Geocoder

名称

类型

可读

可写

说明

locale

string

是

是

指定位置描述信息的语言,“zh”代表中文,“en”代表英文。

latitude

number

是

是

表示纬度信息,正值表示北纬,负值表示南纬。取值范围为-90到90。

longitude

number

是

是

表示经度信息,正值表示东经,负值表示西经。取值范围为-180到180。

maxItems

number

是

是

指定返回位置信息的最大个数。取值范围为大于等于0,推荐该值小于10。

GeoCodeRequest

地理编码请求接口。

系统能力:SystemCapability.Location.Location.Geocoder

名称

类型

可读

可写

说明

locale

string

是

是

表示位置描述信息的语言,“zh”代表中文,“en”代表英文。

description

string

是

是

表示位置信息描述,如“上海市浦东新区xx路xx号”。

maxItems

number

是

是

表示返回位置信息的最大个数。取值范围为大于等于0,推荐该值小于10。

minLatitude

number

是

是

表示最小纬度信息,与下面三个参数一起,表示一个经纬度范围。取值范围为-90到90。

minLongitude

number

是

是

表示最小经度信息。取值范围为-180到180。

maxLatitude

number

是

是

表示最大纬度信息。取值范围为-90到90。

maxLongitude

number

是

是

表示最大经度信息。取值范围为-180到180。

GeoAddress

地理编码类型。

系统能力:SystemCapability.Location.Location.Geocoder

名称

类型

可读

可写

说明

latitude

number

是

否

表示纬度信息,正值表示北纬,负值表示南纬。取值范围为-90到90。

longitude

number

是

否

表示经度信息,正值表示东经,负值表是西经。取值范围为-180到180。

locale

string

是

否

表示位置描述信息的语言,“zh”代表中文,“en”代表英文。

placeName

string

是

否

表示地区信息。

countryCode

string

是

否

表示国家码信息。

countryName

string

是

否

表示国家信息。

administrativeArea

string

是

否

表示省份区域信息。

subAdministrativeArea

string

是

否

表示子区域信息。

locality

string

是

否

表示城市信息。

subLocality

string

是

否

表示子城市信息。

roadName

string

是

否

表示路名信息。

subRoadName

string

是

否

表示子路名信息。

premises

string

是

否

表示门牌号信息。

postalCode

string

是

否

表示邮政编码信息。

phoneNumber

string

是

否

表示联系方式信息。

addressUrl

string

是

否

表示位置信息附件的网址信息。

descriptions

Array<string>

是

否

表示附加的描述信息。

descriptionsSize

number

是

否

表示附加的描述信息数量。取值范围为大于等于0,推荐该值小于10。

LocationRequest

位置信息请求类型。

系统能力:SystemCapability.Location.Location.Core

名称

类型

可读

可写

说明

priority

LocationRequestPriority

是

是

表示优先级信息。取值范围见LocationRequestPriority的定义。

scenario

LocationRequestScenario

是

是

表示场景信息。取值范围见LocationRequestScenario的定义。

timeInterval

number

是

是

表示上报位置信息的时间间隔,单位是秒。取值范围为大于0。

distanceInterval

number

是

是

表示上报位置信息的距离间隔。单位是米,取值范围为大于0。

maxAccuracy

number

是

是

表示精度信息。仅在精确位置功能场景下有效,模糊位置功能生效场景下该字段无意义。取值范围为大于0。

CurrentLocationRequest

当前位置信息请求类型。

系统能力:SystemCapability.Location.Location.Core

名称

类型

可读

可写

说明

priority

LocationRequestPriority

是

是

表示优先级信息。取值范围见LocationRequestPriority的定义。

scenario

LocationRequestScenario

是

是

表示场景信息。取值范围见LocationRequestScenario的定义。

maxAccuracy

number

是

是

表示精度信息,单位是米。仅在精确位置功能场景下有效,模糊位置功能生效场景下该字段无意义。取值范围为大于0。

timeoutMs

number

是

是

表示超时时间,单位是毫秒,最小为1000毫秒。取值范围为大于等于1000。

SatelliteStatusInfo

卫星状态信息。

系统能力:SystemCapability.Location.Location.Gnss

名称

类型

可读

可写

说明

satellitesNumber

number

是

否

表示卫星个数。取值范围为大于等于0。

satelliteIds

Array<number>

是

否

表示每个卫星的ID,数组类型。取值范围为大于等于0。

carrierToNoiseDensitys

Array<number>

是

否

表示载波噪声功率谱密度比,即cn0。取值范围为大于0。

altitudes

Array<number>

是

否

表示卫星高度角信息。单位是“度”,取值范围为-90到90。

azimuths

Array<number>

是

否

表示方位角。单位是“度”,取值范围为0到360。

carrierFrequencies

Array<number>

是

否

表示载波频率。单位是Hz,取值范围为大于等于0。

CachedGnssLocationsRequest

请求订阅GNSS缓存位置上报功能接口的配置参数。

系统能力:SystemCapability.Location.Location.Gnss

名称

类型

可读

可写

说明

reportingPeriodSec

number

是

是

表示GNSS缓存位置上报的周期,单位是毫秒。取值范围为大于0。

wakeUpCacheQueueFull

boolean

是

是

true表示GNSS芯片底层缓存队列满之后会主动唤醒AP芯片,并把缓存位置上报给应用。

false表示GNSS芯片底层缓存队列满之后不会主动唤醒AP芯片,会把缓存位置直接丢弃。

Geofence

GNSS围栏的配置参数。目前只支持圆形围栏。

系统能力:SystemCapability.Location.Location.Geofence

名称

类型

可读

可写

说明

latitude

number

是

是

表示纬度。取值范围为-90到90。

longitude

number

是

是

表示经度。取值范围为-180到180。

radius

number

是

是

表示圆形围栏的半径。单位是米,取值范围为大于0。

expiration

number

是

是

围栏存活的时间,单位是毫秒。取值范围为大于0。

GeofenceRequest

请求添加GNSS围栏消息中携带的参数,包括定位优先级、定位场景和围栏信息。

系统能力:SystemCapability.Location.Location.Geofence

名称

类型

可读

可写

说明

scenario

LocationRequestScenario

是

是

表示定位场景。

geofence

Geofence

是

是

表示围栏信息。

LocationCommand

扩展命令结构体。

系统能力:SystemCapability.Location.Location.Core

名称

类型

可读

可写

说明

scenario

LocationRequestScenario

是

是

表示定位场景。

command

string

是

是

扩展命令字符串。

Location

位置信息类型。

系统能力:SystemCapability.Location.Location.Core

名称

类型

可读

可写

说明

latitude

number

是

否

表示纬度信息,正值表示北纬,负值表示南纬。取值范围为-90到90。

longitude

number

是

否

表示经度信息,正值表示东经,负值表是西经。取值范围为-180到180。

altitude

number

是

否

表示高度信息,单位米。

accuracy

number

是

否

表示精度信息,单位米。

speed

number

是

否

表示速度信息,单位米每秒。

timeStamp

number

是

否

表示位置时间戳,UTC格式。

direction

number

是

否

表示航向信息。单位是“度”,取值范围为0到360。

timeSinceBoot

number

是

否

表示位置时间戳,开机时间格式。

additions

Array<string>

是

否

附加信息。

additionSize

number

是

否

附加信息数量。取值范围为大于等于0。

CountryCode

国家码信息结构体,包含国家码字符串和国家码的来源信息。

系统能力:SystemCapability.Location.Location.Core

名称

类型

可读

可写

说明

country

string

是

否

表示国家码字符串。

type

CountryCodeType

是

否

表示国家码信息来源。

LocationRequestPriority

位置请求中位置信息优先级设置。

系统能力:SystemCapability.Location.Location.Core

名称

值

说明

UNSET

0x200

表示未设置优先级,表示LocationRequestPriority无效。

ACCURACY

0x201

表示精度优先。

定位精度优先策略主要以GNSS定位技术为主,在开阔场景下可以提供米级的定位精度,具体性能指标依赖用户设备的定位硬件能力,但在室内等强遮蔽定位场景下,无法提供准确的位置服务。

LOW_POWER

0x202

表示低功耗优先。

低功耗定位优先策略主要使用基站定位和WLAN、蓝牙定位技术,也可以同时提供室内和户外场景下的位置服务,因为其依赖周边基站、可见WLAN、蓝牙设备的分布情况,定位结果的精度波动范围较大,如果对定位结果精度要求不高,或者使用场景多在有基站、可见WLAN、蓝牙设备高密度分布的情况下,推荐使用,可以有效节省设备功耗。

FIRST_FIX

0x203

表示快速获取位置优先,如果应用希望快速拿到一个位置,可以将优先级设置为该字段。

快速定位优先策略会同时使用GNSS定位、基站定位和WLAN、蓝牙定位技术,以便室内和户外场景下,通过此策略都可以获得位置结果,当各种定位技术都有提供位置结果时,系统会选择其中精度较好的结果返回给应用。因为对各种定位技术同时使用,对设备的硬件资源消耗较大,功耗也较大。

LocationRequestScenario

位置请求中定位场景设置。

系统能力:SystemCapability.Location.Location.Core

名称

值

说明

UNSET

0x300

表示未设置场景信息。

表示LocationRequestScenario字段无效。

NAVIGATION

0x301

表示导航场景。

适用于在户外定位设备实时位置的场景,如车载、步行导航。

在此场景下,为保证系统提供位置结果精度最优,主要使用GNSS定位技术提供定位服务

此场景默认以最小1秒间隔上报定位结果。

TRAJECTORY_TRACKING

0x302

表示运动轨迹记录场景。

适用于记录用户位置轨迹的场景,如运动类应用记录轨迹功能。主要使用GNSS定位技术提供定位服务。

此场景默认以最小1秒间隔上报定位结果。

CAR_HAILING

0x303

表示打车场景。

适用于用户出行打车时定位当前位置的场景,如网约车类应用。

此场景默认以最小1秒间隔上报定位结果。

DAILY_LIFE_SERVICE

0x304

表示日常服务使用场景。

适用于不需要定位用户精确位置的使用场景,如新闻资讯、网购、点餐类应用,做推荐、推送时定位用户大致位置即可。

此场景默认以最小1秒间隔上报定位结果。

NO_POWER

0x305

表示无功耗功场景,这种场景下不会主动触发定位,会在其他应用定位时,才给当前应用返回位置。

CountryCodeType

国家码来源类型。

系统能力:SystemCapability.Location.Location.Core

名称

值

说明

COUNTRY_CODE_FROM_LOCALE

1

从全球化模块的语言配置信息中获取到的国家码。

COUNTRY_CODE_FROM_SIM

2

从SIM卡中获取到的国家码。

COUNTRY_CODE_FROM_LOCATION

3

基于用户的位置信息,通过逆地理编码查询到的国家码。

COUNTRY_CODE_FROM_NETWORK

4

从蜂窝网络注册信息中获取到的国家码。

geoLocationManager.on('locationChange')

on(type: 'locationChange', request: LocationRequest, callback: Callback<Location>): void

开启位置变化订阅,并发起定位请求。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“locationChange”,表示位置变化。

request

LocationRequest

是

设置位置请求参数。

callback

Callback<Location>

是

接收位置变化状态变化监听。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301200

Failed to obtain the geographical location.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let requestInfo = {'priority': 0x203, 'scenario': 0x300, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0};
  3. let locationChange = (location) => {
  4. console.log('locationChanger: data: ' + JSON.stringify(location));
  5. };
  6. try {
  7. geoLocationManager.on('locationChange', requestInfo, locationChange);
  8. } catch (err) {
  9. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  10. }

geoLocationManager.off('locationChange')

off(type: 'locationChange', callback?: Callback<Location>): void

关闭位置变化订阅,并删除对应的定位请求。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“locationChange”,表示位置变化。

callback

Callback<Location>

否

需要取消订阅的回调函数。若无此参数,则取消当前类型的所有订阅。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301200

Failed to obtain the geographical location.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let requestInfo = {'priority': 0x203, 'scenario': 0x300, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0};
  3. let locationChange = (location) => {
  4. console.log('locationChanger: data: ' + JSON.stringify(location));
  5. };
  6. try {
  7. geoLocationManager.on('locationChange', requestInfo, locationChange);
  8. geoLocationManager.off('locationChange', locationChange);
  9. } catch (err) {
  10. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  11. }

geoLocationManager.on('locationEnabledChange')

on(type: 'locationEnabledChange', callback: Callback<boolean>): void

订阅位置服务状态变化。

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“locationEnabledChange”,表示位置服务状态。

callback

Callback<boolean>

是

接收位置服务状态变化监听。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let locationEnabledChange = (state) => {
  3. console.log('locationEnabledChange: ' + JSON.stringify(state));
  4. }
  5. try {
  6. geoLocationManager.on('locationEnabledChange', locationEnabledChange);
  7. } catch (err) {
  8. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  9. }

geoLocationManager.off('locationEnabledChange')

off(type: 'locationEnabledChange', callback?: Callback<boolean>): void;

取消订阅位置服务状态变化。

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“locationEnabledChange”,表示位置服务状态。

callback

Callback<boolean>

否

需要取消订阅的回调函数。若无此参数,则取消当前类型的所有订阅。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let locationEnabledChange = (state) => {
  3. console.log('locationEnabledChange: state: ' + JSON.stringify(state));
  4. }
  5. try {
  6. geoLocationManager.on('locationEnabledChange', locationEnabledChange);
  7. geoLocationManager.off('locationEnabledChange', locationEnabledChange);
  8. } catch (err) {
  9. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  10. }

geoLocationManager.on('cachedGnssLocationsChange')

on(type: 'cachedGnssLocationsChange', request: CachedGnssLocationsRequest, callback: Callback<Array<Location>>): void;

订阅缓存GNSS定位结果上报事件。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Gnss

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“cachedGnssLocationsChange”,表示GNSS缓存定位结果上报。

request

CachedGnssLocationsRequest

是

GNSS缓存功能配置参数

callback

Callback<boolean>

是

接收GNSS缓存位置上报。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301200

Failed to obtain the geographical location.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let cachedLocationsCb = (locations) => {
  3. console.log('cachedGnssLocationsChange: locations: ' + JSON.stringify(locations));
  4. }
  5. let requestInfo = {'reportingPeriodSec': 10, 'wakeUpCacheQueueFull': true};
  6. try {
  7. geoLocationManager.on('cachedGnssLocationsChange', requestInfo, cachedLocationsCb);
  8. } catch (err) {
  9. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  10. }

geoLocationManager.off('cachedGnssLocationsChange')

off(type: 'cachedGnssLocationsChange', callback?: Callback<Array<Location>>): void;

取消订阅缓存GNSS定位结果上报事件。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Gnss

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“cachedGnssLocationsChange”,表示GNSS缓存定位结果上报。

callback

Callback<boolean>

否

需要取消订阅的回调函数。若无此参数,则取消当前类型的所有订阅。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301200

Failed to obtain the geographical location.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let cachedLocationsCb = (locations) => {
  3. console.log('cachedGnssLocationsChange: locations: ' + JSON.stringify(locations));
  4. }
  5. let requestInfo = {'reportingPeriodSec': 10, 'wakeUpCacheQueueFull': true};
  6. try {
  7. geoLocationManager.on('cachedGnssLocationsChange', requestInfo, cachedLocationsCb);
  8. geoLocationManager.off('cachedGnssLocationsChange');
  9. } catch (err) {
  10. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  11. }

geoLocationManager.on('satelliteStatusChange')

on(type: 'satelliteStatusChange', callback: Callback<SatelliteStatusInfo>): void;

订阅GNSS卫星状态信息上报事件。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Gnss

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“satelliteStatusChange”,表示订阅GNSS卫星状态信息上报。

callback

Callback<SatelliteStatusInfo>

是

接收GNSS卫星状态信息上报。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let gnssStatusCb = (satelliteStatusInfo) => {
  3. console.log('satelliteStatusChange: ' + JSON.stringify(satelliteStatusInfo));
  4. }
  5. try {
  6. geoLocationManager.on('satelliteStatusChange', gnssStatusCb);
  7. } catch (err) {
  8. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  9. }

geoLocationManager.off('satelliteStatusChange')

off(type: 'satelliteStatusChange', callback?: Callback<SatelliteStatusInfo>): void;

取消订阅GNSS卫星状态信息上报事件。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Gnss

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“satelliteStatusChange”,表示订阅GNSS卫星状态信息上报。

callback

Callback<SatelliteStatusInfo>

否

需要取消订阅的回调函数。若无此参数,则取消当前类型的所有订阅。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let gnssStatusCb = (satelliteStatusInfo) => {
  3. console.log('satelliteStatusChange: ' + JSON.stringify(satelliteStatusInfo));
  4. }
  5. try {
  6. geoLocationManager.on('satelliteStatusChange', gnssStatusCb);
  7. geoLocationManager.off('satelliteStatusChange', gnssStatusCb);
  8. } catch (err) {
  9. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  10. }

geoLocationManager.on('nmeaMessage')

on(type: 'nmeaMessage', callback: Callback<string>): void;

订阅GNSS NMEA信息上报事件。

需要权限:ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Gnss

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“nmeaMessage”,表示订阅GNSS NMEA信息上报。

callback

Callback<string>

是

接收GNSS NMEA信息上报。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let nmeaCb = (str) => {
  3. console.log('nmeaMessage: ' + JSON.stringify(str));
  4. }
  5. try {
  6. geoLocationManager.on('nmeaMessage', nmeaCb );
  7. } catch (err) {
  8. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  9. }

geoLocationManager.off('nmeaMessage')

off(type: 'nmeaMessage', callback?: Callback<string>): void;

取消订阅GNSS NMEA信息上报事件。

需要权限:ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Gnss

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“nmeaMessage”,表示订阅GNSS NMEA信息上报。

callback

Callback<string>

否

需要取消订阅的回调函数。若无此参数,则取消当前类型的所有订阅。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let nmeaCb = (str) => {
  3. console.log('nmeaMessage: ' + JSON.stringify(str));
  4. }
  5. try {
  6. geoLocationManager.on('nmeaMessage', nmeaCb);
  7. geoLocationManager.off('nmeaMessage', nmeaCb);
  8. } catch (err) {
  9. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  10. }

geoLocationManager.on('gnssFenceStatusChange')

on(type: 'gnssFenceStatusChange', request: GeofenceRequest, want: WantAgent): void;

添加一个围栏,并订阅地理围栏事件。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Geofence

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“gnssFenceStatusChange”,表示订阅围栏事件上报。

request

GeofenceRequest

是

围栏的配置参数。

want

WantAgent

是

用于接收地理围栏事件上报(进出围栏)。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301600

Failed to operate the geofence.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. import wantAgent from '@ohos.app.ability.wantAgent';
  3. let wantAgentInfo = {
  4. wants: [
  5. {
  6. bundleName: "com.example.myapplication",
  7. abilityName: "EntryAbility",
  8. action: "action1"
  9. }
  10. ],
  11. operationType: wantAgent.OperationType.START_ABILITY,
  12. requestCode: 0,
  13. wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  14. };
  15. wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
  16. let requestInfo = {'priority': 0x201, 'scenario': 0x301, "geofence": {"latitude": 121, "longitude": 26, "radius": 100, "expiration": 10000}};
  17. try {
  18. geoLocationManager.on('gnssFenceStatusChange', requestInfo, wantAgentObj);
  19. } catch (err) {
  20. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  21. }
  22. });

geoLocationManager.off('gnssFenceStatusChange')

off(type: 'gnssFenceStatusChange', request: GeofenceRequest, want: WantAgent): void;

删除一个围栏,并取消订阅该围栏事件。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Geofence

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“gnssFenceStatusChange”,表示订阅围栏事件上报。

request

GeofenceRequest

是

围栏的配置参数。

want

WantAgent

是

用于接收地理围栏事件上报(进出围栏)。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301600

Failed to operate the geofence.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. import wantAgent from '@ohos.app.ability.wantAgent';
  3. let wantAgentInfo = {
  4. wants: [
  5. {
  6. bundleName: "com.example.myapplication",
  7. abilityName: "EntryAbility",
  8. action: "action1",
  9. }
  10. ],
  11. operationType: wantAgent.OperationType.START_ABILITY,
  12. requestCode: 0,
  13. wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
  14. };
  15. wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
  16. let requestInfo = {'priority': 0x201, 'scenario': 0x301, "geofence": {"latitude": 121, "longitude": 26, "radius": 100, "expiration": 10000}};
  17. try {
  18. geoLocationManager.on('gnssFenceStatusChange', requestInfo, wantAgentObj);
  19. geoLocationManager.off('gnssFenceStatusChange', requestInfo, wantAgentObj);
  20. } catch (err) {
  21. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  22. }
  23. });

geoLocationManager.on('countryCodeChange')

on(type: 'countryCodeChange', callback: Callback<CountryCode>): void;

订阅国家码信息变化事件。

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“countryCodeChange”,表示订阅国家码信息变化事件。

callback

Callback<CountryCode>

是

接收国家码信息上报。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301500

Failed to query the area information.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let callback = (code) => {
  3. console.log('countryCodeChange: ' + JSON.stringify(code));
  4. }
  5. try {
  6. geoLocationManager.on('countryCodeChange', callback);
  7. } catch (err) {
  8. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  9. }

geoLocationManager.off('countryCodeChange')

off(type: 'countryCodeChange', callback?: Callback<CountryCode>): void;

取消订阅国家码变化事件。

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

type

string

是

设置事件类型。type为“countryCodeChange”,表示取消订阅国家码信息变化事件。

callback

Callback<CountryCode>

否

需要取消订阅的回调函数。若无此参数,则取消当前类型的所有订阅。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301500

Failed to query the area information.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let callback = (code) => {
  3. console.log('countryCodeChange: ' + JSON.stringify(code));
  4. }
  5. try {
  6. geoLocationManager.on('countryCodeChange', callback);
  7. geoLocationManager.off('countryCodeChange', callback);
  8. } catch (err) {
  9. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  10. }

geoLocationManager.getCurrentLocation

getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback<Location>): void

获取当前位置,使用callback回调异步返回结果。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

request

CurrentLocationRequest

是

设置位置请求参数。

callback

AsyncCallback<Location>

是

用来接收位置信息的回调。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301200

Failed to obtain the geographical location.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let requestInfo = {'priority': 0x203, 'scenario': 0x300,'maxAccuracy': 0};
  3. let locationChange = (err, location) => {
  4. if (err) {
  5. console.log('locationChanger: err=' + JSON.stringify(err));
  6. }
  7. if (location) {
  8. console.log('locationChanger: location=' + JSON.stringify(location));
  9. }
  10. };
  11. try {
  12. geoLocationManager.getCurrentLocation(requestInfo, locationChange);
  13. } catch (err) {
  14. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  15. }

geoLocationManager.getCurrentLocation

getCurrentLocation(callback: AsyncCallback<Location>): void;

获取当前位置,通过callback方式异步返回结果。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

callback

AsyncCallback<Location>

是

用来接收位置信息的回调。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301200

Failed to obtain the geographical location.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let locationChange = (err, location) => {
  3. if (err) {
  4. console.log('locationChanger: err=' + JSON.stringify(err));
  5. }
  6. if (location) {
  7. console.log('locationChanger: location=' + JSON.stringify(location));
  8. }
  9. };
  10. try {
  11. geoLocationManager.getCurrentLocation(locationChange);
  12. } catch (err) {
  13. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  14. }

geoLocationManager.getCurrentLocation

getCurrentLocation(request?: CurrentLocationRequest): Promise<Location>

获取当前位置,使用Promise方式异步返回结果。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

request

CurrentLocationRequest

否

设置位置请求参数。

返回值:

参数名

类型

必填

说明

Promise<Location>

Location

NA

返回位置信息。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301200

Failed to obtain the geographical location.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let requestInfo = {'priority': 0x203, 'scenario': 0x300,'maxAccuracy': 0};
  3. try {
  4. geoLocationManager.getCurrentLocation(requestInfo).then((result) => {
  5. console.log('current location: ' + JSON.stringify(result));
  6. })
  7. .catch((error) => {
  8. console.log('promise, getCurrentLocation: error=' + JSON.stringify(error));
  9. });
  10. } catch (err) {
  11. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  12. }

geoLocationManager.getLastLocation

getLastLocation(): Location

获取上一次位置。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Core

返回值:

参数名

类型

必填

说明

Location

Location

NA

位置信息。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301200

Failed to obtain the geographical location.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. try {
  3. let location = geoLocationManager.getLastLocation();
  4. } catch (err) {
  5. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  6. }

geoLocationManager.isLocationEnabled

isLocationEnabled(): boolean

判断位置服务是否已经使能。

系统能力:SystemCapability.Location.Location.Core

返回值:

参数名

类型

必填

说明

boolean

boolean

NA

位置服务是否已经使能。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. try {
  3. let locationEnabled = geoLocationManager.isLocationEnabled();
  4. } catch (err) {
  5. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  6. }

geoLocationManager.getAddressesFromLocation

getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback<Array<GeoAddress>>): void

调用逆地理编码服务,将坐标转换为地理描述,使用callback回调异步返回结果。

系统能力:SystemCapability.Location.Location.Geocoder

参数:

参数名

类型

必填

说明

request

ReverseGeoCodeRequest

是

设置逆地理编码请求的相关参数。

callback

AsyncCallback<Array<GeoAddress>>

是

接收逆地理编码结果的回调函数。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301300

Reverse geocoding query failed.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1};
  3. try {
  4. geoLocationManager.getAddressesFromLocation(reverseGeocodeRequest, (err, data) => {
  5. if (err) {
  6. console.log('getAddressesFromLocation: err=' + JSON.stringify(err));
  7. }
  8. if (data) {
  9. console.log('getAddressesFromLocation: data=' + JSON.stringify(data));
  10. }
  11. });
  12. } catch (err) {
  13. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  14. }

geoLocationManager.getAddressesFromLocation

getAddressesFromLocation(request: ReverseGeoCodeRequest): Promise<Array<GeoAddress>>;

调用逆地理编码服务,将坐标转换为地理描述,使用Promise方式异步返回结果。

系统能力:SystemCapability.Location.Location.Geocoder

参数:

参数名

类型

必填

说明

request

ReverseGeoCodeRequest

是

设置逆地理编码请求的相关参数。

返回值:

参数名

类型

必填

说明

Promise<Array<GeoAddress>>

Array<GeoAddress>

NA

返回地理描述信息。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301300

Reverse geocoding query failed.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1};
  3. try {
  4. geoLocationManager.getAddressesFromLocation(reverseGeocodeRequest).then((data) => {
  5. console.log('getAddressesFromLocation: ' + JSON.stringify(data));
  6. })
  7. .catch((error) => {
  8. console.log('promise, getAddressesFromLocation: error=' + JSON.stringify(error));
  9. });
  10. } catch (err) {
  11. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  12. }

geoLocationManager.getAddressesFromLocationName

getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback<Array<GeoAddress>>): void

调用地理编码服务,将地理描述转换为具体坐标,使用callback回调异步返回结果。

系统能力:SystemCapability.Location.Location.Geocoder

参数:

参数名

类型

必填

说明

request

GeoCodeRequest

是

设置地理编码请求的相关参数。

callback

AsyncCallback<Array<GeoAddress>>

是

接收地理编码结果的回调函数。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301400

Geocoding query failed.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let geocodeRequest = {"description": "上海市浦东新区xx路xx号", "maxItems": 1};
  3. try {
  4. geoLocationManager.getAddressesFromLocationName(geocodeRequest, (err, data) => {
  5. if (err) {
  6. console.log('getAddressesFromLocationName: err=' + JSON.stringify(err));
  7. }
  8. if (data) {
  9. console.log('getAddressesFromLocationName: data=' + JSON.stringify(data));
  10. }
  11. });
  12. } catch (err) {
  13. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  14. }

geoLocationManager.getAddressesFromLocationName

getAddressesFromLocationName(request: GeoCodeRequest): Promise<Array<GeoAddress>>

调用地理编码服务,将地理描述转换为具体坐标,使用Promise方式异步返回结果。

系统能力:SystemCapability.Location.Location.Geocoder

参数:

参数名

类型

必填

说明

request

GeoCodeRequest

是

设置地理编码请求的相关参数。

返回值:

参数名

类型

必填

说明

Promise<Array<GeoAddress>>

Array<GeoAddress>

NA

返回地理编码查询结果。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301400

Geocoding query failed.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let geocodeRequest = {"description": "上海市浦东新区xx路xx号", "maxItems": 1};
  3. try {
  4. geoLocationManager.getAddressesFromLocationName(geocodeRequest).then((result) => {
  5. console.log('getAddressesFromLocationName: ' + JSON.stringify(result));
  6. })
  7. .catch((error) => {
  8. console.log('promise, getAddressesFromLocationName: error=' + JSON.stringify(error));
  9. });
  10. } catch (err) {
  11. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  12. }

geoLocationManager.isGeocoderAvailable

isGeocoderAvailable(): boolean;

判断(逆)地理编码服务状态。

系统能力:SystemCapability.Location.Location.Geocoder

返回值:

参数名

类型

必填

说明

boolean

boolean

NA

返回(逆)地理编码服务是否可用。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. try {
  3. let isAvailable = geoLocationManager.isGeocoderAvailable();
  4. } catch (err) {
  5. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  6. }

geoLocationManager.getCachedGnssLocationsSize

getCachedGnssLocationsSize(callback: AsyncCallback<number>): void;

获取GNSS芯片缓存位置的个数。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Gnss

参数:

参数名

类型

必填

说明

callback

AsyncCallback<number>

是

用来接收GNSS芯片缓存位置个数的回调。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. try {
  3. geoLocationManager.getCachedGnssLocationsSize((err, size) => {
  4. if (err) {
  5. console.log('getCachedGnssLocationsSize: err=' + JSON.stringify(err));
  6. }
  7. if (size) {
  8. console.log('getCachedGnssLocationsSize: size=' + JSON.stringify(size));
  9. }
  10. });
  11. } catch (err) {
  12. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  13. }

geoLocationManager.getCachedGnssLocationsSize

getCachedGnssLocationsSize(): Promise<number>;

获取GNSS芯片缓存位置的个数。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Gnss

返回值:

参数名

类型

必填

说明

Promise<number>

number

NA

返回GNSS缓存位置的个数。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. try {
  3. geoLocationManager.getCachedGnssLocationsSize().then((result) => {
  4. console.log('promise, getCachedGnssLocationsSize: ' + JSON.stringify(result));
  5. })
  6. .catch((error) => {
  7. console.log('promise, getCachedGnssLocationsSize: error=' + JSON.stringify(error));
  8. });
  9. } catch (err) {
  10. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  11. }

geoLocationManager.flushCachedGnssLocations

flushCachedGnssLocations(callback: AsyncCallback<void>): void;

读取并清空GNSS芯片所有缓存位置。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Gnss

参数:

参数名

类型

必填

说明

callback

AsyncCallback<void>

是

用来接收错误码信息。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301200

Failed to obtain the geographical location.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. try {
  3. geoLocationManager.flushCachedGnssLocations((err, result) => {
  4. if (err) {
  5. console.log('flushCachedGnssLocations: err=' + JSON.stringify(err));
  6. }
  7. });
  8. } catch (err) {
  9. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  10. }

geoLocationManager.flushCachedGnssLocations

flushCachedGnssLocations(): Promise<void>;

读取并清空GNSS芯片所有缓存位置。

需要权限:ohos.permission.APPROXIMATELY_LOCATION

系统能力:SystemCapability.Location.Location.Gnss

返回值:

参数名

类型

必填

说明

Promise<void>

void

NA

接收错误码。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301100

The location switch is off.

3301200

Failed to obtain the geographical location.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. try {
  3. geoLocationManager.flushCachedGnssLocations().then((result) => {
  4. console.log('promise, flushCachedGnssLocations success');
  5. })
  6. .catch((error) => {
  7. console.log('promise, flushCachedGnssLocations: error=' + JSON.stringify(error));
  8. });
  9. } catch (err) {
  10. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  11. }

geoLocationManager.sendCommand

sendCommand(command: LocationCommand, callback: AsyncCallback<void>): void;

给位置服务子系统的各个部件发送扩展命令。

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

command

LocationCommand

是

指定目标场景,和将要发送的命令(字符串)。

callback

AsyncCallback<void>

是

用来接收错误码。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let requestInfo = {'scenario': 0x301, 'command': "command_1"};
  3. try {
  4. geoLocationManager.sendCommand(requestInfo, (err, result) => {
  5. if (err) {
  6. console.log('sendCommand: err=' + JSON.stringify(err));
  7. }
  8. });
  9. } catch (err) {
  10. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  11. }

geoLocationManager.sendCommand

sendCommand(command: LocationCommand): Promise<void>;

给位置服务子系统的各个部件发送扩展命令。

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

command

LocationCommand

是

指定目标场景,和将要发送的命令(字符串)。

返回值:

参数名

类型

必填

说明

Promise<void>

void

NA

接收错误码。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. let requestInfo = {'scenario': 0x301, 'command': "command_1"};
  3. try {
  4. geoLocationManager.sendCommand(requestInfo).then((result) => {
  5. console.log('promise, sendCommand success');
  6. })
  7. .catch((error) => {
  8. console.log('promise, sendCommand: error=' + JSON.stringify(error));
  9. });
  10. } catch (err) {
  11. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  12. }

geoLocationManager.getCountryCode

getCountryCode(callback: AsyncCallback<CountryCode>): void;

查询当前的国家码。

系统能力:SystemCapability.Location.Location.Core

参数:

参数名

类型

必填

说明

callback

AsyncCallback<CountryCode>

是

用来接收国家码。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301500

Failed to query the area information.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. try {
  3. geoLocationManager.getCountryCode((err, result) => {
  4. if (err) {
  5. console.log('getCountryCode: err=' + JSON.stringify(err));
  6. }
  7. if (result) {
  8. console.log('getCountryCode: result=' + JSON.stringify(result));
  9. }
  10. });
  11. } catch (err) {
  12. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  13. }

geoLocationManager.getCountryCode

getCountryCode(): Promise<CountryCode>;

查询当前的国家码。

系统能力:SystemCapability.Location.Location.Core

返回值:

参数名

类型

必填

说明

Promise<CountryCode>

CountryCode

NA

用来接收国家码。

错误码:

以下错误码的详细介绍请参见位置服务子系统错误码。

错误码ID

错误信息

3301000

Location service is unavailable.

3301500

Failed to query the area information.

示例

  1. import geoLocationManager from '@ohos.geoLocationManager';
  2. try {
  3. geoLocationManager.getCountryCode()
  4. .then((result) => {
  5. console.log('promise, getCountryCode: result=' + JSON.stringify(result));
  6. })
  7. .catch((error) => {
  8. console.log('promise, getCountryCode: error=' + JSON.stringify(error));
  9. });
  10. } catch (err) {
  11. console.error("errCode:" + err.code + ",errMessage:" + err.message);
  12. }
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号