Mapbox建筑图层在特定缩放级别消失问题排查

• 检查图层缩放范围配置：这是最常见的原因——你可能没手动覆盖图层默认的minzoom参数。Mapbox默认建筑图层（比如composite数据源的building图层）通常默认minzoom为15，所以低于这个级别图层会自动隐藏。
  解决方法：

  • 若是用代码配置样式，在图层对象里明确设置minzoom: 0和maxzoom: 22（Mapbox支持的最大缩放级）：

    {
      "id": "buildings",
      "type": "fill-extrusion",
      "source": "composite",
      "source-layer": "building",
      "minzoom": 0,
      "maxzoom": 22,
      "paint": {
        "fill-extrusion-color": "#your-target-color",
        "fill-extrusion-opacity": 0.7
      }
    }
    

  • 若是用Mapbox Studio可视化编辑，进入图层的「Layout」选项卡，找到「Zoom Range」，将最小缩放滑块拉到0，最大缩放拉到22即可。

• 排查可见性表达式设置：如果之前为图层设置了基于缩放级别的visibility表达式（比如用step函数控制15级以下隐藏），即使颜色透明度是恒定的，图层也会按规则隐藏。
  解决方法：在图层的「Layout」配置里，把visibility设置为恒定的"visible"，删掉任何带有缩放判断的表达式。比如：

  "layout": {
    "visibility": "visible"
  }
  

• 确认数据源的可用性：极少数情况下，自定义建筑数据源可能在低缩放级别没有数据，但Mapbox官方的composite数据源里的building图层是覆盖全缩放级别的，所以如果用的是官方数据源，这个问题基本可以排除。

内容的提问来源于stack exchange，提问作者Pio Shelby