One-click migration for the Basic 2D Map widget-DataV(DataV)-阿里云帮助中心

This document describes the one-click migration feature for the DataV Basic 2D Map widget and describes the differences when you migrate from version 1.x to 2.x.

What is one-click migration

This procedure describes how to upgrade the Basic Plane Map 1.x component to Basic Plane Map 2.x.

When you click the One-click migration button, DataV creates a new Basic 2D Map 2.x widget based on the configuration of the old Basic 2D map 1.x widget. This process does not affect the old widget.

Note

The one-click migration process adds a new widget. It does not overwrite the old widget.
The new Basic 2D Map 2.x widget does not affect your current visualization application or the old widget.

One-click migration procedure

Ensure that your visualization application contains the Basic 2D Map 1.x widget.

In the canvas editor, click the Basic 2D Map 1.x widget on the canvas.
In the configuration panel on the right, click the Update Version button () next to the name.
Note If your Basic 2D Map widget is already the latest 1.x version, you can skip this step.
After the Basic 2D map 1.x widget and all its sub-widgets are updated, click the One-click migration button next to the name.
Review the notes in the migration dialog box, and then click the Migration button in the lower-right corner.
Click the OK button in the lower-right corner of the dialog box to complete the migration of the Basic 2D Map widget.
After the migration, a new map widget named Basic 2D Map 2.0 is added to the visualization application.

What objects are supported by the one-click migration feature?

Use the One-click Migration feature in the following situations.

You may have added the Basic Plane Map 1.x widget to your visualization application. If the current Basic Plane Map 1.x widget no longer meets your needs, and you have created complex configuration items for it, it can be difficult to recreate those configurations by simply adding the Basic Plane Map 2.x widget.

When not to use one-click migration

Do not use the One-click migration feature in the following situations.

If your visualization application does not have the Basic Plane Map 1.x component, you can add the Basic Plane Map 2.x component from the component list.
If your Basic 2D Map 1.x widget has a simple configuration or is no longer needed, delete the old widget and add a new Basic 2D Map 2.x widget from the widget list.
The features of your current Basic 2D Map 1.x widget are sufficient for your needs.
If the Basic Flat Map component in your visualization application is not the latest version, you may be unfamiliar with the features of the Basic Flat Map 1.x version. Therefore, we recommend using the one-click migration feature with caution. You should first try all the features of the Basic Flat Map 1.x version and migrate only if you find that its features do not meet your needs.

Feature differences between versions

Description	Basic 2D Map 1.x	Basic 2D Map 2.x
Performance	Supports a maximum of 5,000 scatter points.	Excellent rendering performance. Adds features such as off-screen rendering, cached frame animation, and algorithm acceleration. Supports more than 100,000 scatter points, which greatly improves drawing and interaction performance.
Configuration Item	Configuration items are organized based on business scenarios.	Configuration items are reorganized for better generality and logic.
Adjust level	The layer order cannot be changed after a layer is added.	A more logical layer arrangement. You can drag and drop layers to reorder them.
Child widget support	All version 1.x sub-widgets, such as AutoNavi Maps basemap, choropleth layer, animated bubbles layer, drilldown choropleth layer, flying routes layer, density grid layer, points heatmap layer, background image layer, isosurface layer, line density map layer, point clustering, scatter layer, floating bubbles layer, and basemap layer.	Includes all version 1.x sub-widgets and adds support for the following: high-performance vector scatter layer, high-performance icon scatter layer, text label layer, hexagon heatmap layer, and density grid layer.
Child widget visibility level	Does not support controlling sub-widget visibility based on the parent widget's zoom level.	Supports controlling sub-widget visibility based on the parent widget's zoom level.

Notes and troubleshooting for one-click migration

Before you migrate, note the following:

Blueprint interactions configured for the old Basic 2D Map widget are not migrated. You must reconfigure the blueprints in the new widget after migration. This is to prevent potential issues that can arise from the complexity of the Blueprint feature.
Hooks configured for the old Basic 2D map widget are also not migrated.
If your visualization application is in use and you have not created a snapshot, enable the snapshot feature before you migrate. This prevents the new widget from affecting your application.

The following situations require manual fixes after migration:

Point clustering layer: The layout of the new Point clustering layer sub-widget may appear different from the old one. The point aggregation algorithm in the new version is optimized. It processes all points in a grid and counts the number of points in each grid cell. This method provides higher performance and a more logical visual layout than the point density algorithm in the old version.
background image layer: The background image layer sub-widget cannot be migrated if it uses the `simple` coordinate reference system. This is because the new Basic 2D Map 2.x widget only supports the GCJ-02 coordinate system and is no longer compatible with the `simple` coordinate system. Support for custom coordinate systems is planned for a future release.