Atlaslog
Atlaslog / Examples / deck.gl / Collision Filter
deck.gl · Runnable Example

Collision Filter

Runnable deck.gl example: Collision Filter. Open the live demo, read the complete source, and copy the file into your project. No build step or API key.

Open standalone → Chinese notes All deck.gl examples
/demos/deckgl-collision-filter.htmlLIVE
single HTML file · CDN dependencies onlyinterface may contain Chinese labels

Source

demos/deckgl-collision-filter.html
<!--
  示例:碰撞避让
  核心逻辑:CollisionFilterExtension 按优先级保留标签,重叠的低优先级标签自动隐藏
  数据:页面内生成的 80 个城市点位与名称,密度刻意做得不均匀
  依赖:deck.gl 9.0 · jsDelivr CDN
-->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta name="robots" content="noindex,follow">
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>碰撞避让</title>
<style>
  html,body{height:100%;margin:0;background:#0d1117}
  body{display:flex;flex-direction:column;overflow:hidden;
       font:13px/1.6 -apple-system,"Segoe UI","PingFang SC",sans-serif;color:#e6e8ec}
  .bar{position:relative;z-index:5;flex:0 0 auto;padding:8px 12px;background:#161b22;border-bottom:1px solid #252c36;
       display:flex;gap:14px;align-items:center;font-size:12px;color:#8b93a1;flex-wrap:wrap}
  .bar b{color:#58a6ff;font-weight:600}
  .bar label{display:flex;gap:5px;align-items:center;cursor:pointer}
  .bar input[type=range]{width:120px}
  #cv{flex:1 1 auto;min-height:0;width:100%}
</style>
</head>
<body>
<div class="bar">
  <span>标签 <b id="n">—</b></span>
  <label><input id="c" type="checkbox" checked> 开启避让</label>
  <label>字号 <input id="s" type="range" min="10" max="20" step="1" value="14"> <b id="sv">14</b></label>
  <span>密度高处只剩优先级高的标签</span>
</div>
<canvas id="cv"></canvas>
<script src="https://cdn.jsdelivr.net/npm/deck.gl@9.0.35/dist.min.js"></script>
<script>
(function () {
  'use strict';

  if (typeof deck === 'undefined') {
    document.body.innerHTML =
      '<div style="padding:24px;color:#ff8c74">deck.gl 加载失败,请检查能否访问 cdn.jsdelivr.net</div>';
    return;
  }

  var seeds = [
    [116.39, 39.90], [121.47, 31.23], [113.26, 23.12], [104.06, 30.57],
    [114.30, 30.59], [108.94, 34.34], [120.15, 30.28], [106.55, 29.56]
  ];
  var names = ['北', '东', '南', '西', '中', '港', '新', '渝'];

  var data = [];
  for (var i = 0; i < 80; i++) {
    var s = seeds[i % seeds.length];
    data.push({
      lng: s[0] + (Math.random() + Math.random() - 1) * 1.1,
      lat: s[1] + (Math.random() + Math.random() - 1) * 0.9,
      name: names[i % names.length] + '站 ' + (i + 1),
      /* 优先级越大越不容易被挤掉 */
      pri: Math.round(Math.random() * 100)
    });
  }
  document.getElementById('n').textContent = data.length;

  var labels = new deck.TextLayer({
    id: 'labels',
    data: data,
    getPosition: function (d) { return [d.lng, d.lat]; },
    getText: function (d) { return d.name; },
    getSize: 14,
    getColor: [232, 240, 255],
    /* 深色描边,密集区域也读得出来 */
    outlineWidth: 2,
    outlineColor: [13, 17, 23, 255],
    fontFamily: 'sans-serif',
    extensions: [new deck.CollisionFilterExtension()],
    collisionEnabled: true,
    collisionGroup: 'city',
    getCollisionPriority: function (d) { return d.pri / 100; },
    pickable: true
  });

  var dots = new deck.ScatterplotLayer({
    id: 'dots',
    data: data,
    getPosition: function (d) { return [d.lng, d.lat]; },
    getRadius: 2.5,
    radiusUnits: 'pixels',
    getFillColor: [88, 166, 255, 220]
  });

  var deckgl = new deck.Deck({
    canvas: document.getElementById('cv'),
    width: '100%',
    height: '100%',
    initialViewState: {
      longitude: 111,
      latitude: 33,
      zoom: 3.6,
      pitch: 0,
      bearing: 0
    },
    controller: true,
    layers: [dots, labels],
    getTooltip: function (info) {
      return info.object ? info.object.name + ' · 优先级 ' + info.object.pri : null;
    }
  });

  document.getElementById('c').addEventListener('change', function () {
    labels.setProps({ collisionEnabled: this.checked });
  });

  document.getElementById('s').addEventListener('input', function () {
    var v = parseInt(this.value, 10);
    document.getElementById('sv').textContent = v;
    labels.setProps({ getSize: v });
  });

  window.__deck = deckgl;
})();
</script>
</body>
</html>
Language: the code and this page are in English; the full tutorial and API notes for this example are in Chinese. The demo itself is the authoritative version — it runs exactly as shown.

More deck.gl examples

deck.gl · EXAMPLEColumn 3D deck.gl · EXAMPLEColumn Density deck.gl · EXAMPLEComposite Layer