鴻蒙開發(fā)學習【地圖位置服務組件】
簡介
移動終端設備已經(jīng)深入人們日常生活的方方面面，如查看所在城市的天氣、新聞軼事、出行打車、旅行導航、運動記錄。這些習以為常的活動，都離不開定位用戶終端設備的位置。
當用戶處于這些豐富的使用場景中時，系統(tǒng)的位置定位能力可以提供實時準確的位置數(shù)據(jù)。對于開發(fā)者，設計基于位置體驗的服務，也可以更好的滿足用戶的需求。
當應用在實現(xiàn)基于設備位置的功能時，如：駕車導航，記錄運動軌跡等，可以調用該模塊的API接口，完成位置信息的獲取
基本概念
位置能力用于確定用戶設備在哪里，系統(tǒng)使用位置坐標標示用戶設備的位置，并使用多種定位技術提供位置服務，如GNSS定位、基站定位、WLAN/藍牙定位（基站定位、WLAN/藍牙定位后續(xù)統(tǒng)稱“網(wǎng)絡定位技術”）。通過這些定位技術，無論用戶設備在室內或是戶外，都可以準確地確定用戶設備的位置。
- 坐標
系統(tǒng)以1984年世界大地坐標系統(tǒng)為參考，使用經(jīng)度、緯度數(shù)據(jù)描述地球上的一個位置。 - GNSS定位
基于全球導航衛(wèi)星系統(tǒng)，包含：GPS、GLONASS、北斗、Galileo等，通過導航衛(wèi)星，設備芯片提供的定位算法，來確定設備準確位置。定位過程具體使用哪些定位系統(tǒng)，取決于用戶設備的硬件能力。 - 基站定位
根據(jù)設備當前駐網(wǎng)基站和相鄰基站的位置，估算設備當前位置。此定位方式的定位結果精度相對較低，并且需要設備可以訪問蜂窩網(wǎng)絡。 - WLAN、藍牙定位
根據(jù)設備可搜索到的周圍WLAN、藍牙設備位置，估算設備當前位置。此定位方式的定位結果精度依賴設備周圍可見的固定WLAN、藍牙設備的分布，密度較高時，精度也相較與基站定位方式更高，同時也需要設備可以訪問網(wǎng)絡。
圖 1子系統(tǒng)架構圖 []()
更多鴻蒙知識更新在gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md參考前往學習。
約束
- 使用設備的位置能力，需要用戶進行確認并主動開啟位置開關。如果位置開關沒有開啟，系統(tǒng)不會向任何應用提供位置服務。
- 設備位置信息屬于用戶敏感數(shù)據(jù)，所以即使用戶已經(jīng)開啟位置開關，應用在獲取設備位置前仍需向用戶申請位置訪問權限。在用戶確認允許后，系統(tǒng)才會向應用提供位置服務。
說明
接口說明
/*
* 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 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 [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 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 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 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 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 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 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 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 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 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 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;
審核編輯 黃宇
聲明：本文內容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權轉載。文章觀點僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學習之用，如有內容侵權或者其他違規(guī)問題，請聯(lián)系本站處理。
舉報投訴
-
WLAN
+關注
關注
2文章
668瀏覽量
76911 -
藍牙
+關注
關注
119文章
6399瀏覽量
179373 -
鴻蒙
+關注
關注
60文章
3031瀏覽量
46195 -
OpenHarmony
+關注
關注
33文章
3977瀏覽量
21378
發(fā)布評論請先 登錄
相關推薦
熱點推薦
百度地圖開放平臺與400萬開發(fā)者共赴智能時空新未來
二十年星辰大海，十五載開放引航。2025年，百度地圖迎來服務用戶的二十周年，其開放平臺亦走過了與開發(fā)者并肩同行的十五個春秋。在近期舉行的“2025百度地圖
開源鴻蒙共建地圖4.0重磅發(fā)布
近日，在2025開放原子開源生態(tài)大會開源鴻蒙主題演講活動上，《開源鴻蒙共建地圖4.0》重磅發(fā)布，標志著開源鴻蒙在技術體系、系統(tǒng)能力和生態(tài)共建方面邁入全新階段。活動現(xiàn)場，開放原子開源基金
【HarmonyOS 5】鴻蒙頁面和組件生命周期函數(shù)
【HarmonyOS 5】鴻蒙頁面和組件生命周期函數(shù) ##鴻蒙開發(fā)能力 ##HarmonyOS SDK應用服務##
【HarmonyOS 5】金融應用開發(fā)鴻蒙組件實踐
【HarmonyOS 5】金融應用開發(fā)鴻蒙組件實踐 ##鴻蒙開發(fā)能力 ##HarmonyOS SDK應用
飛書開源“RTV”富文本組件 重塑鴻蒙應用富文本渲染體驗
更高效的富文本解決方案。 富文本作為內容展示和信息交互的重要形式，在內容創(chuàng)作、辦公協(xié)作、教育學習、企業(yè)應用等多種復雜業(yè)務場景中扮演著重要角色。隨著鴻蒙生態(tài)應用類型的不斷豐富，富文本渲染成為各類應用開發(fā)過程中不可或缺的基礎能力。
鴻蒙地圖功能開發(fā)【3. 代碼開發(fā)】##地圖開發(fā)##
不同，展示位置會有偏移。所以，在中國大陸如果使用WGS84坐標調用Map Kit服務，需要先將其轉換為GCJ02坐標系再訪問?！?所以，如果你使用的是原生鴻蒙的定位能力，那么獲取的坐標在地圖
發(fā)表于 06-29 22:59
鴻蒙地圖功能開發(fā)【2. 申請Profile文件】##地圖開發(fā)##
地圖的項目里都會涉及定位功能，但是其他的，例如“位置服務”并不需要開啟
?
去創(chuàng)建證書的請求文件
這個的流程需要完全按照文檔來完成，從開發(fā)工具里創(chuàng)建證書文件，具體的文檔就是在工具-“應用/元服
發(fā)表于 06-29 22:54
鴻蒙地圖功能開發(fā)【1. 開發(fā)準備】##地圖開發(fā)##
? 對于地圖功能的開發(fā)，有以下三種思路
使用鴻蒙官方的Map Kit進行開發(fā)
使用第三方地圖的SDK（例如高德
發(fā)表于 06-29 22:52
開源鴻蒙6.0Beta1版本發(fā)布！觸覺智能將率先適配RK3566/RK3568/RK3576等芯片平臺芯片
，提供更安全、更靈活的組件布局；增強分布式數(shù)據(jù)管理能力，支持應用對標準化數(shù)據(jù)進行展示；升級音頻引擎2.0，提升整體運行效率并降低播放時延；增強窗口、位置服務、輸入法框
鴻蒙5開發(fā)寶藏案例分享---體驗流暢的首頁信息流
;ne-text\">TextOptimization</span>啟用字體緩存
5??** 地址選擇頁（精準定位+快速檢索）**
雙劍合璧 ：
位置服務
發(fā)表于 06-12 11:42
HarmonyOS實戰(zhàn)：高德地圖自定義定位圖標展示
的問題，建議點贊收藏！ 實現(xiàn)效果 需求分析 首先需要實現(xiàn)一個自定義的圖標替代系統(tǒng)默認的箭頭。 獲取定位權限與位置信息。 獲取定位結果并展示當前位置。 技術實現(xiàn) 在鴻蒙的實際開發(fā)過程中，
鴻蒙5開發(fā)寶藏案例分享---一多開發(fā)實例（游戲）
：卡片服務的花式玩法
（文檔位置：元服務 > 游戲場景）
你以為卡片只能展示天氣？案例里居然用****ArkTS卡片做了這些騷操作：
實時戰(zhàn)況懸浮窗（王者榮耀式地圖小窗）
離線掛
發(fā)表于 06-03 18:22
鴻蒙5開發(fā)寶藏案例分享---一多開發(fā)實例（地圖導航）
? 鴻蒙開發(fā)隱藏寶藏大公開！手把手教你玩轉\"一多\"地圖導航案例 ?
大家好呀！我是你們的老朋友，今天要給大家扒一扒鴻蒙官方文檔里那些\"藏得深\"的實戰(zhàn)
發(fā)表于 06-03 16:17
高德地圖與Rokid達成合作
近日，高德地圖與Rokid宣布達成合作，將共同推出基于全場景智能眼鏡Rokid Glasses的全球首個導航智能體（NaviAgent）應用，標志著高德Planner-Executor架構即將開啟跨終端合作部署，逐步構建起環(huán)繞出行和位置服務的空間智能生態(tài)體系。
開源鴻蒙開發(fā)新體驗，開鴻Bot系列今日開啟預售！
（燒錄指南、產(chǎn)品使用說明書等）。此外，通過免費OTA升級和在線答疑服務，進一步降低了開發(fā)者的學習門檻，重構了開源鴻蒙開發(fā)體驗。
輕辦公智慧終
發(fā)表于 05-16 14:13
評論