0
代码
代码
Issues
Pull Requests
讨论
Wiki
分析
0
RayShihRayShihsync changelogs files
857a40a8创建于 2023年6月7日历史提交

位置服务子系统ChangeLog

cl.location.1 @ohos.geolocation.d.ts接口迁移到新增的@ohos.geoLocationManager.d.ts

@ohos.geolocation.d.ts接口不支持抛出错误码，为了支持错误码功能，把@ohos.geolocation.d.ts中所有接口，迁移到新增的@ohos.geoLocationManager.d.ts中，并增加错误码描述。

后续需要import @ohos.geoLocationManager才能使用位置服务的接口：

import geoLocationManager from '@ohos.geoLocationManager';

变更影响

对位置服务所有接口的使用有影响，需要import @ohos.geoLocationManager才能使用位置服务接口：

import geoLocationManager from '@ohos.geoLocationManager';

关键的接口/组件变更

类名 接口类型 接口声明 变更类型
geolocation method function on(type: 'locationChange', request: LocationRequest, callback: Callback): void; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function off(type: 'locationChange', callback?: Callback): void; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function on(type: 'locationServiceState', callback: Callback): void; 接口迁移到@ohos.geoLocationManager.d.ts，type: 'locationServiceState'更改为type: 'locationEnabledChange'
geolocation method function off(type: 'locationServiceState', callback?: Callback): void; 接口迁移到@ohos.geoLocationManager.d.ts，type: 'locationServiceState'更改为type: 'locationEnabledChange'
geolocation method function on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, callback: Callback<Array>): void; 接口迁移到@ohos.geoLocationManager.d.ts，type: 'cachedGnssLocationsReporting'更改为type: 'cachedGnssLocationsChange'
geolocation method function off(type: 'cachedGnssLocationsReporting', callback?: Callback<Array>): void; 接口迁移到@ohos.geoLocationManager.d.ts，type: 'cachedGnssLocationsReporting'更改为type: 'cachedGnssLocationsChange'
geolocation method function on(type: 'gnssStatusChange', callback: Callback): void; 接口迁移到@ohos.geoLocationManager.d.ts，type: 'gnssStatusChange'更改为type: 'satelliteStatusChange'
geolocation method function off(type: 'gnssStatusChange', callback?: Callback): void; 接口迁移到@ohos.geoLocationManager.d.ts，type: 'gnssStatusChange'更改为type: 'satelliteStatusChange'
geolocation method function on(type: 'nmeaMessageChange', callback: Callback): void; 接口迁移到@ohos.geoLocationManager.d.ts，type: 'nmeaMessageChange'更改为type: 'nmeaMessage'
geolocation method function off(type: 'nmeaMessageChange', callback?: Callback): void; 接口迁移到@ohos.geoLocationManager.d.ts，type: 'nmeaMessageChange'更改为type: 'nmeaMessage'
geolocation method function on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent): void; 接口迁移到@ohos.geoLocationManager.d.ts，type: 'fenceStatusChange'更改为type: 'gnssFenceStatusChange'
geolocation method function off(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent): void; 接口迁移到@ohos.geoLocationManager.d.ts，type: 'fenceStatusChange'更改为type: 'gnssFenceStatusChange'
geolocation method function getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function getCurrentLocation(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function getCurrentLocation(request?: CurrentLocationRequest): Promise; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function getLastLocation(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function getLastLocation(): Location;
geolocation method function getLastLocation(): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function getLastLocation(): Location;
geolocation method function isLocationEnabled(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function isLocationEnabled(): boolean;
geolocation method function isLocationEnabled(): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function isLocationEnabled(): boolean;
geolocation method function requestEnableLocation(callback: AsyncCallback): void; 接口删除
geolocation method function requestEnableLocation(): Promise; 接口删除
geolocation method function enableLocation(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function enableLocation(): Promise; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function disableLocation(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function disableLocation(): void;
geolocation method function disableLocation(): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function disableLocation(): void;
geolocation method function getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback<Array>): void; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function getAddressesFromLocation(request: ReverseGeoCodeRequest): Promise<Array>; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback<Array>): void; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function getAddressesFromLocationName(request: GeoCodeRequest): Promise<Array>; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function isGeoServiceAvailable(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function isGeocoderAvailable(): boolean;
geolocation method function isGeoServiceAvailable(): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function isGeocoderAvailable(): boolean;
geolocation method function getCachedGnssLocationsSize(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function getCachedGnssLocationsSize(): Promise; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function flushCachedGnssLocations(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function flushCachedGnssLocations(): Promise; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function sendCommand(command: LocationCommand, callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function sendCommand(command: LocationCommand): Promise; 接口迁移到@ohos.geoLocationManager.d.ts
geolocation method function enableLocationMock(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function enableLocationMock(): void;
geolocation method function enableLocationMock(): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function enableLocationMock(): void;
geolocation method function disableLocationMock(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function disableLocationMock(): void;
geolocation method function disableLocationMock(): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function disableLocationMock(): void;
geolocation method function setMockedLocations(config: LocationMockConfig, callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function setMockedLocations(config: LocationMockConfig): void;
geolocation method function setMockedLocations(config: LocationMockConfig): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function setMockedLocations(config: LocationMockConfig): void;
geolocation method function enableReverseGeocodingMock(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function enableReverseGeocodingMock(): void;
geolocation method function enableReverseGeocodingMock(): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function enableReverseGeocodingMock(): void;
geolocation method function disableReverseGeocodingMock(callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function disableReverseGeocodingMock(): void;
geolocation method function disableReverseGeocodingMock(): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function disableReverseGeocodingMock(): void;
geolocation method function setReverseGeocodingMockInfo(mockInfos: Array, callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function setReverseGeocodingMockInfo(mockInfos: Array): void;
geolocation method function setReverseGeocodingMockInfo(mockInfos: Array): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function setReverseGeocodingMockInfo(mockInfos: Array): void;
geolocation method function isLocationPrivacyConfirmed(type: LocationPrivacyType, callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function isLocationPrivacyConfirmed(type: LocationPrivacyType): boolean;
geolocation method function isLocationPrivacyConfirmed(type: LocationPrivacyType,): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function isLocationPrivacyConfirmed(type: LocationPrivacyType): boolean;
geolocation method function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean, callback: AsyncCallback): void; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): void;
geolocation method function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): Promise; 接口迁移到@ohos.geoLocationManager.d.ts，更改为function setLocationPrivacyConfirmStatus(type: LocationPrivacyType, isConfirmed: boolean): void;
geolocation interface SatelliteStatusInfo 接口迁移到@ohos.geoLocationManager.d.ts
geolocation interface CachedGnssLocationsRequest 接口迁移到@ohos.geoLocationManager.d.ts
geolocation interface GeofenceRequest 接口迁移到@ohos.geoLocationManager.d.ts
geolocation interface Geofence 接口迁移到@ohos.geoLocationManager.d.ts
geolocation interface ReverseGeoCodeRequest 接口迁移到@ohos.geoLocationManager.d.ts
geolocation interface GeoCodeRequest 接口迁移到@ohos.geoLocationManager.d.ts
geolocation interface GeoAddress 接口迁移到@ohos.geoLocationManager.d.ts
geolocation interface LocationRequest 接口迁移到@ohos.geoLocationManager.d.ts
geolocation interface CurrentLocationRequest 接口迁移到@ohos.geoLocationManager.d.ts
geolocation interface Location 接口迁移到@ohos.geoLocationManager.d.ts
geolocation enum LocationRequestPriority 接口迁移到@ohos.geoLocationManager.d.ts
geolocation enum LocationRequestScenario 接口迁移到@ohos.geoLocationManager.d.ts
geolocation enum GeoLocationErrorCode 接口废弃
geolocation enum LocationPrivacyType 接口迁移到@ohos.geoLocationManager.d.ts
geolocation enum LocationCommand 接口迁移到@ohos.geoLocationManager.d.ts

适配指导（可选，不涉及则可以删除）

以enableLocation为例，在新版本上需要使用如下方式进行调用：

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