位置服務

申請權限

應用在使用系統(tǒng)能力前，需要檢查是否已經(jīng)獲取用戶授權訪問設備位置信息。如未獲得授權，可以向用戶申請需要的位置權限，申請方式請參考下文。

系統(tǒng)提供的定位權限有：

• 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。

如果應用在后臺運行時也需要訪問設備位置，除需要將應用聲明為允許后臺運行外，還必須申請ohos.permission.LOCATION_IN_BACKGROUND權限，這樣應用在切入后臺之后，系統(tǒng)可以繼續(xù)上報位置信息。

開發(fā)者可以在應用配置文件中聲明所需要的權限，具體可參考授權申請指導。

導入模塊

import geoLocationManager from '@ohos.geoLocationManager';

ReverseGeoCodeRequest

逆地理編碼請求接口。

系統(tǒng)能力：SystemCapability.Location.Location.Geocoder

GeoCodeRequest

地理編碼請求接口。

系統(tǒng)能力：SystemCapability.Location.Location.Geocoder

GeoAddress

地理編碼類型。

系統(tǒng)能力：SystemCapability.Location.Location.Geocoder

LocationRequest

位置信息請求類型。

系統(tǒng)能力：SystemCapability.Location.Location.Core

CurrentLocationRequest

當前位置信息請求類型。

系統(tǒng)能力：SystemCapability.Location.Location.Core

SatelliteStatusInfo

衛(wèi)星狀態(tài)信息。

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

CachedGnssLocationsRequest

請求訂閱GNSS緩存位置上報功能接口的配置參數(shù)。

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

Geofence

GNSS圍欄的配置參數(shù)。目前只支持圓形圍欄。

系統(tǒng)能力：SystemCapability.Location.Location.Geofence

GeofenceRequest

請求添加GNSS圍欄消息中攜帶的參數(shù)，包括定位優(yōu)先級、定位場景和圍欄信息。

系統(tǒng)能力：SystemCapability.Location.Location.Geofence

LocationCommand

擴展命令結構體。

系統(tǒng)能力：SystemCapability.Location.Location.Core

Location

位置信息類型。

系統(tǒng)能力：SystemCapability.Location.Location.Core

CountryCode

國家碼信息結構體，包含國家碼字符串和國家碼的來源信息。

系統(tǒng)能力：SystemCapability.Location.Location.Core

LocationRequestPriority

位置請求中位置信息優(yōu)先級設置。

系統(tǒng)能力：SystemCapability.Location.Location.Core

LocationRequestScenario

位置請求中定位場景設置。

系統(tǒng)能力：SystemCapability.Location.Location.Core

CountryCodeType

國家碼來源類型。

系統(tǒng)能力：SystemCapability.Location.Location.Core

geoLocationManager.on('locationChange')

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

開啟位置變化訂閱，并發(fā)起定位請求。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

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

geoLocationManager.off('locationChange')

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

關閉位置變化訂閱，并刪除對應的定位請求。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

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

geoLocationManager.on('locationEnabledChange')

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

訂閱位置服務狀態(tài)變化。

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let locationEnabledChange = (state) => {
    console.log('locationEnabledChange: ' + JSON.stringify(state));
}
try {
    geoLocationManager.on('locationEnabledChange', locationEnabledChange);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.off('locationEnabledChange')

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

取消訂閱位置服務狀態(tài)變化。

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let locationEnabledChange = (state) => {
    console.log('locationEnabledChange: state: ' + JSON.stringify(state));
}
try {
    geoLocationManager.on('locationEnabledChange', locationEnabledChange);
    geoLocationManager.off('locationEnabledChange', locationEnabledChange);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.on('cachedGnssLocationsChange')

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

訂閱緩存GNSS定位結果上報事件。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

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

geoLocationManager.off('cachedGnssLocationsChange')

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

取消訂閱緩存GNSS定位結果上報事件。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

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

geoLocationManager.on('satelliteStatusChange')

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

訂閱GNSS衛(wèi)星狀態(tài)信息上報事件。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let gnssStatusCb = (satelliteStatusInfo) => {
    console.log('satelliteStatusChange: ' + JSON.stringify(satelliteStatusInfo));
}

try {
    geoLocationManager.on('satelliteStatusChange', gnssStatusCb);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.off('satelliteStatusChange')

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

取消訂閱GNSS衛(wèi)星狀態(tài)信息上報事件。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let gnssStatusCb = (satelliteStatusInfo) => {
    console.log('satelliteStatusChange: ' + JSON.stringify(satelliteStatusInfo));
}
try {
    geoLocationManager.on('satelliteStatusChange', gnssStatusCb);
    geoLocationManager.off('satelliteStatusChange', gnssStatusCb);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.on('nmeaMessage')

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

訂閱GNSS NMEA信息上報事件。

需要權限：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let nmeaCb = (str) => {
    console.log('nmeaMessage: ' + JSON.stringify(str));
}

try {
    geoLocationManager.on('nmeaMessage', nmeaCb );
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.off('nmeaMessage')

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

取消訂閱GNSS NMEA信息上報事件。

需要權限：ohos.permission.LOCATION 和 ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let nmeaCb = (str) => {
    console.log('nmeaMessage: ' + JSON.stringify(str));
}

try {
    geoLocationManager.on('nmeaMessage', nmeaCb);
    geoLocationManager.off('nmeaMessage', nmeaCb);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.on('gnssFenceStatusChange')

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

添加一個圍欄，并訂閱地理圍欄事件。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Geofence

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
import wantAgent from '@ohos.app.ability.wantAgent';

let wantAgentInfo = {
    wants: [
        {
            bundleName: "com.example.myapplication",
            abilityName: "EntryAbility",
            action: "action1"
        }
    ],
    operationType: wantAgent.OperationType.START_ABILITY,
    requestCode: 0,
    wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
};

wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
  let requestInfo = {'priority': 0x201, 'scenario': 0x301, "geofence": {"latitude": 121, "longitude": 26, "radius": 100, "expiration": 10000}};
  try {
      geoLocationManager.on('gnssFenceStatusChange', requestInfo, wantAgentObj);
  } catch (err) {
      console.error("errCode:" + err.code + ",errMessage:" + err.message);
  }
});

geoLocationManager.off('gnssFenceStatusChange')

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

刪除一個圍欄，并取消訂閱該圍欄事件。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Geofence

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
import wantAgent from '@ohos.app.ability.wantAgent';

let wantAgentInfo = {
    wants: [
        {
            bundleName: "com.example.myapplication",
            abilityName: "EntryAbility",
            action: "action1",
        }
    ],
    operationType: wantAgent.OperationType.START_ABILITY,
    requestCode: 0,
    wantAgentFlags: [wantAgent.WantAgentFlags.UPDATE_PRESENT_FLAG]
};

wantAgent.getWantAgent(wantAgentInfo).then((wantAgentObj) => {
  let requestInfo = {'priority': 0x201, 'scenario': 0x301, "geofence": {"latitude": 121, "longitude": 26, "radius": 100, "expiration": 10000}};
  try {
      geoLocationManager.on('gnssFenceStatusChange', requestInfo, wantAgentObj);
      geoLocationManager.off('gnssFenceStatusChange', requestInfo, wantAgentObj);
  } catch (err) {
      console.error("errCode:" + err.code + ",errMessage:" + err.message);
  }
});

geoLocationManager.on('countryCodeChange')

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

訂閱國家碼信息變化事件。

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let callback = (code) => {
    console.log('countryCodeChange: ' + JSON.stringify(code));
}

try {
    geoLocationManager.on('countryCodeChange', callback);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.off('countryCodeChange')

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

取消訂閱國家碼變化事件。

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let callback = (code) => {
    console.log('countryCodeChange: ' + JSON.stringify(code));
}

try {
    geoLocationManager.on('countryCodeChange', callback);
    geoLocationManager.off('countryCodeChange', callback);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.getCurrentLocation

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

獲取當前位置，使用callback回調異步返回結果。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let requestInfo = {'priority': 0x203, 'scenario': 0x300,'maxAccuracy': 0};
let locationChange = (err, location) => {
    if (err) {
        console.log('locationChanger: err=' + JSON.stringify(err));
    }
    if (location) {
        console.log('locationChanger: location=' + JSON.stringify(location));
    }
};

try {
    geoLocationManager.getCurrentLocation(requestInfo, locationChange);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.getCurrentLocation

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

獲取當前位置，通過callback方式異步返回結果。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let locationChange = (err, location) => {
    if (err) {
        console.log('locationChanger: err=' + JSON.stringify(err));
    }
    if (location) {
        console.log('locationChanger: location=' + JSON.stringify(location));
    }
};

try {
    geoLocationManager.getCurrentLocation(locationChange);
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.getCurrentLocation

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

獲取當前位置，使用Promise方式異步返回結果。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let requestInfo = {'priority': 0x203, 'scenario': 0x300,'maxAccuracy': 0};
try {
    geoLocationManager.getCurrentLocation(requestInfo).then((result) => {
        console.log('current location: ' + JSON.stringify(result));
    })  
    .catch((error) => {
        console.log('promise, getCurrentLocation: error=' + JSON.stringify(error));
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.getLastLocation

getLastLocation(): Location

獲取上一次位置。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Core

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

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

geoLocationManager.isLocationEnabled

isLocationEnabled(): boolean

判斷位置服務是否已經(jīng)使能。

系統(tǒng)能力：SystemCapability.Location.Location.Core

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

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

geoLocationManager.getAddressesFromLocation

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

調用逆地理編碼服務，將坐標轉換為地理描述，使用callback回調異步返回結果。

系統(tǒng)能力：SystemCapability.Location.Location.Geocoder

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1};
try {
    geoLocationManager.getAddressesFromLocation(reverseGeocodeRequest, (err, data) => {
        if (err) {
            console.log('getAddressesFromLocation: err=' + JSON.stringify(err));
        }
        if (data) {
            console.log('getAddressesFromLocation: data=' + JSON.stringify(data));
        }
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.getAddressesFromLocation

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

調用逆地理編碼服務，將坐標轉換為地理描述，使用Promise方式異步返回結果。

系統(tǒng)能力：SystemCapability.Location.Location.Geocoder

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1};
try {
    geoLocationManager.getAddressesFromLocation(reverseGeocodeRequest).then((data) => {
        console.log('getAddressesFromLocation: ' + JSON.stringify(data));
    })
    .catch((error) => {
        console.log('promise, getAddressesFromLocation: error=' + JSON.stringify(error));
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.getAddressesFromLocationName

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

調用地理編碼服務，將地理描述轉換為具體坐標，使用callback回調異步返回結果。

系統(tǒng)能力：SystemCapability.Location.Location.Geocoder

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let geocodeRequest = {"description": "上海市浦東新區(qū)xx路xx號", "maxItems": 1};
try {
    geoLocationManager.getAddressesFromLocationName(geocodeRequest, (err, data) => {
        if (err) {
            console.log('getAddressesFromLocationName: err=' + JSON.stringify(err));
        }
        if (data) {
            console.log('getAddressesFromLocationName: data=' + JSON.stringify(data));
        }
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.getAddressesFromLocationName

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

調用地理編碼服務，將地理描述轉換為具體坐標，使用Promise方式異步返回結果。

系統(tǒng)能力：SystemCapability.Location.Location.Geocoder

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let geocodeRequest = {"description": "上海市浦東新區(qū)xx路xx號", "maxItems": 1};
try {
    geoLocationManager.getAddressesFromLocationName(geocodeRequest).then((result) => {
        console.log('getAddressesFromLocationName: ' + JSON.stringify(result));
    })
    .catch((error) => {
        console.log('promise, getAddressesFromLocationName: error=' + JSON.stringify(error));
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.isGeocoderAvailable

isGeocoderAvailable(): boolean;

判斷（逆）地理編碼服務狀態(tài)。

系統(tǒng)能力：SystemCapability.Location.Location.Geocoder

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

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

geoLocationManager.getCachedGnssLocationsSize

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

獲取GNSS芯片緩存位置的個數(shù)。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
try {
    geoLocationManager.getCachedGnssLocationsSize((err, size) => {
        if (err) {
            console.log('getCachedGnssLocationsSize: err=' + JSON.stringify(err));
        }
        if (size) {
            console.log('getCachedGnssLocationsSize: size=' + JSON.stringify(size));
        }
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.getCachedGnssLocationsSize

getCachedGnssLocationsSize(): Promise<number>;

獲取GNSS芯片緩存位置的個數(shù)。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
try {
    geoLocationManager.getCachedGnssLocationsSize().then((result) => {
        console.log('promise, getCachedGnssLocationsSize: ' + JSON.stringify(result));
    }) 
    .catch((error) => {
        console.log('promise, getCachedGnssLocationsSize: error=' + JSON.stringify(error));
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.flushCachedGnssLocations

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

讀取并清空GNSS芯片所有緩存位置。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
try {
    geoLocationManager.flushCachedGnssLocations((err, result) => {
        if (err) {
            console.log('flushCachedGnssLocations: err=' + JSON.stringify(err));
        }
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.flushCachedGnssLocations

flushCachedGnssLocations(): Promise<void>;

讀取并清空GNSS芯片所有緩存位置。

需要權限：ohos.permission.APPROXIMATELY_LOCATION

系統(tǒng)能力：SystemCapability.Location.Location.Gnss

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
try {
    geoLocationManager.flushCachedGnssLocations().then((result) => {
        console.log('promise, flushCachedGnssLocations success');
    })
    .catch((error) => {
        console.log('promise, flushCachedGnssLocations: error=' + JSON.stringify(error));
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.sendCommand

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

給位置服務子系統(tǒng)的各個部件發(fā)送擴展命令。

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let requestInfo = {'scenario': 0x301, 'command': "command_1"};
try {
    geoLocationManager.sendCommand(requestInfo, (err, result) => {
        if (err) {
            console.log('sendCommand: err=' + JSON.stringify(err));
        }
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.sendCommand

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

給位置服務子系統(tǒng)的各個部件發(fā)送擴展命令。

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
let requestInfo = {'scenario': 0x301, 'command': "command_1"};
try {
    geoLocationManager.sendCommand(requestInfo).then((result) => {
        console.log('promise, sendCommand success');
    })  
    .catch((error) => {
        console.log('promise, sendCommand: error=' + JSON.stringify(error));
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.getCountryCode

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

查詢當前的國家碼。

系統(tǒng)能力：SystemCapability.Location.Location.Core

參數(shù)：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
try {
    geoLocationManager.getCountryCode((err, result) => {
        if (err) {
            console.log('getCountryCode: err=' + JSON.stringify(err));
        }
        if (result) {
            console.log('getCountryCode: result=' + JSON.stringify(result));
        }
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}

geoLocationManager.getCountryCode

getCountryCode(): Promise<CountryCode>;

查詢當前的國家碼。

系統(tǒng)能力：SystemCapability.Location.Location.Core

返回值：

錯誤碼：

以下錯誤碼的詳細介紹請參見位置服務子系統(tǒng)錯誤碼。

示例

import geoLocationManager from '@ohos.geoLocationManager';
try {
    geoLocationManager.getCountryCode()
    .then((result) => {
        console.log('promise, getCountryCode: result=' + JSON.stringify(result));
    })
    .catch((error) => {
        console.log('promise, getCountryCode: error=' + JSON.stringify(error));
    });
} catch (err) {
    console.error("errCode:" + err.code + ",errMessage:" + err.message);
}