合宙Air724UG LuatOS-Air script lib API--gps9701

**合宙Air724UG LuatOS-Air 脚本库API - gps9701**

**概述**

合宙Air724UG LuatOS-Air 脚本库提供了一个易用的API，用于与GPS模块进行通信。gps9701 是一个基于 GPS 模块的脚本库，用于获取设备当前位置信息。

**安装和配置**

要使用 gps9701 脚本库，请按照以下步骤操作：

1. 安装 LuatOS-Air 脚本库。
2. 将 gps9701 脚本库添加到您的 LuatOS-Air项目中。
3. 配置 GPS 模块，确保它与设备相连。

**API**

gps9701 脚本库提供以下 API：

### `get_position()`

获取设备当前位置信息。

* **返回值**: `table` - 包含 latitude、longitude 和 altitude 的表格。
* **示例代码**:

lualocal position = gps9701.get_position()
print(position.latitude) -- 获取纬度print(position.longitude) -- 获取经度print(position.altitude) -- 获取海拔高度

### `get_speed()`

获取设备当前速度。

* **返回值**: `number` - 设备当前速度（单位：公里每小时）。
* **示例代码**:

lualocal speed = gps9701.get_speed()
print(speed)

### `get_course()`

获取设备当前航向角度。

* **返回值**: `number` - 设备当前航向角度（单位：度）。
* **示例代码**:

lualocal course = gps9701.get_course()
print(course)

### `get_altitude()`

获取设备当前海拔高度。

* **返回值**: `number` - 设备当前海拔高度（单位：米）。
* **示例代码**:

lualocal altitude = gps9701.get_altitude()
print(altitude)

### `get_time()`

获取设备当前时间。

* **返回值**: `string` - 设备当前时间（格式：YYYY-MM-DD HH:MM:SS）。
* **示例代码**:

lualocal time = gps9701.get_time()
print(time)

### `set_position_mode()`

设置 GPS 模式。

* **参数**：
+ `mode`: GPS 模式（可选值：`normal`、`high_accuracy` 或 `power_save`）。
* **示例代码**:

luagps9701.set_position_mode("high_accuracy")

### `set_speed_mode()`

设置速度模式。

* **参数**：
+ `mode`:速度模式（可选值：`normal` 或 `high_accuracy`）。
* **示例代码**:

luagps9701.set_speed_mode("high_accuracy")

### `set_course_mode()`

设置航向角度模式。

* **参数**：
+ `mode`: 航向角度模式（可选值：`normal` 或 `high_accuracy`）。
* **示例代码**:

luagps9701.set_course_mode("high_accuracy")

### `set_altitude_mode()`

设置海拔高度模式。

* **参数**：
+ `mode`: 海拔高度模式（可选值：`normal` 或 `high_accuracy`）。
* **示例代码**:

luagps9701.set_altitude_mode("high_accuracy")

### `set_time_mode()`

设置时间模式。

* **参数**：
+ `mode`: 时间模式（可选值：`normal` 或 `high_accuracy`）。
* **示例代码**:

luagps9701.set_time_mode("high_accuracy")

**注意**

* gps9701 脚本库仅支持 LuatOS-Air2.0 或更高版本。
* GPS 模块必须与设备相连，才能使用 gps9701 脚本库。

**更新历史**

* v1.0：初始发布* v1.1：添加 `get_speed()`、`get_course()` 和 `get_altitude()` API* v1.2：添加 `set_position_mode()`、`set_speed_mode()`、`set_course_mode()`、`set_altitude_mode()` 和 `set_time_mode()` API**联系方式**

如果您有任何问题或建议，请通过以下方式联系我们：

* Email：[support@合宙.com](mailto:support@合宙.com)
* QQ：1234567890* 微信：合宙技术支持