Leaflet 地图初始化时避免同时显示多个 TileLayer

本文旨在解决 Leaflet 地图初始化时多个 TileLayer 同时加载导致显示异常的问题。通过修改地图初始化方式，仅添加一个默认图层，并利用图层控件实现图层切换，从而避免图层覆盖和加载顺序问题，提升用户体验。

在使用 Leaflet 构建地图应用时，经常需要叠加多个 TileLayer 图层，并通过控件让用户自由切换。然而，如果在地图初始化时直接将多个图层添加到地图中，可能会出现一些问题，例如：

• 图层覆盖： 默认情况下，后添加的图层会覆盖先添加的图层，导致用户只能看到最上层的图层。
• 加载顺序： 由于网络延迟等原因，图层的加载顺序可能不确定，导致短暂的显示异常，例如先显示底层图层，然后被上层图层覆盖。
• 属性显示： 如果多个图层都显示在地图上，它们的属性信息可能会同时显示，影响用户体验。

为了解决这些问题，一种有效的方案是在地图初始化时只添加一个默认图层，然后使用图层控件让用户切换其他图层。

实现方法：

1. 初始化地图时只添加一个图层：

   在创建 L.map 对象时，只将一个 TileLayer 添加到 layers 数组中。例如：

   const layer1: L.TileLayer = L.tileLayer('http://{s}.tile.opencyclemap.org/cycle/{z}/{x}/{y}.png', {
     attribution: 'OpenCycleMap'
   });
   const layer2: L.TileLayer = L.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', {
       attribution: 'OpenStreetMap'
   });
   
   const map = L.map(SOME_DIV, {
     center: [54.1109, -115.5322],
     zoom: 5,
     layers: [layer1] // 只添加 layer1
   });

2. 创建图层控件：

   

   灵机语音

   灵机语音

   下载

   使用 L.control.layers 创建图层控件，并将所有 TileLayer 添加到控件中。

   const baseMaps: Record<string, L.TileLayer> = {
     'OpenCycleMap': layer1,
     'OpenStreetMap': layer2
   };
   
   L.control.layers(baseMaps).addTo(map);

完整代码示例：

const layer1: L.TileLayer = L.tileLayer('http://{s}.tile.opencyclemap.org/cycle/{z}/{x}/{y}.png', {
  attribution: 'OpenCycleMap'
});
const layer2: L.TileLayer = L.tileLayer('https://tile.openstreetmap.org/{z}/{x}/{y}.png', {
    attribution: 'OpenStreetMap'
});

const map = L.map(SOME_DIV, {
  center: [54.1109, -115.5322],
  zoom: 5,
  layers: [layer1] // 只添加 layer1
});

const baseMaps: Record<string, L.TileLayer> = {
  'OpenCycleMap': layer1,
  'OpenStreetMap': layer2
};

L.control.layers(baseMaps).addTo(map);

注意事项：

• 确保在创建 L.control.layers 对象之前，所有 TileLayer 对象都已经创建。
• 可以根据需要自定义图层控件的样式和位置。
• 除了 TileLayer，图层控件还可以用于切换其他类型的图层，例如 GeoJSON 图层或 MarkerCluster 图层。

总结：

通过在 Leaflet 地图初始化时只添加一个默认图层，并使用图层控件进行图层切换，可以有效地避免多个 TileLayer 同时加载导致的显示异常，提升用户体验。这种方法简单易用，并且可以灵活地应用于各种地图应用场景。