位置服務(wù)
說明: 本模塊首批接口從API version 7開始支持。后續(xù)版本的新增接口,采用上角標(biāo)單獨標(biāo)記接口的起始版本。 開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 :[
gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
]
導(dǎo)入模塊
import geolocation from '@ohos.geolocation';
geolocation.on('locationChange')
on(type: 'locationChange', request: LocationRequest, callback: Callback) : void
開啟位置變化訂閱,并發(fā)起定位請求。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“l(fā)ocationChange”,表示位置變化。 request LocationRequest 是 設(shè)置位置請求參數(shù)。 callback Callback<[Location]> 是 接收位置變化狀態(tài)變化監(jiān)聽。 示例:
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
關(guān)閉位置變化訂閱,并刪除對應(yīng)的定位請求。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“l(fā)ocationChange”,表示位置變化。 callback Callback<[Location]> 否 接收位置變化狀態(tài)變化監(jiān)聽。 示例:
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
訂閱位置服務(wù)狀態(tài)變化。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“l(fā)ocationServiceState”,表示位置服務(wù)狀態(tài)。 callback Callback 是 接收位置服務(wù)狀態(tài)變化監(jiān)聽。 示例:
var locationServiceState = (state) = > { console.log('locationServiceState: ' + state); } geolocation.on('locationServiceState', locationServiceState);
geolocation.off('locationServiceState')
off(type: 'locationServiceState', callback?: Callback) : void;
取消訂閱位置服務(wù)狀態(tài)變化。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“l(fā)ocationServiceState”,表示位置服務(wù)狀態(tài)。 callback Callback 否 接收位置服務(wù)狀態(tài)變化監(jiān)聽。 示例:
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定位結(jié)果上報事件。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
參數(shù):
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“cachedGnssLocationsReporting”,表示GNSS緩存定位結(jié)果上報。 request CachedGnssLocationsRequest 是 GNSS緩存功能配置參數(shù) callback Callback 是 接收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定位結(jié)果上報事件。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
參數(shù):
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“cachedGnssLocationsReporting”,表示GNSS緩存定位結(jié)果上報。 callback Callback 否 接收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衛(wèi)星狀態(tài)信息上報事件。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
參數(shù):
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“gnssStatusChange”,表示訂閱GNSS衛(wèi)星狀態(tài)信息上報。 callback Callback 是 接收GNSS衛(wèi)星狀態(tài)信息上報。 示例:
var gnssStatusCb = (satelliteStatusInfo) = > { console.log('gnssStatusChange: ' + satelliteStatusInfo); } geolocation.on('gnssStatusChange', gnssStatusCb);
geolocation.off('gnssStatusChange')8+
off(type: 'gnssStatusChange', callback?: Callback) : void;
取消訂閱GNSS衛(wèi)星狀態(tài)信息上報事件。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
參數(shù):
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“gnssStatusChange”,表示訂閱GNSS衛(wèi)星狀態(tài)信息上報。 callback Callback 否 接收GNSS衛(wèi)星狀態(tài)信息上報。 示例:
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信息上報事件。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
參數(shù):
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“nmeaMessageChange”,表示訂閱GNSS NMEA信息上報。 callback Callback 是 接收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信息上報事件。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
參數(shù):
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“nmeaMessageChange”,表示訂閱GNSS NMEA信息上報。 callback Callback 否 接收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;
添加一個圍欄,并訂閱地理圍欄事件。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geofence
參數(shù):
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“fenceStatusChange”,表示訂閱圍欄事件上報。 request GeofenceRequest 是 圍欄的配置參數(shù)。 want WantAgent 是 用于接收地理圍欄事件上報(進出圍欄)。 示例:
import WantAgent from '@ohos.wantAgent'; import { OperationType, WantAgentFlags } from '@ohos.wantagent'; //wantAgent對象 var wantAgent; //getWantAgent回調(diào) 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;
刪除一個圍欄,并取消訂閱該圍欄事件。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geofence
參數(shù):
參數(shù)名 類型 必填 說明 type string 是 設(shè)置事件類型。type為“fenceStatusChange”,表示訂閱圍欄事件上報。 request GeofenceRequest 是 圍欄的配置參數(shù)。 want WantAgent 是 用于接收地理圍欄事件上報(進出圍欄)。 示例:
import WantAgent from '@ohos.wantAgent'; import { OperationType, WantAgentFlags } from '@ohos.wantagent'; //wantAgent對象 var wantAgent; //getWantAgent回調(diào) 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
獲取當(dāng)前位置,使用callback回調(diào)異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 request [CurrentLocationRequest] 否 設(shè)置位置請求參數(shù)。 callback AsyncCallback<[Location]> 是 用來接收位置信息的回調(diào)。 示例:
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
獲取當(dāng)前位置,使用Promise方式異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 request [CurrentLocationRequest] 否 設(shè)置位置請求參數(shù)。 返回值:
參數(shù)名 說明 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回調(diào)異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 callback AsyncCallback<[Location]> 是 用來接收上次位置的回調(diào)。 示例:
geolocation.getLastLocation((err, data) = > { console.log('getLastLocation: ' + err + " data: " + JSON.stringify(data)); });
geolocation.getLastLocation
getLastLocation() : Promise
獲取上一次位置,使用Promise方式異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
返回值:
參數(shù)名 說明 Promise<[Location]> 返回上次位置信息。 示例:
geolocation.getLastLocation().then((result) = > { console.log('getLastLocation: result: ' + JSON.stringify(result)); });
geolocation.isLocationEnabled
isLocationEnabled(callback: AsyncCallback) : void
判斷位置服務(wù)是否已經(jīng)打開,使用callback回調(diào)異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 callback AsyncCallback 是 用來接收位置服務(wù)狀態(tài)的回調(diào)。 示例:
geolocation.isLocationEnabled((err, data) = > { console.log('isLocationEnabled: ' + err + " data: " + data); });
geolocation.isLocationEnabled
isLocationEnabled() : Promise
判斷位置服務(wù)是否已經(jīng)開啟,使用Promise方式異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
返回值:
參數(shù)名 說明 Promise 返回位置服務(wù)是否可用的狀態(tài)。 示例:
geolocation.isLocationEnabled().then((result) = > { console.log('promise, isLocationEnabled: ' + result); });
geolocation.requestEnableLocation
requestEnableLocation(callback: AsyncCallback) : void
請求打開位置服務(wù),使用callback回調(diào)異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 callback AsyncCallback 是 用來接收位置服務(wù)狀態(tài)的回調(diào)。 示例:
geolocation.requestEnableLocation((err, data) = > { console.log('requestEnableLocation: ' + err + " data: " + data); });
geolocation.requestEnableLocation
requestEnableLocation() : Promise
請求打開位置服務(wù),使用Promise方式異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
返回值:
參數(shù)名 說明 Promise 返回位置服務(wù)是否可用。 示例:
geolocation.requestEnableLocation().then((result) = > { console.log('promise, requestEnableLocation: ' + result); });
geolocation.enableLocation
enableLocation(callback: AsyncCallback) : void;
打開位置服務(wù),使用callback回調(diào)異步返回結(jié)果。
系統(tǒng)API :此接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 callback AsyncCallback 是 用來接收位置服務(wù)狀態(tài)的回調(diào)。 示例:
geolocation.enableLocation((err, data) = > { console.log('enableLocation: ' + err + " data: " + data); });
geolocation.enableLocation
enableLocation() : Promise
打開位置服務(wù),使用Promise方式異步返回結(jié)果。
系統(tǒng)API :此接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
返回值:
參數(shù)名 說明 Promise 返回位置服務(wù)是否可用。 示例:
geolocation.enableLocation().then((result) = > { console.log('promise, enableLocation: ' + result); });
geolocation.disableLocation
disableLocation(callback: AsyncCallback) : void;
打開位置服務(wù),使用callback回調(diào)異步返回結(jié)果。
系統(tǒng)API :此接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 callback AsyncCallback 是 用來接收位置服務(wù)狀態(tài)的回調(diào)。 示例:
geolocation.disableLocation((err, data) = > { console.log('disableLocation: ' + err + " data: " + data); });
geolocation.disableLocation
disableLocation() : Promise
打開位置服務(wù),使用Promise方式異步返回結(jié)果。
系統(tǒng)API :此接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
返回值:
參數(shù)名 說明 Promise 返回位置服務(wù)是否可用。 示例:
geolocation.disableLocation().then((result) = > { console.log('promise, disableLocation: ' + result); });
geolocation.isGeoServiceAvailable
isGeoServiceAvailable(callback: AsyncCallback) : void
判斷(逆)地理編碼服務(wù)狀態(tài),使用callback回調(diào)異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geocoder
參數(shù):
參數(shù)名 類型 必填 說明 callback AsyncCallback 是 用來接收地理編碼服務(wù)狀態(tài)的回調(diào)。 示例:
geolocation.isGeoServiceAvailable((err, data) = > { console.log('isGeoServiceAvailable: ' + err + " data: " + data); });
geolocation.isGeoServiceAvailable
isGeoServiceAvailable() : Promise
判斷(逆)地理編碼服務(wù)狀態(tài),使用Promise方式異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geocoder
返回值:
參數(shù)名 說明 Promise 返回地理編碼服務(wù)是否可用的狀態(tài)。 示例:
geolocation.isGeoServiceAvailable().then((result) = > { console.log('promise, isGeoServiceAvailable: ' + result); });
geolocation.getAddressesFromLocation
getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback>) : void
調(diào)用逆地理編碼服務(wù),將坐標(biāo)轉(zhuǎn)換為地理描述,使用callback回調(diào)異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geocoder
參數(shù):
參數(shù)名 類型 必填 說明 request [ReverseGeoCodeRequest] 是 設(shè)置逆地理編碼請求的相關(guān)參數(shù)。 callback AsyncCallback> 是 設(shè)置接收逆地理編碼請求的回調(diào)參數(shù)。 示例:
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>;
調(diào)用逆地理編碼服務(wù),將坐標(biāo)轉(zhuǎn)換為地理描述,使用Promise方式異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geocoder
參數(shù):
參數(shù)名 類型 必填 說明 request [ReverseGeoCodeRequest] 是 設(shè)置逆地理編碼請求的相關(guān)參數(shù)。 返回值:
參數(shù)名 說明 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
調(diào)用地理編碼服務(wù),將地理描述轉(zhuǎn)換為具體坐標(biāo),使用callback回調(diào)異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geocoder
參數(shù):
參數(shù)名 類型 必填 說明 request [GeoCodeRequest] 是 設(shè)置地理編碼請求的相關(guān)參數(shù)。 callback AsyncCallback> 是 設(shè)置接收地理編碼請求的回調(diào)參數(shù)。 示例:
var geocodeRequest = {"description": "上海市浦東新區(qū)xx路xx號", "maxItems": 1}; geolocation.getAddressesFromLocationName(geocodeRequest, (err, data) = > { console.log('getAddressesFromLocationName: ' + err + " data: " + JSON.stringify(data)); });
geolocation.getAddressesFromLocationName
getAddressesFromLocationName(request: GeoCodeRequest) : Promise>
調(diào)用地理編碼服務(wù),將地理描述轉(zhuǎn)換為具體坐標(biāo),使用Promise方式異步返回結(jié)果。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geocoder
參數(shù):
參數(shù)名 類型 必填 說明 request [GeoCodeRequest] 是 設(shè)置地理編碼請求的相關(guān)參數(shù)。 返回值:
參數(shù)名 說明 Promise> 設(shè)置接收地理編碼請求的回調(diào)參數(shù)。 示例:
var geocodeRequest = {"description": "上海市浦東新區(qū)xx路xx號", "maxItems": 1}; geolocation.getAddressesFromLocationName(geocodeRequest).then((result) = > { console.log('getAddressesFromLocationName: ' + JSON.stringify(result)); });
geolocation.getCachedGnssLocationsSize8+
getCachedGnssLocationsSize(callback: AsyncCallback) : void;
獲取GNSS芯片緩存位置的個數(shù)。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
參數(shù):
參數(shù)名 類型 必填 說明 callback AsyncCallback 是 用來接收GNSS芯片緩存位置個數(shù)的回調(diào)。 示例:
geolocation.getCachedGnssLocationsSize((err, size) = > { console.log('getCachedGnssLocationsSize: err:' + err + " size: " + size); });
geolocation.getCachedGnssLocationsSize8+
getCachedGnssLocationsSize() : Promise;
獲取GNSS芯片緩存位置的個數(shù)。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
返回值:
參數(shù)名 說明 Promise 返回GNSS緩存位置的個數(shù)。 示例:
geolocation.getCachedGnssLocationsSize().then((result) = > { console.log('promise, getCachedGnssLocationsSize: ' + result); });
geolocation.flushCachedGnssLocations8+
flushCachedGnssLocations(callback: AsyncCallback) : void;
讀取并清空GNSS芯片所有緩存位置。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
參數(shù):
參數(shù)名 類型 必填 說明 callback AsyncCallback 是 用來接收清空GNSS芯片緩存位置操作的結(jié)果。 示例:
geolocation.flushCachedGnssLocations((err, result) = > { console.log('flushCachedGnssLocations: err:' + err + " result: " + result); });
geolocation.flushCachedGnssLocations8+
flushCachedGnssLocations() : Promise;
讀取并清空GNSS芯片所有緩存位置。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
返回值:
參數(shù)名 說明 Promise 清空所有GNSS緩存位置是否成功。 示例:
geolocation.flushCachedGnssLocations().then((result) = > { console.log('promise, flushCachedGnssLocations: ' + result); });
geolocation.sendCommand8+
sendCommand(command: LocationCommand, callback: AsyncCallback) : void;
給位置服務(wù)子系統(tǒng)的各個部件發(fā)送擴展命令。只有系統(tǒng)應(yīng)用才能調(diào)用。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 command LocationCommand 是 指定目標(biāo)場景,和將要發(fā)送的命令(字符串)。 callback AsyncCallback 是 用來接收命令發(fā)送的結(jié)果。 示例:
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;
給位置服務(wù)子系統(tǒng)的各個部件發(fā)送擴展命令。只有系統(tǒng)應(yīng)用才能調(diào)用。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 command LocationCommand 是 指定目標(biāo)場景,和將要發(fā)送的命令(字符串)。 返回值:
參數(shù)名 說明 Promise 表示命令發(fā)送成功或失敗。 示例:
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;
查詢用戶是否同意定位服務(wù)隱私申明,是否同意啟用定位服務(wù)。只有系統(tǒng)應(yīng)用才能調(diào)用。
系統(tǒng)API :此接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 type LocationPrivacyType 是 指定隱私申明場景,例如開機向?qū)е械碾[私申明、開啟網(wǎng)絡(luò)定位功能時彈出的隱私申明等。 callback AsyncCallback 是 表示用戶是否同意定位服務(wù)隱私申明。 示例:
geolocation.isLocationPrivacyConfirmed(1, (err, result) = > { console.log('isLocationPrivacyConfirmed: err:' + err + " result: " + result); });
geolocation.isLocationPrivacyConfirmed8+
isLocationPrivacyConfirmed(type : LocationPrivacyType,) : Promise;
查詢用戶是否同意定位服務(wù)隱私申明,是否同意啟用定位服務(wù)。只有系統(tǒng)應(yīng)用才能調(diào)用。
系統(tǒng)API :此接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 type LocationPrivacyType 是 指定隱私申明場景,例如開機向?qū)е械碾[私申明、開啟網(wǎng)絡(luò)定位功能時彈出的隱私申明等。 返回值:
參數(shù)名 說明 Promise 表示用戶是否同意定位服務(wù)隱私申明。 示例:
geolocation.isLocationPrivacyConfirmed(1).then((result) = > { console.log('promise, isLocationPrivacyConfirmed: ' + result); });
geolocation.setLocationPrivacyConfirmStatus8+
setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed: boolean, callback: AsyncCallback) : void;
設(shè)置用戶勾選定位服務(wù)隱私申明的狀態(tài),記錄用戶是否同意啟用定位服務(wù)。只有系統(tǒng)應(yīng)用才能調(diào)用。
系統(tǒng)API :此接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 type LocationPrivacyType 是 指定隱私申明場景,例如開機向?qū)е械碾[私申明、開啟網(wǎng)絡(luò)定位功能時彈出的隱私申明等。 isConfirmed boolean 是 表示用戶是否同意定位服務(wù)隱私申明。 callback AsyncCallback 是 表示操作是否成功。 示例:
geolocation.setLocationPrivacyConfirmStatus(1, true, (err, result) = > { console.log('isLocationPrivacyConfirmed: err:' + err + " result: " + result); });
geolocation.setLocationPrivacyConfirmStatus8+
setLocationPrivacyConfirmStatus(type : LocationPrivacyType, isConfirmed : boolean) : Promise;
設(shè)置用戶勾選定位服務(wù)隱私申明的狀態(tài),記錄用戶是否同意啟用定位服務(wù)。只有系統(tǒng)應(yīng)用才能調(diào)用。
系統(tǒng)API :此接口為系統(tǒng)接口,三方應(yīng)用不支持調(diào)用。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
參數(shù):
參數(shù)名 類型 必填 說明 type LocationPrivacyType 是 指定隱私申明場景,例如開機向?qū)е械碾[私申明、開啟網(wǎng)絡(luò)定位功能時彈出的隱私申明等。 isConfirmed boolean 是 表示用戶是否同意定位服務(wù)隱私申明。 返回值:
參數(shù)名 說明 Promise 表示操作是否成功。 示例:
geolocation.setLocationPrivacyConfirmStatus(1, true).then((result) = > { console.log('promise, setLocationPrivacyConfirmStatus: ' + result); });
LocationRequestPriority
位置請求中位置信息優(yōu)先級設(shè)置。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
名稱 | 默認(rèn)值 | 說明 |
---|---|---|
UNSET | 0x200 | 表示未設(shè)置優(yōu)先級。 |
ACCURACY | 0x201 | 表示精度優(yōu)先。 |
LOW_POWER | 0x202 | 表示低功耗優(yōu)先。 |
FIRST_FIX | 0x203 | 表示快速獲取位置優(yōu)先,如果應(yīng)用希望快速拿到1個位置,可以將優(yōu)先級設(shè)置為該字段。 |
LocationRequestScenario
位置請求中定位場景設(shè)置。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
名稱 | 默認(rèn)值 | 說明 |
---|---|---|
UNSET | 0x300 | 表示未設(shè)置場景信息。 |
NAVIGATION | 0x301 | 表示導(dǎo)航場景。 |
TRAJECTORY_TRACKING | 0x302 | 表示運動軌跡記錄場景。 |
CAR_HAILING | 0x303 | 表示打車場景。 |
DAILY_LIFE_SERVICE | 0x304 | 表示日常服務(wù)使用場景。 |
NO_POWER | 0x305 | 表示無功耗功場景,這種場景下不會主動觸發(fā)定位,會在其他應(yīng)用定位時,才給當(dāng)前應(yīng)用返回位置。 |
GeoLocationErrorCode
位置服務(wù)中的錯誤碼信息。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
名稱 | 默認(rèn)值 | 說明 |
---|---|---|
INPUT_PARAMS_ERROR | 101 | 表示輸入?yún)?shù)錯誤。 |
REVERSE_GEOCODE_ERROR | 102 | 表示逆地理編碼接口調(diào)用失敗。 |
GEOCODE_ERROR | 103 | 表示地理編碼接口調(diào)用失敗。 |
LOCATOR_ERROR | 104 | 表示定位失敗。 |
LOCATION_SWITCH_ERROR | 105 | 表示定位開關(guān)。 |
LAST_KNOWN_LOCATION_ERROR | 106 | 表示獲取上次位置失敗。 |
LOCATION_REQUEST_TIMEOUT_ERROR | 107 | 表示單次定位,沒有在指定時間內(nèi)返回位置。 |
ReverseGeoCodeRequest
逆地理編碼請求接口。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geocoder
名稱 | 參數(shù)類型 | 必填 | 說明 |
---|---|---|---|
locale | string | 否 | 指定位置描述信息的語言,“zh”代表中文,“en”代表英文。 |
latitude | number | 是 | 表示緯度信息,正值表示北緯,負(fù)值表示南緯。 |
longitude | number | 是 | 表示經(jīng)度信息,正值表示東經(jīng),負(fù)值表示西經(jīng)。 |
maxItems | number | 否 | 指定返回位置信息的最大個數(shù)。 |
GeoCodeRequest
地理編碼請求接口。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geocoder
名稱 | 參數(shù)類型 | 必填 | 說明 |
---|---|---|---|
locale | string | 否 | 表示位置描述信息的語言,“zh”代表中文,“en”代表英文。 |
description | number | 是 | 表示位置信息描述,如“上海市浦東新區(qū)xx路xx號”。 |
maxItems | number | 否 | 表示返回位置信息的最大個數(shù)。 |
minLatitude | number | 否 | 表示最小緯度信息,與下面三個參數(shù)一起,表示一個經(jīng)緯度范圍。 |
minLongitude | number | 否 | 表示最小經(jīng)度信息。 |
maxLatitude | number | 否 | 表示最大緯度信息。 |
maxLongitude | number | 否 | 表示最大經(jīng)度信息。 |
GeoAddress
地理編碼類型。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geocoder
名稱 | 參數(shù)類型 | 必填 | 說明 |
---|---|---|---|
latitude | number | 否 | 表示緯度信息,正值表示北緯,負(fù)值表示南緯。 |
longitude | number | 否 | 表示經(jīng)度信息,正值表示東經(jīng),負(fù)值表是西經(jīng)。 |
locale | string | 否 | 表示位置描述信息的語言,“zh”代表中文,“en”代表英文。 |
placeName | string | 否 | 表示地區(qū)信息。 |
countryCode | string | 否 | 表示國家碼信息。 |
countryName | string | 否 | 表示國家信息。 |
administrativeArea | string | 否 | 表示省份區(qū)域信息。 |
subAdministrativeArea | string | 否 | 表示表示子區(qū)域信息。 |
locality | string | 否 | 表示城市信息。 |
subLocality | string | 否 | 表示子城市信息。 |
roadName | string | 否 | 表示路名信息。 |
subRoadName | string | 否 | 表示子路名信息。 |
premises | string | 否 | 表示門牌號信息。 |
postalCode | string | 否 | 表示郵政編碼信息。 |
phoneNumber | string | 否 | 表示聯(lián)系方式信息。 |
addressUrl | string | 否 | 表示位置信息附件的網(wǎng)址信息。 |
descriptions | Array | 否 | 表示附加的描述信息。 |
descriptionsSize | number | 否 | 表示附加的描述信息數(shù)量。 |
LocationRequest
位置信息請求類型。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
名稱 | 參數(shù)類型 | 必填 | 說明 |
---|---|---|---|
priority | [LocationRequestPriority] | 否 | 表示優(yōu)先級信息。 |
scenario | [LocationRequestScenario] | 是 | 表示場景信息。 |
timeInterval | number | 否 | 表示上報位置信息的時間間隔。 |
distanceInterval | number | 否 | 表示上報位置信息的距離間隔。 |
maxAccuracy | number | 否 | 表示精度信息。 |
CurrentLocationRequest
當(dāng)前位置信息請求類型。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
名稱 | 參數(shù)類型 | 必填 | 說明 |
---|---|---|---|
priority | [LocationRequestPriority] | 否 | 表示優(yōu)先級信息。 |
scenario | [LocationRequestScenario] | 否 | 表示場景信息。 |
maxAccuracy | number | 否 | 表示精度信息,單位是米。 |
timeoutMs | number | 否 | 表示超時時間,單位是毫秒,最小為1000毫秒。 |
SatelliteStatusInfo8+
衛(wèi)星狀態(tài)信息。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
名稱 | 參數(shù)類型 | 必填 | 說明 |
---|---|---|---|
satellitesNumber | number | 是 | 表示衛(wèi)星個數(shù)。 |
satelliteIds | Array | 是 | 表示每個衛(wèi)星的ID,數(shù)組類型。 |
carrierToNoiseDensitys | Array | 是 | 表示載波噪聲功率譜密度比,即cn0。 |
altitudes | Array | 是 | 表示高程信息。 |
azimuths | Array | 是 | 表示方位角。 |
carrierFrequencies | Array | 是 | 表示載波頻率。 |
CachedGnssLocationsRequest8+
請求訂閱GNSS緩存位置上報功能接口的配置參數(shù)。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Gnss
名稱 | 參數(shù)類型 | 必填 | 說明 |
---|---|---|---|
reportingPeriodSec | number | 是 | 表示GNSS緩存位置上報的周期,單位是毫秒。 |
wakeUpCacheQueueFull | boolean | 是 | true表示GNSS芯片底層緩存隊列滿之后會主動喚醒AP芯片,并把緩存位置上報給應(yīng)用。 false表示GNSS芯片底層緩存隊列滿之后不會主動喚醒AP芯片,會把緩存位置直接丟棄。 |
Geofence8+
GNSS圍欄的配置參數(shù)。目前只支持圓形圍欄。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geofence
名稱 | 參數(shù)類型 | 必填 | 說明 |
---|---|---|---|
latitude | number | 是 | 表示緯度。 |
longitude | number | 是 | 表示經(jīng)度。 |
radius | number | 是 | 表示圓形圍欄的半徑。 |
expiration | number | 是 | 圍欄存活的時間,單位是毫秒。 |
GeofenceRequest8+
請求添加GNSS圍欄消息中攜帶的參數(shù),包括定位優(yōu)先級、定位場景和圍欄信息。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Geofence
名稱 | 參數(shù)類型 | 必填 | 說明 |
---|---|---|---|
priority | LocationRequestPriority | 是 | 表示位置信息優(yōu)先級。 |
scenario | LocationRequestScenario | 是 | 表示定位場景。 |
geofence | Geofence | 是 | 表示圍欄信息。 |
LocationPrivacyType8+
定位服務(wù)隱私協(xié)議類型。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
名稱 | 默認(rèn)值 | 說明 |
---|---|---|
OTHERS | 0 | 其他場景。 |
STARTUP | 1 | 開機向?qū)鼍跋碌碾[私協(xié)議。 |
CORE_LOCATION | 2 | 開啟網(wǎng)絡(luò)定位時彈出的隱私協(xié)議。 |
LocationCommand8+
擴展命令結(jié)構(gòu)體。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
名稱 | 參數(shù)類型 | 必填 | 說明 |
---|---|---|---|
scenario | LocationRequestScenario | 是 | 表示定位場景。 |
command | string | 是 | 擴展命令字符串。HarmonyOS與OpenHarmony鴻蒙文檔籽料:mau123789是v直接拿 |
Location
位置信息類型。
需要權(quán)限 :ohos.permission.LOCATION
系統(tǒng)能力 :SystemCapability.Location.Location.Core
名稱 | 參數(shù)類型 | 必填 | 說明 |
---|---|---|---|
latitude | number | 是 | 表示緯度信息,正值表示北緯,負(fù)值表示南緯。 |
longitude | number | 是 | 表示經(jīng)度信息,正值表示東經(jīng),負(fù)值表是西經(jīng)。 |
altitude | number | 是 | 表示高度信息,單位米。 |
accuracy | number | 是 | 表示精度信息,單位米。 |
speed | number | 是 | 表示速度信息,單位米每秒。 |
timeStamp | number | 是 | 表示位置時間戳,UTC格式。 |
direction | number | 是 | 表示航向信息。 |
timeSinceBoot | number | 是 | 表示位置時間戳,開機時間格式。 |
additions | Array | 否 | 附加信息。 |
additionSize | number | 否 | 附加信息數(shù)量。 |
審核編輯 黃宇
-
設(shè)備管理
+關(guān)注
關(guān)注
0文章
116瀏覽量
9319 -
鴻蒙
+關(guān)注
關(guān)注
57文章
2371瀏覽量
42910
發(fā)布評論請先 登錄
相關(guān)推薦
評論