getSource

取回的是源对象本身，不是数据副本；改它的属性或调用它的方法会直接作用到地图上。

参数与返回

id 不存在、样式尚未加载完成、或源已被移除时返回 undefined。 样式加载完成前调用是最常见的空值来源。

各类源的可用方法

先判空再更新

function updateCities(featureCollection) {
  var src = map.getSource('cities');

  if (!src) {
    console.warn('cities 源尚未就绪');
    return;
  }

  src.setData(featureCollection);
}

setData 是全量替换，调用后相关图层自动重绘。 数据更新频繁时，先把多次修改合并，再按 200–500 毫秒的节奏推送。

源与图层是两回事

同一个源可以挂多个图层：一份行政区 GeoJSON 既能做填充，也能做边界线。 更新源数据时所有相关图层一起变化，不需要逐个处理。

检查加载状态

if (map.isSourceLoaded('districts')) {
  console.log('当前视野内的瓦片已加载');
}

map.on('sourcedata', function (e) {
  if (e.sourceId === 'districts' && e.isSourceLoaded) {
    console.log('源数据就绪');
  }
});

isSourceLoaded 只反映当前需要渲染的瓦片，不代表整个数据集都到了。 矢量源尤其如此，视野外的瓦片尚未请求。