鸿蒙开发学习【地图位置服务组件】

合集 - 鸿蒙HarmonyOS&OpenHarmony知识(99)
21.鸿蒙开发学习【地图位置服务组件】2024-04-29
简介

移动终端设备已经深入人们日常生活的方方面面，如查看所在城市的天气、新闻轶事、出行打车、旅行导航、运动记录。这些习以为常的活动，都离不开定位用户终端设备的位置。
当用户处于这些丰富的使用场景中时，系统的位置定位能力可以提供实时准确的位置数据。对于开发者，设计基于位置体验的服务，也可以更好的满足用户的需求。
当应用在实现基于设备位置的功能时，如：驾车导航，记录运动轨迹等，可以调用该模块的API接口，完成位置信息的获取
基本概念

位置能力用于确定用户设备在哪里，系统使用位置坐标标示用户设备的位置，并使用多种定位技术提供位置服务，如GNSS定位、基站定位、WLAN/蓝牙定位（基站定位、WLAN/蓝牙定位后续统称“网络定位技术”）。通过这些定位技术，无论用户设备在室内或是户外，都可以准确地确定用户设备的位置。
坐标

系统以1984年世界大地坐标系统为参考，使用经度、纬度数据描述地球上的一个位置。
GNSS定位

基于全球导航卫星系统，包含：GPS、GLONASS、北斗、Galileo等，通过导航卫星，设备芯片提供的定位算法，来确定设备准确位置。定位过程具体使用哪些定位系统，取决于用户设备的硬件能力。
基站定位

根据设备当前驻网基站和相邻基站的位置，估算设备当前位置。此定位方式的定位结果精度相对较低，并且需要设备可以访问蜂窝网络。
WLAN、蓝牙定位

根据设备可搜索到的周围WLAN、蓝牙设备位置，估算设备当前位置。此定位方式的定位结果精度依赖设备周围可见的固定WLAN、蓝牙设备的分布，密度较高时，精度也相较与基站定位方式更高，同时也需要设备可以访问网络。
图 1 子系统架构图
约束

使用设备的位置能力，需要用户进行确认并主动开启位置开关。如果位置开关没有开启，系统不会向任何应用提供位置服务。
设备位置信息属于用户敏感数据，所以即使用户已经开启位置开关，应用在获取设备位置前仍需向用户申请位置访问权限。在用户确认允许后，系统才会向应用提供位置服务。
说明

接口说明

/*

 * 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;
posted @ 2024-04-29 16:43 烧脑猴阅读(109) 评论(0) 编辑收藏举报
刷新页面返回顶部
登录后才能查看或发表评论，立即登录或者逛逛博客园首页
相关博文：
· 鸿蒙实战开发：【7日天气预报】
· 鸿蒙NXET实战：高德地图定位SDK【获取Key+获取定位数据】（二）
· HarmonyOS位置服务开发指南
· 鸿蒙开发学习：定位相关知识（Locationkit）
· 鸿蒙手表定位功能Demo体验，适用儿童、老年和外出旅游安全市场
阅读排行：
· 百万级群聊的设计实践
· 全网最简单！3分钟用满血DeepSeek R1开发一款AI智能客服，零代码轻松接入微信、公众号、小程
· .NET 10 首个预览版发布，跨平台开发与性能全面提升
· 《HelloGitHub》第 107 期
· 从文本到图像：SSE 如何助力 AI 内容实时呈现？（Typescript篇）
鸿蒙HarmonyOS技术交流：mau123789

鸿蒙开发学习【地图位置服务组件】

简介

基本概念

约束

说明

接口说明

公告

更多鸿蒙学习路线大纲与配套笔记获取丨扫一扫下方直接拿

（鸿蒙交流V群老师在线答疑）

鸿蒙开发应用知识已更新《鸿蒙NEXT星河版开发学习文档》

《ArkUI声明式UI》

《Stage模型、分布式应用开发》

《一次开发、多端部署》

《元服务》

《鸿蒙Napi组件》

《HarmonyOS内核》

《HarmonyOS系统裁剪与定制》

《鸿蒙南向工业级底层开发》

《HarmonyOS商业级实战项目》

……

搜索

常用链接

合集

随笔分类

随笔档案

阅读排行榜

评论排行榜

推荐排行榜

最新评论
