Upgrade the positioning service data format
This document introduces how to upgrade the existing positioning service data format to a newer version with better performance. Since the positioning library only supports loading Blocks with the same data format as itself, it is necessary to ensure the Block data format is upgraded accordingly when switching versions to maintain normal positioning functionality.
Switch to the new version data format
Switching to the new version data format can improve positioning performance and feature capabilities. Before switching, check whether the existing Block data format is consistent with the target positioning library format, and perform data format upgrade mapping if necessary.
Pre-check
Determine whether the Block data format to be loaded matches the target data format of the positioning library.
- Consistent: The positioning service data format can be switched directly.
- Inconsistent: Data format upgrade mapping must be completed first.
Data format upgrade mapping
The Blocks to be loaded need to be upgraded to the same data format as the positioning library through lossless update mapping. After successful lossless upgrade mapping, the positioning service data format can be switched.
If using the original data to upgrade the data format, refer to: Upgrade mapping using original data.
If the mapping data needs to be updated simultaneously, refer to: Lossless full update mapping.
Note: During lossless upgrade mapping, ensure the selected data format matches the positioning library.
Switch the positioning library data format
To switch the positioning service data format, refer to:
Switch to the old version data format
Generally, the new version data format offers better performance than the old version. Proceed with caution unless there are special requirements.
Note
- After switching the cloud positioning library to the old version data format, if the scene changes and requires supplementary updates or lossless full update mapping, generating Blocks in the old version data format is not supported.
- New version data format Blocks cannot be added to the positioning library of the old version data format.
Pre-check
Determine whether the Block data format to be loaded matches the target data format of the positioning library.
- Consistent: The positioning service data format can be switched directly.
- Inconsistent: Operation is prohibited, as switching will cause Blocks to fail to load.
Switch the positioning library data format
To switch the positioning service data format, refer to: