GPS学习文档 - 图文

(

IPosDet * pIPosDet ) 参数：

pIPosDet： [in]： 指向 IPosDet 接口对象的指针。

返回值：

已增加的对象引用计数。 备注：

有效对象返回正的引用计数。

2.1.2 IPOSDET_Release()

说明：

此函数用于减少 IPosDet 接口对象的引用计数。 引用计数为 0（零）时，该对象将从内存中释放且不再有效。 原型：

uint32 IPOSDET_Release (

IPosDet * pIPosDet ) 参数：

pIPosDet： [in]： 指向 IPosDet 接口对象的指针。

返回值：

已减少的对象引用计数。 如果对象已释放，且不再有效，则返回 0（零）。

2.1.3 IPOSDET_GetGPSConfig()

说明：

此函数用于获取 GPS 引擎的当前 GPS 配置。 原型：

int IPOSDET_GetGPSConfig (

IPosDet *pIPosDet, AEEGPSConfig *pConfig ) 参数：

pif： [in]： 指向 IPosDet 对象的指针。 pConfig： [out]： 指向 GPS 配置的指针。请参阅 AEEGPSConfig。

返回值：

SUCCESS： 此函数成功

EPRIVLEVEL： 调用程序没有足够的权限级别 (PL_POS_LOCATION) 调用此函数 EBADPARM： pConfig 为 NULL EUNSUPPORTED： 不支持该函数。

2.1.4 IPOSDET_SetGPSConfig()

说明：

此函数用于设置 GPS 引擎将要使用的 GPS 配置。

详情 原型：

int IPOSDET_SetGPSConfig (

IPosDet *pIPosDet, AEEGPSConfig *pConfig ) 参数：

pIPosDet： [in]： 接口指针。 pConfig： [in]： 指向 GPS 配置的指针。 详情请参阅 AEEGPSConfig。

返回值：

SUCCESS： 函数成功

EPRIVLEVEL： 调用程序没有足够的权限级别 (PL_POS_LOCATION) 调用此函数 EBADPARM： pConfig 为 NULL 或传入 *pConfig 的数据无效。 （检查 mode、server.svrType、optim 的有效性） EUNSUPPORTED： 系统不支持此配置。 备注：

在调用此函数前，定位引擎将使用默认设置配置。 默认设置可以使用 IPOSDET_GetGPSConfig 获取。 只有跟在 IPOSDET_SetGPSConfig() 调用后的定位请求才使用新配置。

2.1.5 IPOSDET_GetGPSInfo()

说明：

此函数用于返回 GPS 定位信息。 它将返回纬度、经度、海拔高度以及向量信息，如水平和垂直速度、方向及水平信息的误差。 该函数为异步调用，完成时将调用 pcb 指定的回调

函数。 如果定位请求未得到合适的回应，AEEGPSInfo 的状态成员将为带有某个 AEEGPS_ERR_* 值的非零值。

该函数可以执行网络运营商建议的保密策略。 在设备上执行保密策略时可能会提示用户使用对话框。 调用此函数应用程序必须准备交出屏幕以便让对话框提示用户。 应用程序在调用此函数后必须挂起事件 EVT_DIALOG_START 对屏幕的着色，必须在事件 EVT_DIALOG_END 中重绘。 原型：

int IPOSDET_GetGPSInfo (

IPosDet *pif, AEEGPSReq req,

AEEGPSAccuracy accuracy, AEEGPSInfo *pGPSInfo, AEECallback *pcb ) 参数：

pif： [in]： 指向 IPosDet 对象的指针。 req： [in]： 请求类型（

AEEGPS_GETINFO_LOCATION

、

AEEGPS_GETINFO_VELOCITY

、

AEEGPS_GETINFO_ALTITUDE、AEEGPS_GETINFO_NONE）。 以上标记

（AEEGPS_GETINFO_NONE除外）可以组合使用以获取多种信息。 accuracy： [in]： 此请求所需的精确度级别。 pGPSInfo： [out]： 输入时，该参数必须是指向 AEEGPSInfo 结构的有效指针。 回调时，此结构的成员包含 GPS 信息。 调用程序必须确保此结构有效，直到调用 pcb 指定的回调。 pcb： [in]： 完成定位后调用的回调函数。

返回值：

SUCCESS： 此函数成功

EPRIVLEVEL： 调用程序没有足够的权限级别 (PL_POS_LOCATION) 调用此函数