Creating a laser acquisition task (XGRIDS domain)
This article details the complete operational workflow for laser acquisition tasks (XGRIDS domain), including task creation, data upload, and mapping process instructions, helping users standardize the full-process operation of XGRIDS laser acquisition and mapping tasks.
Creating a XGRIDS acquisition task
After creating a project, click Manage to enter the mapping task management interface. Click the XGRIDS acquisition task button in the upper right corner, enter the task name in the pop-up dialog, select the mapping version and data format (recommended to use the latest version), and click Confirm add to create a XGRIDS acquisition task.

Data preparation
Before starting the mapping task, ensure the collected spatial data meets requirements and is organized and stored according to specifications. The following sections detail data acquisition and export.
Data acquisition and export
Use a laser scanner to collect spatial data. For related device configuration and key collection points, refer to:
Uploading data
Click Upload data, and select the corresponding options in the pop-up window. For specific option descriptions, see below:

Data location
Depending on the data source, you can choose one of the following methods to upload data:
- Local new data
- Previously uploaded data
Acquisition data
Upload the
point_cloud.plyfile: ClickSelect, choose the specified file in the directory, and clickOpen.
Upload the
poses.jsonfile: ClickSelect, choose the specified file in the directory, and clickOpen.
Note
XGRIDS acquisition data has fixed filenames per session. Ensure uploading data from the same acquisition session.
EIF data
- EIF data is specialized test data in Mega for remote debugging and simulated positioning, used to remotely verify Mega effects and support simulated positioning during remote development. It must be acquired using specified tools. For detailed collection methods, refer to the EIF data collection guide.
- EIF data is optional in the upload data pop-up. Supplementary EIF data upload is supported later.
- Note: For EIF data collected via the Mega Toolbox mobile app, ensure correspondence between EIF data and mapping video data. For example, if mapping data is from Mei Luo City 1st floor, the uploaded EIF data should also be from Mei Luo City 1st floor.
Upload region
Select the nearest region based on the operator's location.
Confirm upload
- After clicking the
Confirm uploadbutton, the upload progress and status will display in the list. - During data upload, keep the computer powered on and the network stable. Do not close the browser, refresh the page, or click other menus, otherwise the upload will be interrupted and require restarting.
Starting mapping
After upload completes, the task automatically enters Under review, as shown below.

After approval, the task automatically enters the mapping process, with status showing Queued or Generating, as shown below. Please wait patiently for mapping to complete.

Auxiliary functions
The following functions help better manage and operate mapping tasks, improving work efficiency:
View uploaded files
Click the View uploaded files button to see all uploaded file lists in a pop-up, confirming file integrity to avoid mapping failures due to missing files.

Upload EIF
EIF data is specialized test data in Mega for remote debugging and simulated positioning, used to remotely verify Mega effects and support simulated positioning during remote development. It must be acquired using specified tools. For detailed collection methods, refer to the EIF data collection guide.
Steps to upload EIF:
Click the
Upload EIFbutton.
Select the EIF data directory folder, then click the
Confirm uploadbutton.
View uploaded data:
After upload completes, click the View uploaded files button to see uploaded EIF files in the pop-up. Supports Download and Delete operations on files.

Stop mapping
Before the mapping task completes, if incorrect data is uploaded or trajectory data doesn't match reality, click the Stop mapping button, then click Confirm in the secondary confirmation pop-up to stop mapping.

Delete task
If the current mapping task fails or is no longer needed, click the Delete task button to delete it. Click Delete in the secondary confirmation pop-up to complete deletion.

Confirming mapping results
After the task enters the mapping process, use Task status to determine completion. Statuses Task completed or Generation failed indicate the mapping task has ended.

Mapping success
When status shows Task completed, mapping succeeded and results are generated. Further review mapping results to confirm they meet expectations.
View mapping results:
- Review acquisition route
- View mapping report
- View Block information
- Preview spatial model
- View 3D Gaussian splatting data
Mapping failure
When status shows Generation failed, mapping failed. Recommended troubleshooting steps:
- View mapping report: View mapping report and find solutions based on report information.
- Reference troubleshooting: Consult the Mapping failure troubleshooting guide for common solutions.
- Contact technical support: If the above methods don't resolve the issue, contact EasyAR staff and provide the
JobIDfrom the mapping report for quick problem identification.
