Create a single-map mapping task

This article details the complete operation process of a single-map mapping task, including task creation, data upload, and mapping process instructions, helping users standardize the full-process operation of a single-map mapping task.

Create a single-map task

After creating a project, click Manage to enter the mapping task management interface. Click the Single-map task button in the upper-right corner, enter the task name in the pop-up dialog, select the mapping version and data format (it is recommended to use the latest version), and click Confirm to create a new single-map task.

Note

1. A mapping task corresponds to one complete data collection within the project.
2. If data collection and upload are performed by external personnel, after creating the task, you can notify the relevant personnel to upload the data according to the specified process.

Task naming rules

The task name should be concise and clear, and follow these naming rules:

1. If the names of the collection areas are clearly different, simply use the area abbreviation (e.g., "Changtai Plaza");
2. If there are areas with the same name, add a number after the area abbreviation to distinguish them (e.g., "Zhouzhuang - Area 1").

Data preparation

Before starting the mapping task, ensure that the collected spatial data meets the requirements and is organized and stored according to the specifications. The following content details the naming, storage, and structure specifications for data collection devices and data files.

Data collection and export

Use a panoramic camera to collect spatial data. For device configuration and collection points, refer to:

• GoPro Max device configuration
• Collection route planning
• Collection methods
• Collection checklist
• GoPro Max data export

Data folder naming

Each collection area requires a main folder to be prepared, named using the full pinyin of the province and city + the full pinyin of the scenic/commercial area name + the area number, for example: shanghaiwaitan1.
Note: The folder name can only contain Chinese characters, English letters, numbers, and hyphens (-). It must not contain other special characters.

Data storage location

The main folder should be set up on the local hard drive of the computer (it is not recommended to place it on the system drive). Copy the collected data from the TF memory card to the main folder for organization. It is advisable to check the available capacity in advance before copying to ensure a stable final file upload process.

Data file structure specifications

• Under the main directory folder of each area, there should be two subdirectory folders: lowres and 360.
  lowres folder: Stores the LRV files generated during the collection of the area.
  360 folder: Stores the 360 files generated during the collection of the area, with names corresponding one-to-one with the LRV files.
• Note: Unnecessary data does not need to be uploaded (e.g., videos generated during practice operations, discarded videos from incorrect operations during collection, etc.).
• After organizing the data files for a single area, the file structure should look like the image below.
  

Data file naming specifications

• 1 Named as: Video middle number
  Video middle number: The device will automatically split the video into 8GB segments during recording, so multiple video segments may be generated after collecting an area. The order of the videos is sorted from smallest to largest based on the middle number, e.g., if four video segments are generated for an area, the video middle numbers would be 01, 02, 03, 04.
• 2 Named as: Video tail number
  Video tail number: Under normal circumstances, the video tail numbers generated from collecting an area will all be the same.
• File name format: GS at the beginning + video middle numbers starting from 01 consecutively + the same video tail number
• Special cases: If the battery or memory card is replaced during collection, the videos generated after resuming will have non-consecutive middle numbers and different tail numbers compared to the videos before the power outage or card replacement. However, they all belong to the same area's data and should be placed under the same main folder. Therefore, it is recommended to record the start time each time shooting begins in an area to facilitate quick data partitioning during organization.
• If the file names do not comply with the naming specifications, unexpected issues may arise during mapping. Even if mapping succeeds, it may not be usable.

Upload data

Click Upload data, and select the corresponding options in the pop-up window. For specific option descriptions, refer to the following:

Data location

Depending on the source and storage method of the data, you can choose any of the following methods for data upload:

• Local new data
• Mapping with uploaded data
• Alibaba Cloud disk link

Collect data

• Local new data
• Uploaded data
• Aliyun pan link

Click Select, choose the main directory folder of the data (for the specific structure of mapping data files, see below), and then click Upload.

Eif data

• Eif data is the dedicated test data for remote debugging and simulation positioning in Mega, used for remote verification of Mega effects and supporting simulation positioning during remote development. It needs to be collected through specified tools. For detailed collection methods, please refer to the EIF data collection guide.
• In the upload data pop-up window, Eif data is optional. Later, supplementary upload of EIF data will be supported.
• Note: For Eif data collected through the Mega Toolbox mobile app, pay attention to the correspondence between the Eif data and the mapping video data. For example, if the collected data is from the 1st floor of Metro City, then the Eif data uploaded together with it should also be from the 1st floor of Metro City.

Upload area

Select the nearest location based on the upload operator's current location.

Confirm upload

• After clicking the Confirm upload button, the upload progress and status will be displayed in the list.
• During data upload, please keep your computer powered on and the network connection stable. Do not close the browser, refresh the page, or click other menus, otherwise the upload will be interrupted and you will need to restart the operation.

Start mapping

After the upload is complete, the task will automatically enter the Under review state, as shown in the figure below.

Once approved, the task will automatically enter the mapping process, and the status will display as Queued or Generating, as shown in the figure below. Please wait patiently for the mapping to complete.

Accessibility

The following features can help you better manage and operate mapping tasks, improving work efficiency:

View uploaded files

Used to check if the uploaded mapping files are complete, avoiding mapping failure due to missing files.

1. Click the View uploaded files button to see the list of all uploaded files in the pop-up window and confirm if the files are fully uploaded.

   

2. Click on a specific LRV file to preview the video content online and ensure the collected data meets quality requirements.

   

Generate pre-track

Before the mapping result is generated, you can click the Generate pre-track button to generate a pre-track. By previewing the pre-track map, you can determine whether the actual collected trajectory matches the preset route planning. It is recommended to compare the shape of the route planning map with the trajectory map to ensure the collection path is complete and free of missing areas. If the trajectory does not match the planning, you can immediately stop the mapping, re-collect or supplement the collection, and then re-upload the data for mapping.

Preview pre-track

After the pre-track is generated, you can click the Preview pre-track button to view the trajectory. If the mapping is already completed, simply click the Preview trajectory button to view the final trajectory.

Upload EIF

EIF data is specialized test data in Mega for remote debugging and simulation positioning, used for remote verification of Mega effects and supporting simulated positioning during remote development. It needs to be collected using specified tools. For detailed collection methods, please refer to the EIF Data Collection Guide.

Steps to upload EIF:

1. Click the Upload EIF button.

   

2. Select the EIF data directory folder and click the Confirm upload button.

   

View uploaded data:

After uploading, you can click the View uploaded files button to check the uploaded EIF files in the pop-up window. The files support Download and Delete operations.

Stop mapping

Before the mapping task is completed, if incorrect data is uploaded or the trajectory map data does not match the actual situation, you can click the Stop mapping button. In the secondary confirmation pop-up window, click Confirm to stop the mapping.

Delete task

If the current mapping task fails to generate or is no longer needed, you can click the Delete task button to delete the task. In the secondary confirmation pop-up window, click Delete to complete the deletion operation.

Confirm the mapping result

When the task enters the mapping process, you can check whether the mapping task is completed through task status. When the status shows task completed or generation failed, it means the mapping task has ended.

Mapping successful

When the task status shows Task completed, it means the mapping is successful and the mapping results have been generated. At this point, you can further check the mapping results to confirm whether they meet the expected requirements.
View mapping results:

• Review collection route
• View mapping report
• Preview spatial model
• View block information

Mapping failed

When the task status shows Generation failed, it means the mapping has failed. It is recommended to troubleshoot the issue in the following ways:

• Check the mapping report: View the mapping report and find solutions based on the report information.
• Refer to troubleshooting: Check the Mapping failure troubleshooting guide for solutions to common problems.
• Contact technical support: If none of the above methods resolve the issue, contact EasyAR staff and provide the JobID from the mapping report for quick problem identification.

Related topics

• How to use the mapping results for localization after successful mapping
• How to resolve errors during file upload