简介
移动终端设备已经深入人们日常生活的方方面面,如查看所在城市的天气、新闻轶事、出行打车、旅行导航、运动记录。这些习以为常的活动,都离不开定位用户终端设备的位置。
当用户处于这些丰富的使用场景中时,系统的位置定位能力可以提供实时准确的位置数据。对于开发者,设计基于位置体验的服务,也可以更好的满足用户的需求。
当应用在实现基于设备位置的功能时,如:驾车导航,记录运动轨迹等,可以调用该模块的API接口,完成位置信息的获取
基本概念
位置能力用于确定用户设备在哪里,系统使用位置坐标标示用户设备的位置,并使用多种定位技术提供位置服务,如GNSS定位、基站定位、WLAN/蓝牙定位(基站定位、WLAN/蓝牙定位后续统称“网络定位技术”)。通过这些定位技术,无论用户设备在室内或是户外,都可以准确地确定用户设备的位置。
-
坐标
系统以1984年世界大地坐标系统为参考,使用经度、纬度数据描述地球上的一个位置。
-
GNSS定位
基于全球导航卫星系统,包含:GPS、GLONASS、北斗、Galileo等,通过导航卫星,设备芯片提供的定位算法,来确定设备准确位置。定位过程具体使用哪些定位系统,取决于用户设备的硬件能力。
-
基站定位
根据设备当前驻网基站和相邻基站的位置,估算设备当前位置。此定位方式的定位结果精度相对较低,并且需要设备可以访问蜂窝网络。
-
WLAN、蓝牙定位
根据设备可搜索到的周围WLAN、蓝牙设备位置,估算设备当前位置。此定位方式的定位结果精度依赖设备周围可见的固定WLAN、蓝牙设备的分布,密度较高时,精度也相较与基站定位方式更高,同时也需要设备可以访问网络。
更多鸿蒙知识更新在gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md
参考前往学习。
约束
- 使用设备的位置能力,需要用户进行确认并主动开启位置开关。如果位置开关没有开启,系统不会向任何应用提供位置服务。
- 设备位置信息属于用户敏感数据,所以即使用户已经开启位置开关,应用在获取设备位置前仍需向用户申请位置访问权限。在用户确认允许后,系统才会向应用提供位置服务。
说明
接口说明
/** Copyright (c) 2022 Huawei Device Co., Ltd.* Licensed under the Apache License, Version 2.0 (the "License");* you may not use this file except in compliance with the License.* You may obtain a copy of the License at** http://www.apache.org/licenses/LICENSE-2.0** Unless required by applicable law or agreed to in writing, software* distributed under the License is distributed on an "AS IS" BASIS,* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.* See the License for the specific language governing permissions and* limitations under the License.*//*** @file* @kit LocationKit*/import { AsyncCallback, Callback } from './@ohos.base';import { WantAgent } from './@ohos.wantAgent';/*** Provides interfaces for initiating location requests, ending the location service,* and obtaining the location result cached by the system.** @namespace geolocation* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/declare namespace geolocation {/*** Subscribe location changed** @permission ohos.permission.LOCATION* @param { 'locationChange' } type - Indicates the location service event to be subscribed to.* @param { LocationRequest } request - Indicates the location request parameters.* @param { Callback<Location> } callback - Indicates the callback for reporting the location result.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.on#event:locationChange*/function on(type: 'locationChange', request: LocationRequest, callback: Callback<Location>): void;/*** Unsubscribe location changed** @permission ohos.permission.LOCATION* @param { 'locationChange' } type - Indicates the location service event to be subscribed to.* @param { Callback<Location> } [callback] - Indicates the callback for reporting the location result.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.off#event:locationChange*/function off(type: 'locationChange', callback?: Callback<Location>): void;/*** Subscribe location switch changed** @permission ohos.permission.LOCATION* @param { 'locationServiceState' } type - Indicates the location service event to be subscribed to.* @param { Callback<boolean> } callback - Indicates the callback for reporting the location result.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.on#event:locationEnabledChange*/function on(type: 'locationServiceState', callback: Callback<boolean>): void;/*** Unsubscribe location switch changed** @permission ohos.permission.LOCATION* @param { 'locationServiceState' } type - Indicates the location service event to be subscribed to.* @param { Callback<boolean> } [callback] - Indicates the callback for reporting the location result.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.off#event:locationEnabledChange*/function off(type: 'locationServiceState', callback?: Callback<boolean>): void;/*** Subscribe to cache GNSS locations update messages** @permission ohos.permission.LOCATION* @param { 'cachedGnssLocationsReporting' } type - Indicates the location service event to be subscribed to.* @param { CachedGnssLocationsRequest } request - Indicates the cached GNSS locations request parameters.* @param { Callback<Array<Location>> } callback - Indicates the callback for reporting the cached GNSS locations.* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.on#event:cachedGnssLocationsChange*/function on(type: 'cachedGnssLocationsReporting', request: CachedGnssLocationsRequest, callback: Callback<Array<Location>>): void;/*** Unsubscribe to cache GNSS locations update messages** @permission ohos.permission.LOCATION* @param { 'cachedGnssLocationsReporting' } type - Indicates the location service event to be subscribed to.* @param { Callback<Array<Location>> } [callback] - Indicates the callback for reporting the cached gnss locations.* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.off#event:cachedGnssLocationsChange*/function off(type: 'cachedGnssLocationsReporting', callback?: Callback<Array<Location>>): void;/*** Subscribe gnss status changed** @permission ohos.permission.LOCATION* @param { 'gnssStatusChange' } type - Indicates the location service event to be subscribed to.* @param { Callback<SatelliteStatusInfo> } callback - Indicates the callback for reporting the gnss status change.* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.on#event:satelliteStatusChange*/function on(type: 'gnssStatusChange', callback: Callback<SatelliteStatusInfo>): void;/*** Unsubscribe gnss status changed** @permission ohos.permission.LOCATION* @param { 'gnssStatusChange' } type - Indicates the location service event to be subscribed to.* @param { Callback<SatelliteStatusInfo> } [callback] - Indicates the callback for reporting the gnss status change.* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.off#event:satelliteStatusChange*/function off(type: 'gnssStatusChange', callback?: Callback<SatelliteStatusInfo>): void;/*** Subscribe nmea message changed** @permission ohos.permission.LOCATION* @param { 'nmeaMessageChange' } type - Indicates the location service event to be subscribed to.* @param { Callback<string> } callback - Indicates the callback for reporting the nmea message.* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.on#event:nmeaMessage*/function on(type: 'nmeaMessageChange', callback: Callback<string>): void;/*** Unsubscribe nmea message changed** @permission ohos.permission.LOCATION* @param { 'nmeaMessageChange' } type - Indicates the location service event to be subscribed to.* @param { Callback<string> } [callback] - Indicates the callback for reporting the nmea message.* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.off#event:nmeaMessage*/function off(type: 'nmeaMessageChange', callback?: Callback<string>): void;/*** Add a geofence and subscribe geo fence status changed** @permission ohos.permission.LOCATION* @param { 'fenceStatusChange' } type - Indicates the location service event to be subscribed to.* @param { GeofenceRequest } request - Indicates the Geo-fence configuration parameters.* @param { WantAgent } want - Indicates which ability to start when the geofence event is triggered.* @syscap SystemCapability.Location.Location.Geofence* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.on#event:gnssFenceStatusChange*/function on(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent): void;/*** Remove a geofence and unsubscribe geo fence status changed** @permission ohos.permission.LOCATION* @param { 'fenceStatusChange' } type - Indicates the location service event to be subscribed to.* @param { GeofenceRequest } request - Indicates the Geo-fence configuration parameters.* @param { WantAgent } want - Indicates which ability to start when the geofence event is triggered.* @syscap SystemCapability.Location.Location.Geofence* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.off#event:gnssFenceStatusChange*/function off(type: 'fenceStatusChange', request: GeofenceRequest, want: WantAgent): void;/*** Obtain current location** @permission ohos.permission.LOCATION* @param { CurrentLocationRequest } request - Indicates the location request parameters.* @param { AsyncCallback<Location> } callback - Indicates the callback for reporting the location result.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.getCurrentLocation*/function getCurrentLocation(request: CurrentLocationRequest, callback: AsyncCallback<Location>): void;/*** Obtain current location** @permission ohos.permission.LOCATION* @param { AsyncCallback<Location> } callback - Indicates the callback for reporting the location result.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.getCurrentLocation*/function getCurrentLocation(callback: AsyncCallback<Location>): void;/*** Obtain current location** @permission ohos.permission.LOCATION* @param { CurrentLocationRequest } [request] - Indicates the location request parameters.* @returns { Promise<Location> } The promise returned by the function.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.getCurrentLocation*/function getCurrentLocation(request?: CurrentLocationRequest): Promise<Location>;/*** Obtain last known location** @permission ohos.permission.LOCATION* @param { AsyncCallback<Location> } callback - Indicates the callback for reporting the location result.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.getLastLocation*/function getLastLocation(callback: AsyncCallback<Location>): void;/*** Obtain last known location** @permission ohos.permission.LOCATION* @returns { Promise<Location> } The promise returned by the function.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.getLastLocation*/function getLastLocation(): Promise<Location>;/*** Obtain current location switch status** @permission ohos.permission.LOCATION* @param { AsyncCallback<boolean> } callback - Indicates the callback for reporting the location switch result.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.isLocationEnabled*/function isLocationEnabled(callback: AsyncCallback<boolean>): void;/*** Obtain current location switch status** @permission ohos.permission.LOCATION* @returns { Promise<boolean> } The promise returned by the function.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.isLocationEnabled*/function isLocationEnabled(): Promise<boolean>;/*** Request enable location** @permission ohos.permission.LOCATION* @param { AsyncCallback<boolean> } callback - Indicates the callback for reporting the location switch status.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/function requestEnableLocation(callback: AsyncCallback<boolean>): void;/*** Request enable location** @permission ohos.permission.LOCATION* @returns { Promise<boolean> } The promise returned by the function.* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/function requestEnableLocation(): Promise<boolean>;/*** Obtain address info from location** @permission ohos.permission.LOCATION* @param { ReverseGeoCodeRequest } request - Indicates the reverse geocode query parameters.* @param { AsyncCallback<Array<GeoAddress>> } callback - Indicates the callback for reporting the address info.* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.getAddressesFromLocation*/function getAddressesFromLocation(request: ReverseGeoCodeRequest, callback: AsyncCallback<Array<GeoAddress>>): void;/*** Obtain address info from location** @permission ohos.permission.LOCATION* @param { ReverseGeoCodeRequest } request - Indicates the reverse geocode query parameters.* @returns { Promise<Array<GeoAddress>> } The promise returned by the function.* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.getAddressesFromLocation*/function getAddressesFromLocation(request: ReverseGeoCodeRequest): Promise<Array<GeoAddress>>;/*** Obtain latitude and longitude info from location address** @permission ohos.permission.LOCATION* @param { GeoCodeRequest } request - Indicates the geocode query parameters.* @param { AsyncCallback<Array<GeoAddress>> } callback - Indicates the callback for reporting the latitude and longitude result.* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.getAddressesFromLocationName*/function getAddressesFromLocationName(request: GeoCodeRequest, callback: AsyncCallback<Array<GeoAddress>>): void;/*** Obtain latitude and longitude info from location address** @permission ohos.permission.LOCATION* @param { GeoCodeRequest } request - Indicates the geocode query parameters.* @returns { Promise<Array<GeoAddress>> } The promise returned by the function.* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.getAddressesFromLocationName*/function getAddressesFromLocationName(request: GeoCodeRequest): Promise<Array<GeoAddress>>;/*** Obtain geocode service status** @permission ohos.permission.LOCATION* @param { AsyncCallback<boolean> } callback - Indicates the callback for reporting the geocode service status.* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.isGeocoderAvailable*/function isGeoServiceAvailable(callback: AsyncCallback<boolean>): void;/*** Obtain geocode service status** @permission ohos.permission.LOCATION* @returns { Promise<boolean> } The promise returned by the function.* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.isGeocoderAvailable*/function isGeoServiceAvailable(): Promise<boolean>;/*** Obtain the number of cached GNSS locations reported at a time** @permission ohos.permission.LOCATION* @param { AsyncCallback<number> } callback - Indicates the callback for reporting the cached GNSS locations size.* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.getCachedGnssLocationsSize*/function getCachedGnssLocationsSize(callback: AsyncCallback<number>): void;/*** Obtain the number of cached GNSS locations reported at a time** @permission ohos.permission.LOCATION* @returns { Promise<number> } The promise returned by the function.* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.getCachedGnssLocationsSize*/function getCachedGnssLocationsSize(): Promise<number>;/*** All prepared GNSS locations are returned to the application through the callback function,* and the bottom-layer buffer is cleared.** @permission ohos.permission.LOCATION* @param { AsyncCallback<boolean> } callback - Indicates the callback for reporting the result.* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.flushCachedGnssLocations*/function flushCachedGnssLocations(callback: AsyncCallback<boolean>): void;/*** All prepared GNSS locations are returned to the application through the callback function,* and the bottom-layer buffer is cleared.** @permission ohos.permission.LOCATION* @returns { Promise<boolean> } The promise returned by the function.* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.flushCachedGnssLocations*/function flushCachedGnssLocations(): Promise<boolean>;/*** Send extended commands to location subsystem.** @permission ohos.permission.LOCATION* @param { LocationCommand } command - Indicates the extended Command Message Body.* @param { AsyncCallback<boolean> } callback - Indicates the callback for reporting the send command result.* @syscap SystemCapability.Location.Location.Core* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.sendCommand*/function sendCommand(command: LocationCommand, callback: AsyncCallback<boolean>): void;/*** Send extended commands to location subsystem.** @permission ohos.permission.LOCATION* @param { LocationCommand } command - Indicates the extended Command Message Body.* @returns { Promise<boolean> } The promise returned by the function.* @syscap SystemCapability.Location.Location.Core* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.sendCommand*/function sendCommand(command: LocationCommand): Promise<boolean>;/*** Satellite status information** @interface SatelliteStatusInfo* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.SatelliteStatusInfo*/export interface SatelliteStatusInfo {/*** @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9*/satellitesNumber: number;/*** @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9*/satelliteIds: Array<number>;/*** @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9*/carrierToNoiseDensitys: Array<number>;/*** @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9*/altitudes: Array<number>;/*** @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9*/azimuths: Array<number>;/*** @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9*/carrierFrequencies: Array<number>;}/*** Parameters for requesting to report cache location information** @interface CachedGnssLocationsRequest* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.CachedGnssLocationsRequest*/export interface CachedGnssLocationsRequest {/*** @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9*/reportingPeriodSec: number;/*** @syscap SystemCapability.Location.Location.Gnss* @since 8* @deprecated since 9*/wakeUpCacheQueueFull: boolean;}/*** Configuring parameters in geo fence requests** @interface GeofenceRequest* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geofence* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.GeofenceRequest*/export interface GeofenceRequest {/*** @syscap SystemCapability.Location.Location.Geofence* @since 8* @deprecated since 9*/priority: LocationRequestPriority;/*** @syscap SystemCapability.Location.Location.Geofence* @since 8* @deprecated since 9*/scenario: LocationRequestScenario;/*** @syscap SystemCapability.Location.Location.Geofence* @since 8* @deprecated since 9*/geofence: Geofence;}/*** Configuring parameters in geo fence requests** @interface Geofence* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geofence* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.Geofence*/export interface Geofence {/*** @syscap SystemCapability.Location.Location.Geofence* @since 8* @deprecated since 9*/latitude: number;/*** @syscap SystemCapability.Location.Location.Geofence* @since 8* @deprecated since 9*/longitude: number;/*** @syscap SystemCapability.Location.Location.Geofence* @since 8* @deprecated since 9*/radius: number;/*** @syscap SystemCapability.Location.Location.Geofence* @since 8* @deprecated since 9*/expiration: number;}/*** Configuring parameters in reverse geocode requests** @interface ReverseGeoCodeRequest* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.ReverseGeoCodeRequest*/export interface ReverseGeoCodeRequest {/*** @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/locale?: string;/*** @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/latitude: number;/*** @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/longitude: number;/*** @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/maxItems?: number;}/*** Configuring parameters in geocode requests** @interface GeoCodeRequest* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.GeoCodeRequest*/export interface GeoCodeRequest {/*** @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/locale?: string;/*** @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/description: string;/*** @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/maxItems?: number;/*** @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/minLatitude?: number;/*** @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/minLongitude?: number;/*** @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/maxLatitude?: number;/*** @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/maxLongitude?: number;}/*** Data struct describes geographic locations.** @interface GeoAddress* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.GeoAddress*/export interface GeoAddress {/*** Indicates latitude information.* A positive value indicates north latitude,* and a negative value indicates south latitude.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/latitude?: number;/*** Indicates longitude information.* A positive value indicates east longitude ,* and a negative value indicates west longitude .** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/longitude?: number;/*** Indicates language used for the location description.* zh indicates Chinese, and en indicates English.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/locale?: string;/*** Indicates landmark of the location.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/placeName?: string;/*** Indicates country code.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/countryCode?: string;/*** Indicates country name.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/countryName?: string;/*** Indicates administrative region name.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/administrativeArea?: string;/*** Indicates sub-administrative region name.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/subAdministrativeArea?: string;/*** Indicates locality information.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/locality?: string;/*** Indicates sub-locality information.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/subLocality?: string;/*** Indicates road name.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/roadName?: string;/*** Indicates auxiliary road information.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/subRoadName?: string;/*** Indicates house information.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/premises?: string;/*** Indicates postal code.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/postalCode?: string;/*** Indicates phone number.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/phoneNumber?: string;/*** Indicates website URL.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/addressUrl?: string;/*** Indicates additional information.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/descriptions?: Array<string>;/*** Indicates the amount of additional descriptive information.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Geocoder* @since 7* @deprecated since 9*/descriptionsSize?: number;}/*** Configuring parameters in location requests** @interface LocationRequest* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.LocationRequest*/export interface LocationRequest {/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/priority?: LocationRequestPriority;/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/scenario?: LocationRequestScenario;/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/timeInterval?: number;/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/distanceInterval?: number;/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/maxAccuracy?: number;}/*** Configuring parameters in current location requests** @interface CurrentLocationRequest* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.CurrentLocationRequest*/export interface CurrentLocationRequest {/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/priority?: LocationRequestPriority;/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/scenario?: LocationRequestScenario;/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/maxAccuracy?: number;/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/timeoutMs?: number;}/*** Provides information about geographic locations** @interface Location* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.Location*/export interface Location {/*** Indicates latitude information.* A positive value indicates north latitude,* and a negative value indicates south latitude.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/latitude: number;/*** Indicates Longitude information.* A positive value indicates east longitude ,* and a negative value indicates west longitude .** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/longitude: number;/*** Indicates location altitude, in meters.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/altitude: number;/*** Indicates location accuracy, in meters.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/accuracy: number;/*** Indicates speed, in m/s.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/speed: number;/*** Indicates location timestamp in the UTC format.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/timeStamp: number;/*** Indicates direction information.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/direction: number;/*** Indicates location timestamp since boot.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/timeSinceBoot: number;/*** Indicates additional information.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/additions?: Array<string>;/*** Indicates the amount of additional descriptive information.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/additionSize?: number;}/*** Enum for location priority** @permission ohos.permission.LOCATION* @enum { number }* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.LocationRequestPriority*/export enum LocationRequestPriority {/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/UNSET = 0x200,/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/ACCURACY,/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/LOW_POWER,/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/FIRST_FIX}/*** Enum for location scenario** @permission ohos.permission.LOCATION* @enum { number }* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.LocationRequestScenario*/export enum LocationRequestScenario {/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/UNSET = 0x300,/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/NAVIGATION,/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/TRAJECTORY_TRACKING,/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/CAR_HAILING,/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/DAILY_LIFE_SERVICE,/*** @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/NO_POWER}/*** Enum for error code** @permission ohos.permission.LOCATION* @enum { number }* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/export enum GeoLocationErrorCode {/*** Indicates input parameter error.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/INPUT_PARAMS_ERROR,/*** Indicates reverse geocode query failed.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/REVERSE_GEOCODE_ERROR,/*** Indicates geocode query failed.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/GEOCODE_ERROR,/*** Indicates positioning failed.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/LOCATOR_ERROR,/*** Indicates operation failure caused by abnormal location switch.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/LOCATION_SWITCH_ERROR,/*** Indicates failed to get the last known location.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/LAST_KNOWN_LOCATION_ERROR,/*** Indicates location request timeout.** @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 7* @deprecated since 9*/LOCATION_REQUEST_TIMEOUT_ERROR}/*** Enum for location privacy type** @permission ohos.permission.LOCATION* @enum { number }* @syscap SystemCapability.Location.Location.Core* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.LocationPrivacyType*/export enum LocationPrivacyType {/*** @syscap SystemCapability.Location.Location.Core* @since 8* @deprecated since 9*/OTHERS = 0,/*** @syscap SystemCapability.Location.Location.Core* @since 8* @deprecated since 9*/STARTUP,/*** @syscap SystemCapability.Location.Location.Core* @since 8* @deprecated since 9*/CORE_LOCATION}/*** Location subsystem command structure** @interface LocationCommand* @permission ohos.permission.LOCATION* @syscap SystemCapability.Location.Location.Core* @since 8* @deprecated since 9* @useinstead ohos.geoLocationManager/geoLocationManager.LocationCommand*/export interface LocationCommand {/*** @syscap SystemCapability.Location.Location.Core* @since 8* @deprecated since 9*/scenario: LocationRequestScenario;/*** @syscap SystemCapability.Location.Location.Core* @since 8* @deprecated since 9*/command: string;}}export default geolocation;