Upgrade positioning service data format
This document explains how to upgrade existing positioning service data formats to newer, higher-performance formats. Since the positioning library only supports loading Blocks consistent with its data format, ensure Block data formats are synchronously upgraded during version transitions to maintain normal positioning functionality.
Switch to the new data format version
Switching to the new data format version enhances positioning performance and features. Before switching, verify compatibility between existing Block data formats and the target positioning library format. Perform data format upgrade mapping as needed.
Pre-check
Determine whether the Block data format to be loaded matches the target data format of the positioning library after switching.
- Consistent: The positioning service data format can be switched directly.
- Inconsistent: Data format upgrade mapping must be completed first.
Data format upgrade mapping
Blocks requiring loading must undergo lossless update mapping to upgrade to the positioning library’s data format. After successful lossless upgrade mapping, switch the positioning service data format.
If upgrading using original data, refer to: Upgrade mapping using original data.
If mapping data requires synchronous updates, refer to: Lossless full-update mapping.
Note: During lossless upgrade mapping, select a data format consistent with the positioning library.
Switch positioning library data format
Switch the positioning service data format. For details, refer to:
Switch to the old data format version
Typically, new data format versions outperform older ones. Exercise caution unless specifically required.
Note
- After switching the cloud positioning library to an old data format version, if the scene changes and requires supplementary updates or lossless full-update mapping, generating Blocks in old data formats is unsupported.
- New data format Blocks cannot be added to positioning libraries using old data formats.
Pre-check
Determine whether the Block data format to be loaded matches the target data format of the positioning library after switching.
- Consistent: The positioning service data format can be switched directly.
- Inconsistent: Prohibited. Switching will cause Blocks to fail loading.
Switch positioning library data format
Switch the positioning service data format. For details, refer to: