harmony 鸿蒙oh_location_type.h

  • 2025-06-16
  • 浏览 (4)

oh_location_type.h

概述

定义位置服务常用的属性。

\@kit LocationKit

库: liblocation_ndk.so

系统能力: SystemCapability.Location.Location.Core

起始版本: 13

相关模块:Location

汇总

结构体

名称 描述
struct  Location_BasicInfo 定义位置基本信息的结构体。

类型定义

名称 描述
typedef enum Location_ResultCode Location_ResultCode 定义位置服务的错误码。
typedef enum Location_UseScene Location_UseScene 定义位置请求中的用户活动场景类型。
typedef enum Location_PowerConsumptionScene Location_PowerConsumptionScene 定义位置请求中的功耗场景类型。
typedef enum Location_SourceType Location_SourceType 定义位置信息的来源。
typedef struct Location_BasicInfo Location_BasicInfo 定义位置基本信息的结构体。
typedef struct Location_Info Location_Info 定义位置信息的结构体。
typedef void(* Location_InfoCallback) (Location_Info *location, void *userData) 用于接收位置上报的回调函数。
typedef struct Location_RequestConfig Location_RequestConfig 定义位置请求参数的结构体。

枚举

名称 描述
Location_ResultCode {
LOCATION_SUCCESS = 0, LOCATION_PERMISSION_DENIED = 201, LOCATION_INVALID_PARAM = 401, LOCATION_NOT_SUPPORTED = 801,
LOCATION_SERVICE_UNAVAILABLE = 3301000, LOCATION_SWITCH_OFF = 3301100
}
定义位置服务的错误码。
Location_UseScene { LOCATION_USE_SCENE_NAVIGATION = 0x0401, LOCATION_USE_SCENE_SPORT = 0x0402, LOCATION_USE_SCENE_TRANSPORT = 0x0403, LOCATION_USE_SCENE_DAILY_LIFE_SERVICE = 0x0404 } 定义位置请求中的用户活动场景类型。
Location_PowerConsumptionScene { LOCATION_HIGH_POWER_CONSUMPTION = 0x0601, LOCATION_LOW_POWER_CONSUMPTION = 0x0602, LOCATION_NO_POWER_CONSUMPTION = 0x0603 } 定义位置请求中的功耗场景类型。
Location_SourceType { LOCATION_SOURCE_TYPE_GNSS = 1, LOCATION_SOURCE_TYPE_NETWORK = 2, LOCATION_SOURCE_TYPE_INDOOR = 3, LOCATION_SOURCE_TYPE_RTK = 4 } 定义位置信息的来源。

函数

名称 描述
Location_BasicInfo OH_LocationInfo_GetBasicInfo (Location_Info *location) 获取位置基本信息。
Location_ResultCode OH_LocationInfo_GetAdditionalInfo (Location_Info *location, char *additionalInfo, uint32_t length) 获取位置信息中的附加信息。
Location_RequestConfig * OH_Location_CreateRequestConfig (void) 创建一个位置请求参数结构体实例。
void OH_Location_DestroyRequestConfig (Location_RequestConfig *requestConfig) 销毁位置请求参数实例并回收内存。
void OH_LocationRequestConfig_SetUseScene (Location_RequestConfig *requestConfig, Location_UseScene useScene) 设置位置请求参数中的用户活动场景。
位置请求参数Location_RequestConfig中以useScene优先。
如果设置了useScene,则powerConsumptionScene参数无效。
如果未设置useScene,设置了powerConsumptionScene则该参数生效。
如果两个参数都未设置,则默认useScene为LOCATION_USE_SCENE_DAILY_LIFE_SERVICE
powerConsumptionScene参数无效。
void OH_LocationRequestConfig_SetPowerConsumptionScene (Location_RequestConfig *requestConfig, Location_PowerConsumptionScene powerConsumptionScene) 设置位置请求参数中的功耗场景。
void OH_LocationRequestConfig_SetInterval (Location_RequestConfig *requestConfig, int interval) 设置位置请求参数中的位置上报间隔。
void OH_LocationRequestConfig_SetCallback (Location_RequestConfig *requestConfig, Location_InfoCallback callback, void *userData) 设置回调函数。

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Location Kit API参考

harmony 鸿蒙Location

harmony 鸿蒙Location_BasicInfo

harmony 鸿蒙位置服务错误码

harmony 鸿蒙@ohos.app.ability.FenceExtensionAbility (FenceExtensionAbility)

harmony 鸿蒙@ohos.app.ability.FenceExtensionContext (FenceExtensionContext)(系统接口)

harmony 鸿蒙@ohos.app.ability.FenceExtensionContext (FenceExtensionContext)

harmony 鸿蒙@ohos.geoLocationManager (位置服务)(系统接口)

harmony 鸿蒙@ohos.geoLocationManager (位置服务)

harmony 鸿蒙@ohos.geolocation (位置服务)

0  赞