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

位置服务

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否附加信息数量。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.mzph.cn/diannao/37867.shtml

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈email:809451989@qq.com，一经查实，立即删除！

相关文章

安卓开发自定义时间日期显示组件

安卓开发自定义时间日期显示组件

安卓开发自定义时间日期显示组件 问题背景 实现时间和日期显示&#xff0c;左对齐和对齐两种效果&#xff0c;如下图所示&#xff1a; 问题分析 自定义view实现一般思路&#xff1a; &#xff08;1&#xff09;自定义一个View &#xff08;2&#xff09;编写values/attrs.…
阅读更多...
poi-tl 生成 word 文件（插入文字、图片、表格、图表）

poi-tl 生成 word 文件（插入文字、图片、表格、图表）

文章说明 本篇文章主要通过代码案例的方式&#xff0c;展示 poi-tl 生成 docx 文件的一些常用操作&#xff0c;主要涵盖以下内容 &#xff1a; 插入文本字符&#xff08;含样式、超链接&#xff09;插入图片插入表格引入标签&#xff08;通过可选文字的方式&#xff0c;这种方…
阅读更多...
大模型和数据库最新结合进展

大模型和数据库最新结合进展

写在前面 本文主要内容是上次接受 infoQ 访谈&#xff0c;百度智能云朱洁老师介绍了大模型和 AI 结合相关话题&#xff0c;这次整体再刷新下&#xff0c;给到对这个领域感兴趣的同学。 当前&#xff0c;百度智能云云数据库特惠专场开始&#xff01;热销规格新用户免费使用&am…
阅读更多...
最逼真的简易交通灯设计

最逼真的简易交通灯设计

最逼真的简易交通灯设计 需要资料的请在文章末尾获取&#xff08;有问题可以私信我哦~~&#xff09; 01 资料内容 Proteus仿真文件程序源码实物制作&#xff0c;代码修改&#xff0c;功能定制&#xff08;需额外收费&#xff0c;价格实惠&#xff0c;欢迎咨询&#xff09; …
阅读更多...
实验场：在几分钟内使用 Elasticsearch 进行 RAG 应用程序实验

实验场：在几分钟内使用 Elasticsearch 进行 RAG 应用程序实验

作者&#xff1a;来自 Elastic Joe McElroy, Serena Chou 什么是 Playground&#xff08;实验场&#xff09;&#xff1f; 我们很高兴发布我们的 Playground 体验 —- 一个低代码界面&#xff0c;开发人员可以在几分钟内使用自己的私人数据探索他们选择的 LLM。 在对对话式搜…
阅读更多...
41割队伍

41割队伍

上海市计算机学会竞赛平台 | YACSYACS 是由上海市计算机学会于2019年发起的活动，旨在激发青少年对学习人工智能与算法设计的热情与兴趣，提升青少年科学素养，引导青少年投身创新发现和科研实践活动。https://www.iai.sh.cn/problem/387 题目描述 给定 𝑛n 个数字 𝑎1,�…
阅读更多...
Hi3861 OpenHarmony嵌入式应用入门--LiteOS Semaphore做同步使用

Hi3861 OpenHarmony嵌入式应用入门--LiteOS Semaphore做同步使用

信号量作为同步使用 创建一个Semaphore对象&#xff0c;并指定一个初始的计数值&#xff08;通常称为“许可”或“令牌”的数量&#xff09;。这个计数值表示当前可用的资源数量或可以同时访问共享资源的线程数。当一个线程需要访问共享资源时&#xff0c;它会尝试从Semaphore…
阅读更多...
加油站可视化：打造智能化运营与管理新模式

加油站可视化：打造智能化运营与管理新模式

智慧加油站可视化通过图扑 HT 构建仿真的三维模型&#xff0c;将加油站的布局、设备状态、人员活动等信息动态呈现。管理者可以通过直观的可视化界面实时监控和分析运营状况&#xff0c;快速做出决策&#xff0c;提高管理效率和安全水平&#xff0c;推动加油站向智能化管理转型…
阅读更多...
后端之路第三站(Mybatis)——结合案例讲Mybatis怎么操作sql

后端之路第三站(Mybatis)——结合案例讲Mybatis怎么操作sql

先讲一下准备工作整体流程要做什么 我们要基于一个员工管理系统作为案例&#xff0c;进行员工信息的【增、删、改、查】 原理就是用Mybatis通过java语言来执行sql语句&#xff0c;来达到【增、删、改、查】 一、准备工作 1、引入数据库数据 首先我们把一个员工、部门表的数…
阅读更多...
【51单片机入门】速通定时器

【51单片机入门】速通定时器

文章目录 前言定时器是什么初始化定时器初始化的大概步骤TMOD寄存器C/T寄存器 触发定时器中断是什么中断函数定时器点亮led 总结 前言 在嵌入式系统的开发中&#xff0c;定时器是一个非常重要的组成部分。它们可以用于产生精确的时间延迟&#xff0c;或者在特定的时间间隔内触…
阅读更多...
Java--常用类APl(复习总结)

Java--常用类APl(复习总结)

前言: Java是一种强大而灵活的编程语言&#xff0c;具有广泛的应用范围&#xff0c;从桌面应用程序到企业级应用程序都能够使用Java进行开发。在Java的编程过程中&#xff0c;使用标准类库是非常重要的&#xff0c;因为标准类库提供了丰富的类和API&#xff0c;可以简化开发过…
阅读更多...
【接口自动化测试】第三节.实现项目核心业务接口自动化

【接口自动化测试】第三节.实现项目核心业务接口自动化

文章目录 前言一、实现登录接口对象封装和调用 1.0 登录接口的接口测试文档 1.1 接口对象层&#xff08;封装&#xff09; 1.2 测试脚本层&#xff08;调用&#xff09;二、课程新增接口对象封装和调用 2.0 课程新增接口的接口测试文档 2.1 接口对象层…
阅读更多...
AVL树模拟

AVL树模拟

1.概念 虽然二叉搜索树可以缩短查找的效率&#xff0c;但如果数据有序或者接近有序时二叉搜索树树将退化为单支树&#xff0c;查找元素相当于在顺序表中搜索元素&#xff0c;效率低下。AVL 树是具有一下性质的二叉搜索树&#xff1a; 1.它的左右子树都是AVL树 2.左右子…
阅读更多...
Mac 如何安装 wget

Mac 如何安装 wget

1.安装 Homebrew2.安装 wget3.检测 wget 是否安装成功 1.安装 Homebrew 在安装 wget 之前需要安装一个适用于 mac 的包管理器 Homebrew&#xff0c;打开 mac 终端执行如下命令进行安装&#xff1a; /usr/bin/ruby -e "$(curl -fsSL https://cdn.jsdelivr.net/gh/ineo6/h…
阅读更多...
新手第一个漏洞复现:MS17-010(永恒之蓝)

新手第一个漏洞复现:MS17-010(永恒之蓝)

文章目录 漏洞原理漏洞影响范围复现环境复现步骤 漏洞原理 漏洞出现在Windows SMB v1中的内核态函数srv!SrvOs2FeaListToNt在处理FEA&#xff08;File Extended Attributes&#xff09;转换时。该函数在将FEA list转换成NTFEA&#xff08;Windows NT FEA&#xff09;list前&am…
阅读更多...
【Golang - 90天从新手到大师】Day14 - 方法和接口

【Golang - 90天从新手到大师】Day14 - 方法和接口

一&#xff0e; go方法 go方法&#xff1a;在函数的func和函数名间增加一个特殊的接收器类型&#xff0c;接收器可以是结构体类型或非结构体类型。接收器可以在方法内部访问。创建一个接收器类型为Type的methodName方法。 func (t Type) methodName(parameter list) {}go引入…
阅读更多...
解决“Duplicate keys detected: ‘ ‘.This may cause an update error.”问题

解决“Duplicate keys detected: ‘ ‘.This may cause an update error.”问题

问题原因 出现“Duplicate keys detected”的错误&#xff0c;通常表示在v-for指令中使的:key绑定值有重复。 如果前端是静态数据&#xff0c;一般能自我避免:key绑定值有重复。如果前端是绑定的动态数据&#xff0c;那么需要另外提供一个唯一的键。 在这个例子中&#xff0c…
阅读更多...
【LeetCode】接雨水

【LeetCode】接雨水

目录 一、题目二、解法完整代码 一、题目 给定 n 个非负整数表示每个宽度为 1 的柱子的高度图&#xff0c;计算按此排列的柱子&#xff0c;下雨之后能接多少雨水。 示例 1&#xff1a; 输入&#xff1a;height [0,1,0,2,1,0,1,3,2,1,2,1] 输出&#xff1a;6 解释&#xff…
阅读更多...
【UML用户指南】-23-对高级行为建模-状态机

【UML用户指南】-23-对高级行为建模-状态机

目录 1、概述 2、状态 2.1、状态的组成 3、转移 3.1、转移的组成 4、高级状态和转移 4.1、进入效应和退出效应 4.2、内部转移 4.3、do活动 4.4、延迟事件 4.5、子状态机 5、子状态 5.1、非正交子状态 5.2、历史状态 5.3、正交子状态 6、分叉与汇合 7、主动对象…
阅读更多...
GOROOT GOPATH GOPROXY GO111MODULE

GOROOT GOPATH GOPROXY GO111MODULE

GOROOT GOROOT代表Go的安装目录。可执行程序go(或go.exe)和gofmt(或gofmt.exe)位于 GOROOT/bin目录中。 配置GOROOT环境变量&#xff0c;其值为Go的安装目录&#xff1b;然后在环境变量PATH中添加GOROOT/bin路径。 注意&#xff1a;GOROOT变量只是代表了安装目录&#xff0c;不…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023