跳到主要内容

总体介绍

什么是 WPML​

WPML 是 WayPoint Markup Language 的缩写，即航线文件格式标准。WPML 航线文件格式标准基于 KML（Keyhole Markup Language）的定义进行扩展。WPML 航线文件遵循 KMZ 归档要求，所有航线文件以 “.kmz” 后缀结尾。WPML 航线文件格式标准作为航线数字资产的载体，具备以下几方面的优势：

  • 开放：WPML 的定义公开共享。航线文件使用文件包进行归档，路径采用标记语言描述，可拓展性强。用户和开发者可以依照开放原则，在其基础上持续添加业务数据而不受限。
  • 易读：WPML 使用最基础的 XML 标记语言格式和媒体文件格式描述航线。用户和开发者可以不依赖任何解析软件即可完成对路径定义、航线媒体等资源进行读写。
  • 继承：WPML 将作为航线文件格式标准持续迭代，并依据协议规则保持代际兼容。用户和开发者手中的航线文件能够成为数字资产，在不同设备、不同机型之间直接应用、持续传承。

如何使用 WPML​

WPML 航线文件均以 “.kmz” 后缀结尾，实质是使用 ZIP 格式打包的归档文件。一个标准的 WPML 航线文件解压后，其文件结构如下：

wpml-file-structure

template.kml文件被称为 “模板文件”。预定义的模板为用户编辑和规划航线提供了一种便捷手段。如测绘用户使用建图航拍模板时，不需要仔细描画每条航线的路径，而只需要定义测绘区域和重叠率，即可通过航线规划软件生成最终提供给无人机执行的路径和动作。

waylines.wpml文件被称为 “执行文件”。执行文件定义了明确的无人机飞行和负载动作指令。这些指令由航线规划软件生成。这些软件通过读取 template.kml内的模板参数，结合路径生成算法的演算，最终生成waylines.wpml文件用于执行。

res资源文件夹包含了航线所需的辅助资源，如在开始精准复拍前，预先准备的参考目标物照片等。

template.kml、waylines.wpml和res资源文件夹都是航线文件格式标准的一部分。template.kml定义业务属性，方便用户进行快速调整编辑。waylines.wpml定义执行细节。res文件夹存储辅助资源文件。

WPML 航线文件的字段介绍如下：

  • 仅用于 template.kml 文件的字段在[template.kml 说明]
  • 仅用于 waylines.wpml 文件的字段在[waylines.wpml 说明]
  • template.kml 文件与 waylines.wpml 文件共用的字段在[共用元素信息]

注意：

  1. 航线文件内部各文件或文件夹的命名请遵循此规范，否则可能导致航线文件读取失败。
  2. 航线名称即航线文件的文件名。如new_waypoints.kmz的航线名称是new_waypoints。