GNSS&LBS&Wi-Fi定位 相关接口

API 列表

函数	说明
Ql_iotLocGetSupList()	获取设备内置定位功能支持的NMEA语句类型
Ql_iotLocGetData()	获取设备当前内置定位功能的定位数据
Ql_iotCmdBusLocReportInside()	上报设备当前内置定位功能的定位数据
Ql_iotCmdBusLocReportInside_ex()	上报设备当前内置定位功能的定位数据
Ql_iotCmdBusLocReportOutside()	上报设备外置定位功能的定位数据
Ql_iotCmdBusLocReportOutside_ex()	上报设备外置定位功能的定位数据

API 详情

Ql_iotLocGetSupList

该函数用于获取设备内置定位功能支持的NMEA语句类型。

函数原型

void *Ql_iotLocGetSupList(void)

参数说明

无。

返回值

TTLV 数据表，节点是定位支持类型。

备注

• 2.8.0及以上版本支持

  注意：获取信息完成后，需调用 Ql_iotTtlvFree() 释放资源。

---

调用示例

void *titleTtlv = Ql_iotLocGetSupList();
Ql_iotTtlvFree(&titleTtlv);

---

Ql_iotLocGetData

该函数用于获取设备当前内置定位功能的定位数据。

函数原型

void *Ql_iotLocGetData(const void *titleTtlv)

参数说明

• 输入参数
  • const void *   titleTtlv： 待获取定位类型的 TTLV 数据表头。

返回值

TTLV 数据表，节点是定位数据。

备注

• 2.8.0及以上版本支持

  注意：获取信息完成后，需调用 Ql_iotTtlvFree() 释放资源。

---

调用示例

void *locDataTtlv = Ql_iotLocGetData(titleTtlv);
Ql_iotTtlvFree(&titleTtlv);

---

Ql_iotCmdBusLocReportInside

该函数用于上报设备当前内置定位功能的定位数据（建议通过 Ql_iotCmdBusLocReportInside_ex()发送定位数据，发送成功后返回上行消息 ID）。

函数原型

qbool Ql_iotCmdBusLocReportInside(void *titleTtlv)

参数说明

• 输入参数
  • void *   titleTtlv： 待上报定位类型的 TTLV 数据表头。

返回值

• True：  函数执行成功。
• False：函数执行失败。

备注

• 2.6.1及以上版本支持

---

调用示例

void *titleTtlv = NULL;
Ql_iotTtlvIdAddString(&titleTtlv, 0, "LBS");
Ql_iotCmdBusLocReportInside(titleTtlv);
Ql_iotTtlvFree(&titleTtlv);

---

Ql_iotCmdBusLocReportInside_ex

该函数用于上报设备当前内置定位功能的定位数据。

函数原型

qint32_t Ql_iotCmdBusLocReportInside_ex(void *titleTtlv)

参数说明

• 输入参数
  • void *   titleTtlv： 待上报定位类型的TTLV数据表头。

返回值

• -1：      函数执行失败。
• 1~65535： 函数执行成功时上报的消息txid。

备注

• 2.10.0及以上版本支持

---

调用示例

void *titleTtlv = NULL;
qbool ret = Ql_iotCmdBusLocReportInside_ex(titleTtlv);
Ql_iotTtlvFree(&titleTtlv);

---

Ql_iotCmdBusLocReportOutside

该函数用于上报设备外置定位功能的定位数据（建议通过 Ql_iotCmdBusLocReportOutside_ex()发送定位数据，发送成功后返回上行消息 ID）。 函数原型

qbool Ql_iotCmdBusLocReportOutside(void *nmeaTtlv)

参数说明

• 输入参数
  • void *   nmeaTtlv： 待上报定位 NMEA 数据的 TTLV 数据表头。

返回值

• True：  函数执行成功。
• False：函数执行失败。

备注

• 2.6.1及以上版本支持

---

调用示例

/* 发送外部定位数据 */
void *nmeaTtlv=NULL;
Ql_iotTtlvIdAddString(&nmeaTtlv,0,"$GPGGA,042523.0,3413.610533,N,10854.063257,E,1,05,2.6,438.5,M,-28.0,M,,*78");
Ql_iotTtlvIdAddString(&nmeaTtlv,0,"$GPRMC,042523.0,A,3413.610533,N,10854.063257,E,0.0,245.9,190716,0.0,E,A*0F");
Ql_iotCmdBusLocReportOutside(nmeaTtlv);
Ql_iotTtlvFree(&nmeaTtlv);

---

Ql_iotCmdBusLocReportOutside_ex

该函数用于上报设备外置定位功能的定位数据。

函数原型

qint32_t Ql_iotCmdBusLocReportOutside_ex(void *nmeaTtlv)

参数说明

• 输入参数
  • void *   nmeaTtlv： 待上报定位 NMEA 数据的 TTLV 数据表头。

返回值

• -1：      函数执行失败。
• 1~65535： 函数执行成功时上报的消息txid。

备注

• 2.10.0及以上版本支持

---

调用示例

void *titleTtlv = NULL;
qbool ret = Ql_iotCmdBusLocReportOutside_ex(titleTtlv);
Ql_iotTtlvFree(&titleTtlv);

---