网络定位
网络定位是使用设备自身所处的网络环境的特征进行匹配定位的一种定位方式；目前支持的定位方式有：wifi定位、基站定位以及wifi与基站联合定位；
重要数据结构及API接口
枚举
typedef enum
{
ONEPOS_CLOSING = 0,
ONEPOS_RUNING = 1,
ONEPOS_SIG_RUNING = 2,
ONEPOS_WILL_CLOSE = 3,
} onepos_serv_sta_t;
| 参数 |
说明 |
| ONEPOS_CLOSING |
定位服务未运行 |
| ONEPOS_RUNING |
定位服务正在周期性运行 |
| ONEPOS_SIG_RUNING |
定位服务正在单次运行 |
| ONEPOS_WILL_CLOSE |
定位服务即将从周期运行中关闭（等最后一次定位操作完成） |
typedef enum
{
ONEPOS_CIRC_RUN = 0,
ONEPOS_SIG_RUN = 1,
} onepos_serv_type_t;
| 参数 |
说明 |
| ONEPOS_CIRC_RUN |
定位服务以周期性循环运行 |
| ONEPOS_SIG_RUN |
定位服务单次运行 |
结构体
typedef struct
{
os_uint32_t time;
double lat_coordinate;
double lon_coordinate;
} onepos_pos_t;
| 参数 |
说明 |
| time |
定位时间（单位：秒） |
| lat_coordinate |
纬度（坐标系：WGS84） |
| lon_coordinate |
经度（坐标系：WGS84） |
typedef struct onepos_net_pos{
onepos_pos_t *pos_result;
os_task_t *task;
onepos_prot_t *prot;
os_uint16_t interval;
onepos_serv_sta_t status;
onepos_serv_type_t type;
}onepos_net_pos_t;
| 参数 |
说明 |
| pos_result |
指向定位结果的指针 |
| task |
周期定位任务的句柄 |
| prot |
指向与OnePos定位平台的通信协议模块 |
| interval |
周期定位的间隔 |
| status |
定位服务的运行状态 |
| type |
定位服务的运行类型 |
API列表
| 接口 |
说明 |
| onepos_start_server |
开启定位服务 |
| onepos_stop_server |
关闭定位服务 |
| onepos_set_pos_interval |
设置服务定位间隔 |
| onepos_set_server_type |
设置服务运行模式 |
| onepos_get_pos_interval |
查询当前服务的定位周期 |
| onepos_get_server_sta |
获取服务状态 |
| onepos_get_latest_position |
获取最新的位置信息 |
void onepos_start_server(void)
| 特别说明 |
| 会根据设置的（如果没有设置，则使用默认的）运行模式启动服务；默认的运行模式是循环定位模式； |
void onepos_stop_server(void)
| 特殊说明 |
| 如果服务当前的定位模式是循环周期性定位，则可以调用该接口停止定位服务；对于单次定位服务，不需要停止，会自动在定位操作完成后退出服务； |
os_bool_t onepos_set_pos_interval(os_int32_t interval)
| 参数 |
说明 |
| interval |
设置的定位周期时间（单位：秒） |
| 返回 |
说明 |
| OS_TRUE |
设置成功 |
| OS_FALSE |
设置失败（可能是参数错误等原因） |
os_bool_t onepos_set_server_type(onepos_serv_type_t type)
| 参数 |
说明 |
| type |
设置服务的运行方式（具体参见：onepos_serv_type_t定义） |
| 返回 |
说明 |
| OS_TRUE |
设置成功 |
| OS_FALSE |
设置失败（可能是参数错误等原因） |
os_uint32_t onepos_get_pos_interval(void)
| 返回 |
说明 |
| os_uint32_t |
定位周期时间（单位：秒） |
onepos_serv_sta_t onepos_get_server_sta(void)
| 返回 |
说明 |
| onepos_serv_sta_t |
服务运行状态（具体参见：onepos_serv_sta_t定义） |
os_bool_t onepos_get_latest_position(onepos_pos_t *src_info)
| 参数 |
说明 |
| src_info |
指向保存定位数据的内存 |
| 返回 |
说明 |
| OS_TRUE |
获取成功 |
| OS_FALSE |
获取失败 |
使用示例
参考components\position\sample目录下onepos_cmd.c文件中接口调用方式。
