鸿蒙开发设备管理：【@ohos.geolocation (位置服务)】

最新推荐文章于 2024-08-15 11:57:09 发布
最新推荐文章于 2024-08-15 11:57:09 发布
阅读量958 收藏 20
点赞数 12
分类专栏： 鸿蒙开发学习笔录 文章标签： harmonyos OpenHarmony 程序员 鸿蒙 鸿蒙系统 设备管理 位置服务
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/2301_76813281/article/details/140070312
版权

位置服务

icon-note.gif 说明： 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

导入模块

import geolocation from '@ohos.geolocation';

geolocation.on(‘locationChange’)

on(type: ‘locationChange’, request: LocationRequest, callback: Callback) : void

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“locationChange”，表示位置变化。
    requestLocationRequest是设置位置请求参数。
    callbackCallback<[Location]>是接收位置变化状态变化监听。

  • 示例：

    var requestInfo = {'priority': 0x203, 'scenario': 0x300, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0};
var locationChange = (location) => {
    console.log('locationChanger: data: ' + JSON.stringify(location));
};
geolocation.on('locationChange', requestInfo, locationChange);

geolocation.off(‘locationChange’)

off(type: ‘locationChange’, callback?: Callback) : void

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“locationChange”，表示位置变化。
    callbackCallback<[Location]>否接收位置变化状态变化监听。

  • 示例：

    var requestInfo = {'priority': 0x203, 'scenario': 0x300, 'timeInterval': 0, 'distanceInterval': 0, 'maxAccuracy': 0};
var locationChange = (location) => {
    console.log('locationChanger: data: ' + JSON.stringify(location));
};
geolocation.on('locationChange', requestInfo, locationChange);
geolocation.off('locationChange', locationChange);

geolocation.on(‘locationServiceState’)

on(type: ‘locationServiceState’, callback: Callback) : void

订阅位置服务状态变化。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“locationServiceState”，表示位置服务状态。
    callbackCallback是接收位置服务状态变化监听。

  • 示例：

    var locationServiceState = (state) => {
    console.log('locationServiceState: ' + state);
}
geolocation.on('locationServiceState', locationServiceState);

geolocation.off(‘locationServiceState’)

off(type: ‘locationServiceState’, callback?: Callback) : void;

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“locationServiceState”，表示位置服务状态。
    callbackCallback否接收位置服务状态变化监听。

  • 示例：

    var locationServiceState = (state) => {
    console.log('locationServiceState: state: ' + state);
}
geolocation.on('locationServiceState', locationServiceState);
geolocation.off('locationServiceState', locationServiceState);

geolocation.on(‘cachedGnssLocationsReporting’)8+

on(type: ‘cachedGnssLocationsReporting’, request: CachedGnssLocationsRequest, callback: Callback<Array>) : void;

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“cachedGnssLocationsReporting”，表示GNSS缓存定位结果上报。
    requestCachedGnssLocationsRequest是GNSS缓存功能配置参数
    callbackCallback是接收GNSS缓存位置上报。

  • 示例：

    var cachedLocationsCb = (locations) => {
    console.log('cachedGnssLocationsReporting: locations: ' + locations);
}
var requestInfo = {'reportingPeriodSec': 10, 'wakeUpCacheQueueFull': true};
geolocation.on('cachedGnssLocationsReporting', requestInfo, cachedLocationsCb);

geolocation.off(‘cachedGnssLocationsReporting’)8+

off(type: ‘cachedGnssLocationsReporting’, callback?: Callback<Array>) : void;

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“cachedGnssLocationsReporting”，表示GNSS缓存定位结果上报。
    callbackCallback否接收GNSS缓存位置上报。

  • 示例：

    var cachedLocationsCb = (locations) => {
    console.log('cachedGnssLocationsReporting: locations: ' + locations);
}
var requestInfo = {'reportingPeriodSec': 10, 'wakeUpCacheQueueFull': true};
geolocation.on('cachedGnssLocationsReporting', requestInfo, cachedLocationsCb);
geolocation.off('cachedGnssLocationsReporting');

geolocation.on(‘gnssStatusChange’)8+

on(type: ‘gnssStatusChange’, callback: Callback) : void;

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“gnssStatusChange”，表示订阅GNSS卫星状态信息上报。
    callbackCallback是接收GNSS卫星状态信息上报。

  • 示例：

    var gnssStatusCb = (satelliteStatusInfo) => {
    console.log('gnssStatusChange: ' + satelliteStatusInfo);
}
geolocation.on('gnssStatusChange', gnssStatusCb);

geolocation.off(‘gnssStatusChange’)8+

off(type: ‘gnssStatusChange’, callback?: Callback) : void;

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“gnssStatusChange”，表示订阅GNSS卫星状态信息上报。
    callbackCallback否接收GNSS卫星状态信息上报。

  • 示例：

    var gnssStatusCb = (satelliteStatusInfo) => {
    console.log('gnssStatusChange: ' + satelliteStatusInfo);
}
geolocation.on('gnssStatusChange', gnssStatusCb);
geolocation.off('gnssStatusChange', gnssStatusCb);

geolocation.on(‘nmeaMessageChange’)8+

on(type: ‘nmeaMessageChange’, callback: Callback) : void;

订阅GNSS NMEA信息上报事件。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS NMEA信息上报。
    callbackCallback是接收GNSS NMEA信息上报。

  • 示例：

    var nmeaCb = (str) => {
    console.log('nmeaMessageChange: ' + str);
}
geolocation.on('nmeaMessageChange', nmeaCb );

geolocation.off(‘nmeaMessageChange’)8+

off(type: ‘nmeaMessageChange’, callback?: Callback) : void;

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“nmeaMessageChange”，表示订阅GNSS NMEA信息上报。
    callbackCallback否接收GNSS NMEA信息上报。

  • 示例：

    var nmeaCb = (str) => {
    console.log('nmeaMessageChange: ' + str);
}
geolocation.on('nmeaMessageChange', nmeaCb);
geolocation.off('nmeaMessageChange', nmeaCb);

geolocation.on(‘fenceStatusChange’)8+

on(type: ‘fenceStatusChange’, request: GeofenceRequest, want: WantAgent) : void;

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“fenceStatusChange”，表示订阅围栏事件上报。
    requestGeofenceRequest是围栏的配置参数。
    wantWantAgent是用于接收地理围栏事件上报（进出围栏）。

  • 示例：

    import WantAgent from '@ohos.wantAgent';
import { OperationType, WantAgentFlags } from '@ohos.wantagent';
//wantAgent对象
var wantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
	console.info("==========================>getWantAgentCallback=======================>");
    if (err.code == 0) {
	wantAgent = data;
    } else {
        console.info('----getWantAgent failed!----');
    }
}
//WantAgentInfo对象
var wantAgentInfo = {
    wants: [
        {
            deviceId: "deviceId",
            bundleName: "com.neu.setResultOnAbilityResultTest1",
            abilityName: "com.example.test.MainAbility",
            action: "action1",
            entities: ["entity1"],
            type: "MIMETYPE",
            uri: "key={true,true,false}",
            parameters:
            {
                mykey0: 2222,
                mykey1: [1, 2, 3],
                mykey2: "[1, 2, 3]",
                mykey3: "ssssssssssssssssssssssssss",
                mykey4: [false, true, false],
                mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
                mykey6: true,
            }
        }
    ],
    operationType: OperationType.START_ABILITIES,
    requestCode: 0,
    wantAgentFlags:[WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
var requestInfo = {'priority': 0x201, 'scenario': 0x301, "geofence": {"latitude": 121, "longitude": 26, "radius": 100, "expiration": 10000}};
geolocation.on('fenceStatusChange', requestInfo, wantAgent);

geolocation.off(‘fenceStatusChange’)8+

off(type: ‘fenceStatusChange’, request: GeofenceRequest, want: WantAgent) : void;

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typestring是设置事件类型。type为“fenceStatusChange”，表示订阅围栏事件上报。
    requestGeofenceRequest是围栏的配置参数。
    wantWantAgent是用于接收地理围栏事件上报（进出围栏）。

  • 示例：

    import WantAgent from '@ohos.wantAgent';
import { OperationType, WantAgentFlags } from '@ohos.wantagent';
//wantAgent对象
var wantAgent;
//getWantAgent回调
function getWantAgentCallback(err, data) {
	console.info("==========================>getWantAgentCallback=======================>");
    if (err.code == 0) {
	wantAgent = data;
    } else {
        console.info('----getWantAgent failed!----');
    }
}
//WantAgentInfo对象
var wantAgentInfo = {
    wants: [
        {
            deviceId: "deviceId",
            bundleName: "com.neu.setResultOnAbilityResultTest1",
            abilityName: "com.example.test.MainAbility",
            action: "action1",
            entities: ["entity1"],
            type: "MIMETYPE",
            uri: "key={true,true,false}",
            parameters:
            {
                mykey0: 2222,
                mykey1: [1, 2, 3],
                mykey2: "[1, 2, 3]",
                mykey3: "ssssssssssssssssssssssssss",
                mykey4: [false, true, false],
                mykey5: ["qqqqq", "wwwwww", "aaaaaaaaaaaaaaaaa"],
                mykey6: true,
            }
        }
    ],
    operationType: OperationType.START_ABILITIES,
    requestCode: 0,
    wantAgentFlags:[WantAgentFlags.UPDATE_PRESENT_FLAG]
}
WantAgent.getWantAgent(wantAgentInfo, getWantAgentCallback)
var requestInfo = {'priority': 0x201, 'scenario': 0x301, "geofence": {"latitude": 121, "longitude": 26, "radius": 100, "expiration": 10000}};
geolocation.on('fenceStatusChange', requestInfo, wantAgent);
geolocation.off('fenceStatusChange', requestInfo, wantAgent);

geolocation.getCurrentLocation

getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback) : void

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    request[CurrentLocationRequest]否设置位置请求参数。
    callbackAsyncCallback<[Location]>是用来接收位置信息的回调。

  • 示例：

    var requestInfo = {'priority': 0x203, 'scenario': 0x300,'maxAccuracy': 0};
var locationChange = (err, location) => {
    console.log('locationChanger: ' + err + 'data: ' + location);
};
geolocation.getCurrentLocation(requestInfo, locationChange);
geolocation.getCurrentLocation(locationChange);

geolocation.getCurrentLocation

getCurrentLocation(request?: CurrentLocationRequest) : Promise

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    request[CurrentLocationRequest]否设置位置请求参数。

  • 返回值：

    参数名说明
    Promise<[Location]>返回位置信息。

  • 示例：

    var requestInfo = {'priority': 0x203, 'scenario': 0x300,'maxAccuracy': 0};
locationEventListener.getCurrentLocation(requestInfo).then((result) => {
    console.log('current location: ' + JSON.stringify(result));
});

geolocation.getLastLocation

getLastLocation(callback: AsyncCallback) : void

获取上一次位置，使用callback回调异步返回结果。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    callbackAsyncCallback<[Location]>是用来接收上次位置的回调。

  • 示例：

    geolocation.getLastLocation((err, data) => {
    console.log('getLastLocation: ' + err + " data: " + JSON.stringify(data));
});

geolocation.getLastLocation

getLastLocation() : Promise

获取上一次位置，使用Promise方式异步返回结果。

需要权限：ohos.permission.LOCATION

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

  • 返回值：

    参数名说明
    Promise<[Location]>返回上次位置信息。

  • 示例：

    geolocation.getLastLocation().then((result) => {
    console.log('getLastLocation: result: ' + JSON.stringify(result));
});

geolocation.isLocationEnabled

isLocationEnabled(callback: AsyncCallback) : void

判断位置服务是否已经打开，使用callback回调异步返回结果。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    callbackAsyncCallback是用来接收位置服务状态的回调。

  • 示例：

    geolocation.isLocationEnabled((err, data) => {
    console.log('isLocationEnabled: ' + err + " data: " + data);
});

geolocation.isLocationEnabled

isLocationEnabled() : Promise

判断位置服务是否已经开启，使用Promise方式异步返回结果。

需要权限：ohos.permission.LOCATION

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

  • 返回值：

    参数名说明
    Promise返回位置服务是否可用的状态。

  • 示例：

    geolocation.isLocationEnabled().then((result) => {
    console.log('promise, isLocationEnabled: ' + result);
});

geolocation.requestEnableLocation

requestEnableLocation(callback: AsyncCallback) : void

请求打开位置服务，使用callback回调异步返回结果。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    callbackAsyncCallback是用来接收位置服务状态的回调。

  • 示例：

    geolocation.requestEnableLocation((err, data) => {
    console.log('requestEnableLocation: ' + err + " data: " + data);
});

geolocation.requestEnableLocation

requestEnableLocation() : Promise

请求打开位置服务，使用Promise方式异步返回结果。

需要权限：ohos.permission.LOCATION

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

  • 返回值：

    参数名说明
    Promise返回位置服务是否可用。

  • 示例：

    geolocation.requestEnableLocation().then((result) => {
    console.log('promise, requestEnableLocation: ' + result);
});

geolocation.enableLocation

enableLocation(callback: AsyncCallback) : void;

打开位置服务，使用callback回调异步返回结果。

系统API：此接口为系统接口，三方应用不支持调用。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    callbackAsyncCallback是用来接收位置服务状态的回调。

  • 示例：

    geolocation.enableLocation((err, data) => {
    console.log('enableLocation: ' + err + " data: " + data);
});

geolocation.enableLocation

enableLocation() : Promise

打开位置服务，使用Promise方式异步返回结果。

系统API：此接口为系统接口，三方应用不支持调用。

需要权限：ohos.permission.LOCATION

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

  • 返回值：

    参数名说明
    Promise返回位置服务是否可用。

  • 示例：

    geolocation.enableLocation().then((result) => {
    console.log('promise, enableLocation: ' + result);
});

geolocation.disableLocation

disableLocation(callback: AsyncCallback) : void;

打开位置服务，使用callback回调异步返回结果。

系统API：此接口为系统接口，三方应用不支持调用。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    callbackAsyncCallback是用来接收位置服务状态的回调。

  • 示例：

    geolocation.disableLocation((err, data) => {
    console.log('disableLocation: ' + err + " data: " + data);
});

geolocation.disableLocation

disableLocation() : Promise

打开位置服务，使用Promise方式异步返回结果。

系统API：此接口为系统接口，三方应用不支持调用。

需要权限：ohos.permission.LOCATION

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

  • 返回值：

    参数名说明
    Promise返回位置服务是否可用。

  • 示例：

    geolocation.disableLocation().then((result) => {
    console.log('promise, disableLocation: ' + result);
});

geolocation.isGeoServiceAvailable

isGeoServiceAvailable(callback: AsyncCallback) : void

判断（逆）地理编码服务状态，使用callback回调异步返回结果。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    callbackAsyncCallback是用来接收地理编码服务状态的回调。

  • 示例：

    geolocation.isGeoServiceAvailable((err, data) => {
    console.log('isGeoServiceAvailable: ' + err + " data: " + data);
});

geolocation.isGeoServiceAvailable

isGeoServiceAvailable() : Promise

判断（逆）地理编码服务状态，使用Promise方式异步返回结果。

需要权限：ohos.permission.LOCATION

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

  • 返回值：

    参数名说明
    Promise返回地理编码服务是否可用的状态。

  • 示例：

    geolocation.isGeoServiceAvailable().then((result) => {
    console.log('promise, isGeoServiceAvailable: ' + result);
});

geolocation.getAddressesFromLocation

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

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    request[ReverseGeoCodeRequest]是设置逆地理编码请求的相关参数。
    callbackAsyncCallback<Array<[GeoAddress]>>是设置接收逆地理编码请求的回调参数。

  • 示例：

    var reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1};
geolocation.getAddressesFromLocation(reverseGeocodeRequest, (err, data) => {
    console.log('getAddressesFromLocation: ' + err + " data: " + JSON.stringify(data));
});

geolocation.getAddressesFromLocation

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

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    request[ReverseGeoCodeRequest]是设置逆地理编码请求的相关参数。

  • 返回值：

    参数名说明
    Promise<Array<[GeoAddress]>>返回地理描述信息。

  • 示例：

    var reverseGeocodeRequest = {"latitude": 31.12, "longitude": 121.11, "maxItems": 1};
geolocation.getAddressesFromLocation(reverseGeocodeRequest).then((data) => {
    console.log('getAddressesFromLocation: ' + JSON.stringify(data));
});

geolocation.getAddressesFromLocationName

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

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    request[GeoCodeRequest]是设置地理编码请求的相关参数。
    callbackAsyncCallback<Array<[GeoAddress])>>是设置接收地理编码请求的回调参数。

  • 示例：

    var geocodeRequest = {"description": "上海市浦东新区xx路xx号", "maxItems": 1};
geolocation.getAddressesFromLocationName(geocodeRequest, (err, data) => {
    console.log('getAddressesFromLocationName: ' + err + " data: " + JSON.stringify(data));
});

geolocation.getAddressesFromLocationName

getAddressesFromLocationName(request: GeoCodeRequest) : Promise<Array>

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    request[GeoCodeRequest]是设置地理编码请求的相关参数。

  • 返回值：

    参数名说明
    Promise<Array<[GeoAddress]>>设置接收地理编码请求的回调参数。

  • 示例：

    var geocodeRequest = {"description": "上海市浦东新区xx路xx号", "maxItems": 1};
geolocation.getAddressesFromLocationName(geocodeRequest).then((result) => {
    console.log('getAddressesFromLocationName: ' + JSON.stringify(result));
});

geolocation.getCachedGnssLocationsSize8+

getCachedGnssLocationsSize(callback: AsyncCallback) : void;

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    callbackAsyncCallback是用来接收GNSS芯片缓存位置个数的回调。

  • 示例：

    geolocation.getCachedGnssLocationsSize((err, size) => {
    console.log('getCachedGnssLocationsSize: err:' + err + " size: " + size);
});

geolocation.getCachedGnssLocationsSize8+

getCachedGnssLocationsSize() : Promise;

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

需要权限：ohos.permission.LOCATION

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

  • 返回值：

    参数名说明
    Promise返回GNSS缓存位置的个数。

  • 示例：

    geolocation.getCachedGnssLocationsSize().then((result) => {
    console.log('promise, getCachedGnssLocationsSize: ' + result);
});

geolocation.flushCachedGnssLocations8+

flushCachedGnssLocations(callback: AsyncCallback) : void;

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

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    callbackAsyncCallback是用来接收清空GNSS芯片缓存位置操作的结果。

  • 示例：

    geolocation.flushCachedGnssLocations((err, result) => {
    console.log('flushCachedGnssLocations: err:' + err + " result: " + result);
});

geolocation.flushCachedGnssLocations8+

flushCachedGnssLocations() : Promise;

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

需要权限：ohos.permission.LOCATION

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

  • 返回值：

    参数名说明
    Promise清空所有GNSS缓存位置是否成功。

  • 示例：

    geolocation.flushCachedGnssLocations().then((result) => {
    console.log('promise, flushCachedGnssLocations: ' + result);
});

geolocation.sendCommand8+

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

给位置服务子系统的各个部件发送扩展命令。只有系统应用才能调用。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    commandLocationCommand是指定目标场景，和将要发送的命令（字符串）。
    callbackAsyncCallback是用来接收命令发送的结果。

  • 示例：

    var requestInfo = {'scenario': 0x301, 'command': "command_1"};
geolocation.sendCommand(requestInfo, (err, result) => {
    console.log('sendCommand: err:' + err + " result: " + result);
});

geolocation.sendCommand8+

sendCommand(command: LocationCommand) : Promise;

给位置服务子系统的各个部件发送扩展命令。只有系统应用才能调用。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    commandLocationCommand是指定目标场景，和将要发送的命令（字符串）。

  • 返回值：

    参数名说明
    Promise表示命令发送成功或失败。

  • 示例：

    var requestInfo = {'scenario': 0x301, 'command': "command_1"};
geolocation.sendCommand(requestInfo).then((result) => {
    console.log('promise, sendCommand: ' + result);
});

geolocation.isLocationPrivacyConfirmed8+

isLocationPrivacyConfirmed(type : LocationPrivacyType, callback: AsyncCallback) : void;

查询用户是否同意定位服务隐私申明，是否同意启用定位服务。只有系统应用才能调用。

系统API：此接口为系统接口，三方应用不支持调用。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typeLocationPrivacyType是指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。
    callbackAsyncCallback是表示用户是否同意定位服务隐私申明。

  • 示例：

    geolocation.isLocationPrivacyConfirmed(1, (err, result) => {
    console.log('isLocationPrivacyConfirmed: err:' + err + " result: " + result);
});

geolocation.isLocationPrivacyConfirmed8+

isLocationPrivacyConfirmed(type : LocationPrivacyType,) : Promise;

查询用户是否同意定位服务隐私申明，是否同意启用定位服务。只有系统应用才能调用。

系统API：此接口为系统接口，三方应用不支持调用。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typeLocationPrivacyType是指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。

  • 返回值：

    参数名说明
    Promise表示用户是否同意定位服务隐私申明。

  • 示例：

    geolocation.isLocationPrivacyConfirmed(1).then((result) => {
    console.log('promise, isLocationPrivacyConfirmed: ' + result);
});

geolocation.setLocationPrivacyConfirmStatus8+

setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed: boolean, callback: AsyncCallback) : void;

设置用户勾选定位服务隐私申明的状态，记录用户是否同意启用定位服务。只有系统应用才能调用。

系统API：此接口为系统接口，三方应用不支持调用。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typeLocationPrivacyType是指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。
    isConfirmedboolean是表示用户是否同意定位服务隐私申明。
    callbackAsyncCallback是表示操作是否成功。

  • 示例：

    geolocation.setLocationPrivacyConfirmStatus(1, true, (err, result) => {
    console.log('isLocationPrivacyConfirmed: err:' + err + " result: " + result);
});

geolocation.setLocationPrivacyConfirmStatus8+

setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolean) : Promise;

设置用户勾选定位服务隐私申明的状态，记录用户是否同意启用定位服务。只有系统应用才能调用。

系统API：此接口为系统接口，三方应用不支持调用。

需要权限：ohos.permission.LOCATION

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

  • 参数：

    参数名类型必填说明
    typeLocationPrivacyType是指定隐私申明场景，例如开机向导中的隐私申明、开启网络定位功能时弹出的隐私申明等。
    isConfirmedboolean是表示用户是否同意定位服务隐私申明。

  • 返回值：

    参数名说明
    Promise表示操作是否成功。

  • 示例：

    geolocation.setLocationPrivacyConfirmStatus(1, true).then((result) => {
    console.log('promise, setLocationPrivacyConfirmStatus: ' + result);
});

LocationRequestPriority

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

需要权限：ohos.permission.LOCATION

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

名称默认值说明
UNSET0x200表示未设置优先级。
ACCURACY0x201表示精度优先。
LOW_POWER0x202表示低功耗优先。
FIRST_FIX0x203表示快速获取位置优先，如果应用希望快速拿到1个位置，可以将优先级设置为该字段。

LocationRequestScenario

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

需要权限：ohos.permission.LOCATION

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

名称默认值说明
UNSET0x300表示未设置场景信息。
NAVIGATION0x301表示导航场景。
TRAJECTORY_TRACKING0x302表示运动轨迹记录场景。
CAR_HAILING0x303表示打车场景。
DAILY_LIFE_SERVICE0x304表示日常服务使用场景。
NO_POWER0x305表示无功耗功场景，这种场景下不会主动触发定位，会在其他应用定位时，才给当前应用返回位置。

GeoLocationErrorCode

位置服务中的错误码信息。

需要权限：ohos.permission.LOCATION

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

名称默认值说明
INPUT_PARAMS_ERROR101表示输入参数错误。
REVERSE_GEOCODE_ERROR102表示逆地理编码接口调用失败。
GEOCODE_ERROR103表示地理编码接口调用失败。
LOCATOR_ERROR104表示定位失败。
LOCATION_SWITCH_ERROR105表示定位开关。
LAST_KNOWN_LOCATION_ERROR106表示获取上次位置失败。
LOCATION_REQUEST_TIMEOUT_ERROR107表示单次定位，没有在指定时间内返回位置。

ReverseGeoCodeRequest

逆地理编码请求接口。

需要权限：ohos.permission.LOCATION

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

名称参数类型必填说明
localestring否指定位置描述信息的语言，“zh”代表中文，“en”代表英文。
latitudenumber是表示纬度信息，正值表示北纬，负值表示南纬。
longitudenumber是表示经度信息，正值表示东经，负值表示西经。
maxItemsnumber否指定返回位置信息的最大个数。

GeoCodeRequest

地理编码请求接口。

需要权限：ohos.permission.LOCATION

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

名称参数类型必填说明
localestring否表示位置描述信息的语言，“zh”代表中文，“en”代表英文。
descriptionnumber是表示位置信息描述，如“上海市浦东新区xx路xx号”。
maxItemsnumber否表示返回位置信息的最大个数。
minLatitudenumber否表示最小纬度信息，与下面三个参数一起，表示一个经纬度范围。
minLongitudenumber否表示最小经度信息。
maxLatitudenumber否表示最大纬度信息。
maxLongitudenumber否表示最大经度信息。

GeoAddress

地理编码类型。

需要权限：ohos.permission.LOCATION

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

名称参数类型必填说明
latitudenumber否表示纬度信息，正值表示北纬，负值表示南纬。
longitudenumber否表示经度信息，正值表示东经，负值表是西经。
localestring否表示位置描述信息的语言，“zh”代表中文，“en”代表英文。
placeNamestring否表示地区信息。
countryCodestring否表示国家码信息。
countryNamestring否表示国家信息。
administrativeAreastring否表示省份区域信息。
subAdministrativeAreastring否表示表示子区域信息。
localitystring否表示城市信息。
subLocalitystring否表示子城市信息。
roadNamestring否表示路名信息。
subRoadNamestring否表示子路名信息。
premisesstring否表示门牌号信息。
postalCodestring否表示邮政编码信息。
phoneNumberstring否表示联系方式信息。
addressUrlstring否表示位置信息附件的网址信息。
descriptionsArray否表示附加的描述信息。
descriptionsSizenumber否表示附加的描述信息数量。

LocationRequest

位置信息请求类型。

需要权限：ohos.permission.LOCATION

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

名称参数类型必填说明
priority[LocationRequestPriority]否表示优先级信息。
scenario[LocationRequestScenario]是表示场景信息。
timeIntervalnumber否表示上报位置信息的时间间隔。
distanceIntervalnumber否表示上报位置信息的距离间隔。
maxAccuracynumber否表示精度信息。

CurrentLocationRequest

当前位置信息请求类型。

需要权限：ohos.permission.LOCATION

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

名称参数类型必填说明
priority[LocationRequestPriority]否表示优先级信息。
scenario[LocationRequestScenario]否表示场景信息。
maxAccuracynumber否表示精度信息，单位是米。
timeoutMsnumber否表示超时时间，单位是毫秒，最小为1000毫秒。

SatelliteStatusInfo8+

卫星状态信息。

需要权限：ohos.permission.LOCATION

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

名称参数类型必填说明
satellitesNumbernumber是表示卫星个数。
satelliteIdsArray是表示每个卫星的ID，数组类型。
carrierToNoiseDensitysArray是表示载波噪声功率谱密度比，即cn0。
altitudesArray是表示高程信息。
azimuthsArray是表示方位角。
carrierFrequenciesArray是表示载波频率。

CachedGnssLocationsRequest8+

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

需要权限：ohos.permission.LOCATION

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

名称参数类型必填说明
reportingPeriodSecnumber是表示GNSS缓存位置上报的周期，单位是毫秒。
wakeUpCacheQueueFullboolean是true表示GNSS芯片底层缓存队列满之后会主动唤醒AP芯片，并把缓存位置上报给应用。 false表示GNSS芯片底层缓存队列满之后不会主动唤醒AP芯片，会把缓存位置直接丢弃。

Geofence8+

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

需要权限：ohos.permission.LOCATION

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

名称参数类型必填说明
latitudenumber是表示纬度。
longitudenumber是表示经度。
radiusnumber是表示圆形围栏的半径。
expirationnumber是围栏存活的时间，单位是毫秒。

GeofenceRequest8+

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

需要权限：ohos.permission.LOCATION

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

名称参数类型必填说明
priorityLocationRequestPriority是表示位置信息优先级。
scenarioLocationRequestScenario是表示定位场景。
geofenceGeofence是表示围栏信息。

LocationPrivacyType8+

定位服务隐私协议类型。

需要权限：ohos.permission.LOCATION

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

名称默认值说明
OTHERS0其他场景。
STARTUP1开机向导场景下的隐私协议。
CORE_LOCATION2开启网络定位时弹出的隐私协议。

LocationCommand8+

扩展命令结构体。

需要权限：ohos.permission.LOCATION

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

名称参数类型必填说明
scenarioLocationRequestScenario是表示定位场景。
commandstring是扩展命令字符串。

Location

在这里插入图片描述

位置信息类型。

需要权限：ohos.permission.LOCATION

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

名称参数类型必填说明
latitudenumber是表示纬度信息，正值表示北纬，负值表示南纬。
longitudenumber是表示经度信息，正值表示东经，负值表是西经。
altitudenumber是表示高度信息，单位米。
accuracynumber是表示精度信息，单位米。
speednumber是表示速度信息，单位米每秒。
timeStampnumber是表示位置时间戳，UTC格式。
directionnumber是表示航向信息。
timeSinceBootnumber是表示位置时间戳，开机时间格式。
additionsArray否附加信息。
additionSizenumber否附加信息数量。
爱桥代码的程序媛
关注
  • 12
    点赞
  • 踩
  • 20
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
HarmonyOS鸿蒙开发指南:基于ArkTS开发 设备管理 位置开发
sybh的博客
01-11 1200
移动终端设备已经深入人们日常生活的方方面面，如查看所在城市的天气、新闻轶事、出行打车、旅行导航、运动记录。这些习以为常的活动，都离不开定位用户终端设备的位置。当用户处于这些丰富的使用场景中时，系统的位置能力可以提供实时准确的位置数据。对于开发者，设计基于位置体验的服务，也可以使应用的使用体验更贴近每个用户。当应用在实现基于设备位置的功能时，如：驾车导航，记录运动轨迹等，可以调用该模块的API接口，完成位置信息的获取。开发者可以调用位置相关接口，获取设备实时位置，或者最近的历史位置。
getAccurateCurrentPosition:补充navigator.geolocation的简单功能-在回复之前花费更多时间微调位置
05-04
背景： 提供了geolocation.getCurrentPosition（）方法，该方法将返回设备的当前位置。 这似乎很容易，因此大多数开发人员只需在需要位置时调用此方法即可。 此方法的一个选项是“ enableHighAccuracy”，这显然意味...
在鸿蒙应用中实现位置定位
qq_31532979的博客
03-04 804
通过以上步骤，就可以在鸿蒙应用中实现位置服务并获取设备的当前位置信息。
鸿蒙开发学习【地图位置服务组件】
2301_76813281的博客
03-23 577
移动终端设备已经深入人们日常生活的方方面面，如查看所在城市的天气、新闻轶事、出行打车、旅行导航、运动记录。这些习以为常的活动，都离不开定位用户终端设备的位置。当用户处于这些丰富的使用场景中时，系统的位置定位能力可以提供实时准确的位置数据。对于开发者，设计基于位置体验的服务，也可以更好的满足用户的需求。当应用在实现基于设备位置的功能时，如：驾车导航，记录运动轨迹等，可以调用该模块的API接口，完成位置信息的获取基本概念。
Harmony应用开发——定位服务
Creat_List的博客
01-10 1128
移动终端设备已经深入人们日常生活的方方面面，如查看所在城市的天气、新闻轶事、出行打车、旅行导航、运动记录。这些习以为常的活动，都离不开定位用户终端设备的位置。当用户处于这些丰富的使用场景中时，系统的位置能力可以提供实时准确的位置数据。对于开发者，设计基于位置体验的服务，也可以使应用的使用体验更贴近每个用户。当应用在实现基于设备位置的功能时，如：驾车导航，记录运动轨迹等，可以调用该模块的API接口，完成位置信息的获取。位置子系统使用多种定位技术提供服务，如。
HarmonyOS获取设备地理位置实战_harmony获取定位(1)，2024年最新HarmonyOS鸿蒙面试题及答案2024
2401_84166005的博客
04-13 807
/定义需要输入的请求参数,其中locale键对应的值’zh‘表示服务器将返回中文形式的信息。//编写异步方法,调用之前已写好的模块文件Applicant。//编写异步方法，调用之前已写好的模块文件Geo。//等待模块完成逆地理编码转换的异步操作。//等待模块完成获取地理位置的异步操作。‘error’:‘设备未获取相关权限’‘cityName’: ’ 未知’,‘cityName’:’ 未知’,//结点函数的执行状态，默认为失败。//结点函数的执行状态，默认为失败。‘cityName’:’ 未知’,
鸿蒙开发Ability Kit（程序访问控制）：【对所有应用开放】
鸿蒙的技术博客
07-02 826
在申请目标权限前，建议开发者先阅读[申请应用权限]，对权限的工作流程有基本了解后，再结合以下权限字段的具体说明，判断应用能否申请目标权限，提高开发效率。权限级别为normal的权限，不涉及ACL使能字段。
【愚公系列】2023年12月 HarmonyOS教学课程 054-Web组件（基本使用和属性）
热门推荐
时光隧道
12-25 5万+
Web是一种基于互联网的技术和资源的网络服务系统。它是指由许多互连的计算机组成的全球性计算机网络，使用户能够通过浏览器访问和交互式使用各种信息和资源，如网页、文档、图片、视频、音频等。通过Web，用户可以浏览网页、发送电子邮件、参与在线社交网络、进行在线购物等各种活动。Web的核心技术包括超文本传输协议（HTTP），超文本标记语言（HTML）和统一资源定位器（URL）。HarmonyOS中的Web组件是一种基于Web技术的组件，可以在HarmonyOS应用程序中嵌入Web内容。
【鸿蒙实战开发】详解webview 组件（使用和调试）
HarmonyOS_001的博客
06-28 1635
有很多小伙伴不知道该从哪里开始学习鸿蒙开发技术？也不知道鸿蒙开发的知识点重点掌握的又有哪些？自学时频繁踩坑，导致浪费大量时间。结果还是一知半解。所以有一份实用的鸿蒙（HarmonyOS NEXT）全栈开发资料用来跟着学习是非常有必要的。获取完整版高清学习资料，请点击→鸿蒙全栈开发学习资料（安全链接，请放心点击）
geolocation:navigator.geolocation 对象
06-28
在Web开发中，JavaScript的`navigator.geolocation`对象扮演着重要的角色，它允许我们获取用户的地理位置信息。这个功能极大地丰富了网页的交互性，可以用于提供基于位置的服务，如地图导航、天气预报、附近商家推荐...
angularjs-geolocation：围绕window.navigator.geolocation的angular.js包装器
02-25
请使用以下命令进行安装： bower install angularjs-geolocation 或者bower install git://github.com/arunisrael/angularjs-geolocation.git用法将地理位置模块添加为依赖项注入地理位置服务（是的，名称相同） 在...
use-geolocation-position:对geolocation.getCurrentPosition和geolocation.watchPosition的React挂钩
05-24
使用地理位置 对geolocation.getCurrentPosition和getCurrentPosition.watchPosition React挂钩目录用法 import React from 'react'import { useCurrentPosition , useWatchPosition } from 'use-geolocation-...
casper-geolocation:使用 Casper.js 测试您的地理定位应用程序
06-29
它允许通过简单的setLocation()函数控制客户端的地理位置。 如何使用 var require = patchRequire ( require ) , initial_pos = { timestamp : Date . now ( ) , coords : { latitude : 10 , longitude : 10 , ...
HarmonyOS应用开发学习-ArkUI-容器组件
最新发布
08-15 796
设置导航点样式:-left: 设置导航点距离Swiper组件左边的距离。-size:设置导航点的直径。例如,"1fr 1fr 2fr'是将父组件分3列，将父组件允许的宽分为4等份，第一列占1份，第二列占1份，第三列占2份。例如,"1fr 1fr 2fr”是将父组件分三行，将父组件允许的高分为4等份，第一行占1份，第二行占一份，第三行占2份。网格容器，由“行”和“列”分割的单元格所组成，通过指定”项目”所在的单元格做出各种各样的布局。设置为false是为横向Tabs，设置为true时为纵向Tabs。
【鸿蒙学习】HarmonyOS应用开发者基础 - 构建更加丰富的页面（一）
一个不断前行的程序者
08-14 667
ArkWeb是用于应用程序中显示Web页面内容的Web组件，为开发者提供页面加载、页面交互、页面调试等能力。可以实现移动端的混合式开发（Hybrid App）。
【鸿蒙学习】Stage模型与FA模型的对比与应用选择
一个不断前行的程序者
08-12 366
Stage模型是一种基于应用生命周期和功能模块划分的架构设计理念。它将应用分为多个阶段（Stage），每个阶段对应一个特定的任务或界面，使得应用结构更加清晰、开发更加高效。FA模型（Feature Ability Model）是鸿蒙OS中另一种应用架构设计理念，它以功能为单元，将应用划分为多个功能模块（Feature Ability），每个模块具有独立的生命周期和功能。Stage模型和FA模型各有优势，适用于不同的开发场景。普通开发者应根据项目需求、团队协作、性能要求等因素，选择最合适的模型。
鸿蒙（API 12 Beta3版）【扩展屏投播开发指导】使用投播组件
鸿蒙的技术博客
08-14 1096
通过本节开发指导，可在系统镜像投屏后，获取投屏设备信息，实现扩展屏模式的投播，实现双屏协作的能力。
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值