鴻蒙開發(fā)學(xué)習(xí)【地圖位置服務(wù)組件】
簡介
移動(dòng)終端設(shè)備已經(jīng)深入人們?nèi)粘Ｉ畹姆椒矫婷妫绮榭此诔鞘械奶鞖?、新聞軼事、出行打車、旅行導(dǎo)航、運(yùn)動(dòng)記錄。這些習(xí)以為常的活動(dòng)，都離不開定位用戶終端設(shè)備的位置。
當(dāng)用戶處于這些豐富的使用場景中時(shí)，系統(tǒng)的位置定位能力可以提供實(shí)時(shí)準(zhǔn)確的位置數(shù)據(jù)。對(duì)于開發(fā)者，設(shè)計(jì)基于位置體驗(yàn)的服務(wù)，也可以更好的滿足用戶的需求。
當(dāng)應(yīng)用在實(shí)現(xiàn)基于設(shè)備位置的功能時(shí)，如：駕車導(dǎo)航，記錄運(yùn)動(dòng)軌跡等，可以調(diào)用該模塊的API接口，完成位置信息的獲取
基本概念
位置能力用于確定用戶設(shè)備在哪里，系統(tǒng)使用位置坐標(biāo)標(biāo)示用戶設(shè)備的位置，并使用多種定位技術(shù)提供位置服務(wù)，如GNSS定位、基站定位、WLAN/藍(lán)牙定位（基站定位、WLAN/藍(lán)牙定位后續(xù)統(tǒng)稱“網(wǎng)絡(luò)定位技術(shù)”）。通過這些定位技術(shù)，無論用戶設(shè)備在室內(nèi)或是戶外，都可以準(zhǔn)確地確定用戶設(shè)備的位置。
- 坐標(biāo)
系統(tǒng)以1984年世界大地坐標(biāo)系統(tǒng)為參考，使用經(jīng)度、緯度數(shù)據(jù)描述地球上的一個(gè)位置。 - GNSS定位
基于全球?qū)Ш叫l(wèi)星系統(tǒng)，包含：GPS、GLONASS、北斗、Galileo等，通過導(dǎo)航衛(wèi)星，設(shè)備芯片提供的定位算法，來確定設(shè)備準(zhǔn)確位置。定位過程具體使用哪些定位系統(tǒng)，取決于用戶設(shè)備的硬件能力。 - 基站定位
根據(jù)設(shè)備當(dāng)前駐網(wǎng)基站和相鄰基站的位置，估算設(shè)備當(dāng)前位置。此定位方式的定位結(jié)果精度相對(duì)較低，并且需要設(shè)備可以訪問蜂窩網(wǎng)絡(luò)。 - WLAN、藍(lán)牙定位
根據(jù)設(shè)備可搜索到的周圍WLAN、藍(lán)牙設(shè)備位置，估算設(shè)備當(dāng)前位置。此定位方式的定位結(jié)果精度依賴設(shè)備周圍可見的固定WLAN、藍(lán)牙設(shè)備的分布，密度較高時(shí)，精度也相較與基站定位方式更高，同時(shí)也需要設(shè)備可以訪問網(wǎng)絡(luò)。
圖 1子系統(tǒng)架構(gòu)圖 []()
更多鴻蒙知識(shí)更新在gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md參考前往學(xué)習(xí)。
約束
- 使用設(shè)備的位置能力，需要用戶進(jìn)行確認(rèn)并主動(dòng)開啟位置開關(guān)。如果位置開關(guān)沒有開啟，系統(tǒng)不會(huì)向任何應(yīng)用提供位置服務(wù)。
- 設(shè)備位置信息屬于用戶敏感數(shù)據(jù)，所以即使用戶已經(jīng)開啟位置開關(guān)，應(yīng)用在獲取設(shè)備位置前仍需向用戶申請(qǐng)位置訪問權(quán)限。在用戶確認(rèn)允許后，系統(tǒng)才會(huì)向應(yīng)用提供位置服務(wù)。
說明
接口說明
/*
* 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;
審核編輯 黃宇
聲明：本文內(nèi)容及配圖由入駐作者撰寫或者入駐合作網(wǎng)站授權(quán)轉(zhuǎn)載。文章觀點(diǎn)僅代表作者本人，不代表電子發(fā)燒友網(wǎng)立場。文章及其配圖僅供工程師學(xué)習(xí)之用，如有內(nèi)容侵權(quán)或者其他違規(guī)問題，請(qǐng)聯(lián)系本站處理。
舉報(bào)投訴
-
WLAN
+關(guān)注
關(guān)注
2文章
663瀏覽量
74582 -
藍(lán)牙
+關(guān)注
關(guān)注
116文章
6078瀏覽量
174038 -
鴻蒙
+關(guān)注
關(guān)注
60文章
2620瀏覽量
44058 -
OpenHarmony
+關(guān)注
關(guān)注
29文章
3854瀏覽量
18617
發(fā)布評(píng)論請(qǐng)先 登錄
相關(guān)推薦
熱點(diǎn)推薦
【HarmonyOS 5】鴻蒙頁面和組件生命周期函數(shù)
【HarmonyOS 5】鴻蒙頁面和組件生命周期函數(shù) ##鴻蒙開發(fā)能力 ##HarmonyOS SDK應(yīng)用服務(wù)##
【HarmonyOS 5】金融應(yīng)用開發(fā)鴻蒙組件實(shí)踐
【HarmonyOS 5】金融應(yīng)用開發(fā)鴻蒙組件實(shí)踐 ##鴻蒙開發(fā)能力 ##HarmonyOS SDK應(yīng)用
鴻蒙地圖功能開發(fā)【3. 代碼開發(fā)】##地圖開發(fā)##
不同，展示位置會(huì)有偏移。所以，在中國大陸如果使用WGS84坐標(biāo)調(diào)用Map Kit服務(wù)，需要先將其轉(zhuǎn)換為GCJ02坐標(biāo)系再訪問?！?所以，如果你使用的是原生鴻蒙的定位能力，那么獲取的坐標(biāo)在地圖
發(fā)表于 06-29 22:59
鴻蒙地圖功能開發(fā)【2. 申請(qǐng)Profile文件】##地圖開發(fā)##
地圖的項(xiàng)目里都會(huì)涉及定位功能，但是其他的，例如“位置服務(wù)”并不需要開啟
?
去創(chuàng)建證書的請(qǐng)求文件
這個(gè)的流程需要完全按照文檔來完成，從開發(fā)工具里創(chuàng)建證書文件，具體的文檔就是在工具-“應(yīng)用/元服
發(fā)表于 06-29 22:54
鴻蒙地圖功能開發(fā)【1. 開發(fā)準(zhǔn)備】##地圖開發(fā)##
? 對(duì)于地圖功能的開發(fā)，有以下三種思路
使用鴻蒙官方的Map Kit進(jìn)行開發(fā)
使用第三方地圖的SDK（例如高德
發(fā)表于 06-29 22:52
開源鴻蒙6.0Beta1版本發(fā)布！觸覺智能將率先適配RK3566/RK3568/RK3576等芯片平臺(tái)芯片
，提供更安全、更靈活的組件布局；增強(qiáng)分布式數(shù)據(jù)管理能力，支持應(yīng)用對(duì)標(biāo)準(zhǔn)化數(shù)據(jù)進(jìn)行展示；升級(jí)音頻引擎2.0，提升整體運(yùn)行效率并降低播放時(shí)延；增強(qiáng)窗口、位置服務(wù)、輸入法框
鴻蒙5開發(fā)寶藏案例分享---一多開發(fā)實(shí)例（地圖導(dǎo)航）
? 鴻蒙開發(fā)隱藏寶藏大公開！手把手教你玩轉(zhuǎn)\"一多\"地圖導(dǎo)航案例 ?
大家好呀！我是你們的老朋友，今天要給大家扒一扒鴻蒙官方文檔里那些\"藏得深\"的實(shí)戰(zhàn)
發(fā)表于 06-03 16:17
高德地圖與Rokid達(dá)成合作
近日，高德地圖與Rokid宣布達(dá)成合作，將共同推出基于全場景智能眼鏡Rokid Glasses的全球首個(gè)導(dǎo)航智能體（NaviAgent）應(yīng)用，標(biāo)志著高德Planner-Executor架構(gòu)即將開啟跨終端合作部署，逐步構(gòu)建起環(huán)繞出行和位置服務(wù)的空間智能生態(tài)體系。
開源啦?。?！基于鴻蒙ArkTS封裝的圖表組件《McCharts》，大家快來一起共創(chuàng)
Hello；大家好，我是陳楊。好久沒更新了，首先是自己本職工作比較忙，基本沒時(shí)間寫作。其次就是學(xué)習(xí)技術(shù)，自學(xué)鴻蒙ArkTS語言已經(jīng)接近半年了，也算半路出師了，這次將分享我封裝的組件庫，所以有啥講錯(cuò)
發(fā)表于 03-15 15:21
【「極速探索HarmonyOS NEXT 」閱讀體驗(yàn)】 初印象：一本純血鴻蒙應(yīng)用開發(fā)入門的好書
，通用文字識(shí)別，華為支付服務(wù)，地圖服務(wù)。介紹了這些概念和實(shí)例。這些都是我們?cè)?b class='flag-5'>開發(fā)應(yīng)用常用到的服務(wù)，篇章的介紹非常實(shí)用，使
發(fā)表于 03-04 12:41
HarmonyOS 應(yīng)用開發(fā)賦能套件：鴻蒙原生應(yīng)用開發(fā)的 “神助攻”
隨著鴻蒙生態(tài)的快速發(fā)展，越來越多的開發(fā)者投身于鴻蒙原生應(yīng)用的開發(fā)中。然而，在學(xué)習(xí)鴻蒙原生應(yīng)用
發(fā)表于 02-17 16:37
AIGC入門及鴻蒙入門
JDK、配置SDK等。
3. 開發(fā)實(shí)踐： 學(xué)習(xí)鴻蒙系統(tǒng)的架構(gòu)和API，了解其組件化、分布式等特性。 通過官方文檔和社區(qū)資源，學(xué)習(xí)和掌握
發(fā)表于 01-13 10:32
鴻蒙原生開發(fā)手記：03-元服務(wù)開發(fā)全流程（開發(fā)元服務(wù)，只需要看這一篇文章）
廣告
服務(wù)相伴履約提醒服務(wù)閉環(huán)
用完即走退出無彈窗服務(wù)隨賬號(hào)同步
原生智能小藝智能精準(zhǔn)觸達(dá)全域搜索系統(tǒng)搜索框
高效開發(fā)UX 組件集、場景化模
發(fā)表于 11-23 21:52
鴻蒙原生開發(fā)手記：01-元服務(wù)開發(fā)
使用 RelativeContainer 時(shí)發(fā)現(xiàn)，按鈕如果處在頂部與元服務(wù)右側(cè)按鈕同一行的位置區(qū)域時(shí)，點(diǎn)擊事件不觸發(fā)，此時(shí)不使用 RelativeContainer 組件，改用其他，如 Column。
參考資料
元
發(fā)表于 11-14 17:28
人員定位技術(shù)向化工廠的智慧平臺(tái)提供精準(zhǔn)的位置服務(wù)
化工廠的智慧平臺(tái)提供精準(zhǔn)的位置服務(wù)。 人員定位系統(tǒng)功能1、三維展示模塊系統(tǒng)平臺(tái)采用三維地圖作為基礎(chǔ)，實(shí)現(xiàn)變電站整體的三維場景瀏覽、報(bào)警監(jiān)控、重要數(shù)據(jù)統(tǒng)計(jì)、人員精確定位、歷史軌跡查詢、作業(yè)票導(dǎo)入、電子圍欄、作業(yè)過
工商網(wǎng)監(jiān)
評(píng)論