0
  • 聊天消息
  • 系统消息
  • 评论与回复
登录后你可以
  • 下载海量资料
  • 学习在线课程
  • 观看技术视频
  • 写文章/发帖/加入社区
会员中心
创作中心

完善资料让更多小伙伴认识你,还能领取20积分哦,立即完善>

3天内不再提示

鸿蒙开发设备管理:ohos.geolocation 位置服务

jf_46214456 来源:jf_46214456 作者:jf_46214456 2024-07-01 16:37 315次阅读

位置服务

icon-note.gif说明: 本模块首批接口从API version 7开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。 开发前请熟悉鸿蒙开发指导文档 :[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]

导入模块

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>) : void;

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

需要权限 :ohos.permission.LOCATION

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

  • 参数:

    参数名类型必填说明
    typestring设置事件类型。type为“cachedGnssLocationsReporting”,表示GNSS缓存定位结果上报。
    requestCachedGnssLocationsRequestGNSS缓存功能配置参数
    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>) : 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>) : void

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

需要权限 :ohos.permission.LOCATION

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

  • 参数:

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

    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>;

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

需要权限 :ohos.permission.LOCATION

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

  • 参数:

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

    参数名说明
    Promise>返回地理描述信息。
  • 示例:

    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>) : void

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

需要权限 :ohos.permission.LOCATION

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

  • 参数:

    参数名类型必填说明
    request[GeoCodeRequest]设置地理编码请求的相关参数。
    callbackAsyncCallback>设置接收地理编码请求的回调参数。
  • 示例:

    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>

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

需要权限 :ohos.permission.LOCATION

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

  • 参数:

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

    参数名说明
    Promise>设置接收地理编码请求的回调参数。
  • 示例:

    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缓存位置上报的周期,单位是毫秒。
wakeUpCacheQueueFullbooleantrue表示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扩展命令字符串。HarmonyOSOpenHarmony鸿蒙文档籽料:mau123789是v直接拿

新文档.png

Location

位置信息类型。

需要权限 :ohos.permission.LOCATION

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

名称参数类型必填说明
latitudenumber表示纬度信息,正值表示北纬,负值表示南纬。
longitudenumber表示经度信息,正值表示东经,负值表是西经。
altitudenumber表示高度信息,单位米。
accuracynumber表示精度信息,单位米。
speednumber表示速度信息,单位米每秒。
timeStampnumber表示位置时间戳,UTC格式。
directionnumber表示航向信息。
timeSinceBootnumber表示位置时间戳,开机时间格式。
additionsArray附加信息。
additionSizenumber附加信息数量。

审核编辑 黄宇

声明:本文内容及配图由入驻作者撰写或者入驻合作网站授权转载。文章观点仅代表作者本人,不代表电子发烧友网立场。文章及其配图仅供工程师学习之用,如有内容侵权或者其他违规问题,请联系本站处理。 举报投诉
  • 设备管理
    +关注

    关注

    0

    文章

    112

    浏览量

    9298
  • 鸿蒙
    +关注

    关注

    57

    文章

    2339

    浏览量

    42805
收藏 人收藏

    相关推荐

    鸿蒙原生应用元服务开发-Web管理位置权限

    Web组件提供位置权限管理能力。开发者可以通过onGeolocationShow()接口对某个网站进行位置权限管理。Web组件根据接口响应结
    发表于 04-28 16:57

    鸿蒙原生应用元服务开发-位置服务地理编码转化开发

    说明如下。 开发步骤 说明 GeoConvert需要访问后端服务,请确保设备联网,以进行信息获取。 导入geoLocationManager模块,所有与(逆)地理编码转化能力相关的功能API,都是通过该
    发表于 06-12 17:22

    鸿蒙原生应用元服务开发-位置服务获取设备信息开发

    LocationRequest对象,用于告知系统该向应用提供何种类型的位置服务,以及位置结果上报的频率。 方式一: 为了面向开发者提供贴近其使用场景的API使用方式,系统定义了几种常见的位置
    发表于 06-14 14:46

    鸿蒙原生应用元服务开发-位置服务开发概述

    位置能力可以提供实时准确的位置数据。对于开发者,设计基于位置体验的服务,也可以使应用的使用体验更贴近每个用户。 当应用在实现基于
    发表于 06-17 17:47

    鸿蒙原生应用元服务开发-位置服务申请权限

    申请位置权限开发指导 场景概述 应用在使用位置服务系统能力前,需要检查是否已经获取用户授权访问设备位置信息。如未获得授权,可以向用户申请需要
    发表于 06-18 15:27

    HarmonyOS/OpenHarmony应用开发-ArkTSAPI系统能力SystemCapability

    开发者可通过import的方式将模块导入,若当前设备不支持该模块,import的结果为undefined,开发者在使用API时,需要判断其是否存在。 import geolocation
    发表于 08-10 16:39

    鸿蒙生态千帆起】HarmonyOS系统级地图与位置服务,赋能广大开发

    设备接续、无缝流转。! 未来,HarmonyOS系统级地图与位置服务将深入更多行业场景,为开发者提供更多更有竞争力的产品及解决方案。
    发表于 11-22 10:37

    HarmonyOS 设备管理开发:USB 服务开发指导

    基本概念 USB 服务是应用访问底层的一种设备抽象概念。开发者根据提供的 USB API,可以获取设备列表、控制设备访问权限、以及与连接的
    发表于 11-24 15:22

    HarmonyOS位置服务开发指南

    位置服务开发概述 移动终端设备已经深入人们日常生活的方方面面,如查看所在城市的天气、新闻轶事、出行打车、旅行导航、运动记录。这些习以为常的活动,都离不开定位用户终端设备
    发表于 11-27 16:02

    基于位置服务中用户信息安全保护方法

    基于位置服务中用户信息安全保护方法....
    发表于 01-04 15:31 6次下载

    蓝牙位置服务如今已有了非常广泛的应用

    要知道蓝牙位置服务是增长最快的解决方案领域,据《2020蓝牙市场最新资讯》报告预测,至2024年,全球范围内蓝牙实时定位系统( RTLS )将达到100万;整体蓝牙位置服务设备年出货量将高达5.38亿,较2019年增长4倍。
    的头像 发表于 07-15 11:36 2984次阅读

    鸿蒙开发接口定制管理:【@ohos.enterpriseDeviceManager (企业设备管理)】

    以异步方法根据给定的包名和类名激活设备管理员应用,使用Callback形式返回是否激活成功。
    的头像 发表于 06-05 09:24 544次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b>接口定制<b class='flag-5'>管理</b>:【@<b class='flag-5'>ohos</b>.enterpriseDeviceManager (企业<b class='flag-5'>设备管理</b>)】

    鸿蒙开发设备管理ohos.multimodalInput.inputDevice 输入设备

    输入设备管理模块,用于监听输入设备连接、断开和变化,并查看输入设备相关信息。比如监听鼠标插拔,并获取鼠标的id、name和指针移动速度等信息。
    的头像 发表于 07-01 09:19 408次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>设备管理</b>:<b class='flag-5'>ohos</b>.multimodalInput.inputDevice 输入<b class='flag-5'>设备</b>

    鸿蒙开发设备管理ohos.usb USB管理

    本模块主要提供管理USB设备的相关功能,包括查询USB设备列表、批量数据传输、控制命令传输、权限控制等。
    的头像 发表于 07-05 17:34 702次阅读
    <b class='flag-5'>鸿蒙</b><b class='flag-5'>开发</b><b class='flag-5'>设备管理</b>:<b class='flag-5'>ohos</b>.usb USB<b class='flag-5'>管理</b>

    设备管理流程优化的优势

    设备管理对企业生产效率、产品质量、成本控制和安全生产起着关键作用。但设备管理面临挑战,如种类繁多、数量庞大、位置分散等。因此,企业应采用科学的设备管理方法,建立
    的头像 发表于 09-05 10:34 323次阅读
    <b class='flag-5'>设备管理</b>流程优化的优势