Kepler.gl 中如何通过 addDataToMap 加载数据但不自动创建图层

在使用 Kepler.gl 进行地理数据可视化时，开发者经常需要精确控制图层的加载过程。一个常见的需求是：只想加载数据而不自动创建对应的可视化图层，以便后续手动添加自定义配置的图层。

问题背景

Kepler.gl 的 addDataToMap 方法默认会自动为传入的数据集创建可视化图层。这种自动化行为虽然方便，但在需要精确控制图层配置的场景下就显得不够灵活。例如，当开发者希望：

1. 预先加载数据但不立即显示
2. 使用自定义的图层配置
3. 基于相同数据创建多个不同样式的图层
4. 实现更复杂的图层加载逻辑

解决方案

通过为 addDataToMap 方法提供 options 参数，并设置 autoCreateLayers 为 false，可以轻松实现只加载数据而不自动创建图层的效果。

addDataToMap({
  datasets,
  options: {
    autoCreateLayers: false
  }
})

技术实现原理

1. 数据加载与图层创建的分离：Kepler.gl 内部将数据加载和图层创建处理为两个独立的步骤
2. 配置覆盖：options 参数允许覆盖默认行为
3. 数据标识保留：即使不自动创建图层，数据仍然会被正确加载并分配 dataId

典型应用场景

1. 批量数据预加载：先加载所有需要的数据，再按需显示特定图层
2. 自定义样式控制：加载数据后，使用 addLayer 方法添加完全自定义配置的图层
3. 动态图层管理：基于相同数据源动态切换不同的可视化方案
4. 性能优化：避免不必要的图层渲染，提升大型数据集的加载效率

最佳实践建议

1. 始终为数据集指定明确的 dataId，便于后续引用
2. 考虑将数据加载和图层创建逻辑分离到不同的代码模块
3. 对于复杂场景，可以结合使用 Redux action 来管理状态
4. 在加载大型数据集时，先禁用自动创建图层可以显著提升初始化性能

通过这种精细控制方式，开发者可以构建更加灵活和高效的地理数据可视化应用，充分发挥 Kepler.gl 的强大功能。