构建 Mega Block

1.准备工作

请事先阅读 Mega 数据采集手册 并遵循描述采集空间数据。

2.建图

2.1 准备数据

注意:没用的数据就不需要上传(比如用来演练操作产生的视频、采集过程中错误操作产生的废弃视频)

每个区域都需要准备好一个主文件夹,命名可用省份城市的拼音全称+景区/商区名称的拼音全称+区域编号,例如:shanghaiwaitan1(windows系统数据文件夹必须用数字或英文字母,且文件夹请勿放在桌面位置)

每个区域的主目录文件夹下需有两个子目录文件夹,分别为:

(1)lowres

存放该区域采集时所产生的LRV文件

(2)360

存放该区域采集时所产生的360文件,名称与LRV文件一一对应

单个区域的数据文件整理完后,文件结构如下图(若采集一个区域的过程中没有出现过电池没电或者内存卡没满,则视频尾号应该都一样):

../../_images/1.png

请注意:如果文件名与上图差异过大,请勿上传,并立即联系采图人员确认。

../../_images/2.png

上图是GoPro Max的命名规范,如果文件名与上图不符合,建图将出现不可预知的问题,即使建图成功,也不一定能使用。 场景的问题如,文件名中包含 (1) (2) 或 [1] [2] 等

2.2 使用建图服务

https://www.easyar.cn/view/login.html 登录开发中心后,可在左侧菜单栏点击“建图服务”,进入项目列表

../../_images/3.png

2.3 选择项目创建建图任务

1.点击某项目后的详情按钮,进入项目详情页

../../_images/4.png

2.进入详情页后,点击“添加任务”

../../_images/5.png

3.输入任务名称即可,一个任务对应该项目内一个区域的数据采集、上传和建图

注意:若一个项目中划分了N多区域需要采集数据和建图,请创建对应数量的任务;任务名称命名规则:景区/商圈简称+区域编号,例如“周庄-区域1”

../../_images/6.png

4.若数据采集和上传由外部人员进行,则建完任务后,就可以通知账号权限为“仅上传数据”的外部人员进行数据上传了。若是自己或有权限人员采集数据和上传,则直接进行以下2.4及其之后的步骤即可。

2.4 上传数据

2.4.1 选择本地数据新建地图

2.4.1.1 校验采图轨迹

1.点击任务列表后的“上传数据”按钮,选择对应的上传类型“仅包含LRV数据,用以轨迹图生成”:上传文件直接选中对应区域的lowres文件夹即可;上传区域请根据上传操作人所在地点就近选择

要求:第一步只上传LRV数据,然后等待轨迹图生成后点击“预览轨迹”查看轨迹图是否与采集视的路线规划一致,即:走的路径所绕的圈与规划的路径一致,确保没有漏采区域;若满足再进行剩余视频上传,若不满足可以重新采集或者补充采集后再重新上传。轨迹图的优先生成和检查可以确保最终上传的数据是完整且可用的,以免等待全部数据转完格式和上传后才发现数据有问题而浪费掉大段时间和精力。

注意:V6.0及以上版本不再需要上传LRV数据。请直接跳过该步骤至 2.4.1.3 直接上传所有数据继续操作。

../../_images/7.png

2.选择确认后上传,列表中会显示上传进度和状态

注意:数据在上传中时请不要关闭浏览器或者刷新页面或者点击其他菜单,否则上传进度会直接终止,终止后则需要重新操作选择数据。

../../_images/8.png

3.若上传失败,可点击“重试按钮”进行断点续传(前提:页面没有刷新或者关闭重开)

../../_images/9.png

4.上传完成后,该任务状态会自动进入“轨迹图数据上传完成”且状态变更为“排队中”或者“生成中”(因LRV数据上传后轨迹图生成需要时间,建议将全部区域的LRV数据上传完成后,可以先去做自己的事情,若有多个轨迹图任务在等待执行时可过个半天至一天再来预览轨迹图)

../../_images/10.png ../../_images/11.png

5.若轨迹图生成失败,则可点击“重新生成”按钮再次生成,若一直生成失败,请联系EasyAR工作人员;若轨迹图生成成功,则可点击“预览轨迹”进行查看:

../../_images/12.png
  1. 轨迹图是否与采集时的路线规划一致,即:走的路径所绕的圈与规划的路径一致,确保没有漏采区域(可将路线规划图与轨迹图进行形状对比);若满足再进行剩余数据的补充上传,若不满足可以重新采集或者补充采集后再重新上传。

  2. 点击“查看视频”,对LRV视频进行检查,主要检查视频开始时是否进行了初始化(初始化规则见文档《Mega 数据采集手册》)以及采集视频是否完整,镜头是否有被遮挡等异常现象)

../../_images/13.png

2.4.1.2 上传剩余数据

1.当轨迹图校验无误后,则可以接着“上传剩余数据”

../../_images/14.png

2.在弹窗中选择“已上传LRV数据,补充上传剩余数据“:

选择文件:直接选中对应区域的360文件夹即可; 测试数据:通过手机端采集的EIF数据,选择时需注意 eif 数据和建图视频数据的对应关系,例如采图数据时美罗城 1 层的,那么与该数据一起上传的 eif 也应该是美罗城 1 层的)。同一个建图区域内支持录制多段eif 数据一起上传,但需注意每个eif格式的文件应该都有对应的json文件; 上传区域:根据上传操作人所在地点就近选择; 稠密地图:默认为生成,非必要请勿修改

../../_images/15.png

3.确认后上传,列表中会显示上传进度和状态

注意:数据在上传中时请不要关闭浏览器或者刷新页面或者点击其他菜单,否则上传进度会直接终止,终止后则需要重新操作选择数据。

../../_images/16.png

4.若上传失败,可点击“重试按钮”进行断点续传(前提:页面没有刷新或者关闭重开)

../../_images/17.png

5.若上传成功,则任务阶段会变更为”空间地图生成“,状态为生成中或排队中

../../_images/18.png

6.若账号无发起建图权限,上传完数据后,则不会自动进入排队等待生成空间地图的队列中,需要有管理员或有建图权限的账号登录后进行手动触发“开始建图”。

../../_images/19.png

2.4.1.3 直接上传所有数据

上传数据时选择直接上传所有数据,此时选中的文件为该区域的”主目录文件夹“;上传完成机代表该任务完成。注意:除非是很有把握采集路线和规划路线一致,确认没有任何问题可选择直接上传所有数据;否则都请先生成轨迹图后校验无误再进行剩余数据上传。

选择文件:直接选中对应区域Gopro采集的数据文件夹即可; 测试数据:通过手机端采集的eif数据,选择时需注意 eif 数据和建图视频数据的对应关系,例如采图数据时美罗城 1 层的,那么与该数据一起上传的 eif 也应该是美罗城 1 层的)。同一个建图区域内支持录制多段eif 数据一起上传,但需注意每个eif格式的文件应该都有对应的json文件; 上传区域:根据上传操作人所在地点就近选择; 稠密地图:默认为生成,非必要请勿修改

../../_images/20.png

2.4.2 选择已上传数据新建地图

支持选择当前账号下之前已完成的任务数据新建地图

../../_images/21.png

1.点击“选择”按钮,在弹窗选择需要新建地图的任务数据

(下拉框中任务数据取值于当前账号下所有已完成任务的数据,若没有发现找到所需要的任务数据,请联系工作人员)

../../_images/22.png

2.点击“确认”,则会使用已选择的任务数据直接进入当前版本地图的建图队列中,无需再上传数据。

2.4.3 稀疏空间地图生成

任务进入稀疏空间地图建图流程后,将实现全自动化,根据队列一个一个执行任务:

1.若生成失败,则可点击”重新生成“再次进入队列等待重建,若操作2次后仍生成失败,请联系EasyAR工作人员;

2.生成成功后,若任务设置生成了稠密空间地图,则自动进入第2.4.4步骤中;若任务设置了不生成稠密空间地图,则直接进入2.4.5步骤中

2.4.4 稠密空间地图生成

若任务设置了不生成稠密空间地图,则直接跳过此步,进入1.4.5步骤中

注意:一般情况下生成大规模稀疏定位地图的同时都是需要生成稠密地图模型的,这个地图模型是后面流程中用来在Unity端离线做点位信息标注,具体操作流程可见文档 标注工具

任务进入稠密空间地图建图流程后,仍是全自动化,根据队列一个一个执行任务:

1.若生成失败,则可点击”重新生成“再次进入队列等待重建,若一直重新生成失败,请联系EasyAR工作人员;

2.若生成成功,则会直接进入2.4.5步骤中。

2.4.5 稀疏空间地图入库

以上步骤完成后,已生成好的稀疏稠密地图会自动进入加入Mega Block库流程:若入库失败,请联系EasyAR工作人员;若入库成功,则可自行操作加入需要使用的云定位图库中。

2.4.6 重新上传

对于任何已经上传过数据的任务,若发现数据有问题可进行重新上传,重新上传时仍需进行轨迹图校验等步骤。

2.4.7 任务完成

在建图任务显示为“任务完成”状态后,将不再支持重新上传和删除操作。到此,该任务全部完成,后续需要检验下稀疏和稠密地图是否可用;若出现不可用的情况,例如:在unity端标注工具内在线获取稠密地图时发现地图尺寸不对或者与实际采图路线不符;在定位测试工具端测试定位识别是始终无法识别或者显示的点位始终不在标注的地点上等,请联系EasyAR工作人员。