heatmap

View source
用 MapboxLayer 的 heatmap 类型把点密度渲染为热力图,paint 控制半径与强度。

简介

MapboxLayertype="heatmap" 把点密度渲染为热力图,heatmap-radius / heatmap-intensity / heatmap-opacity 调节观感。按属性加权的温度热力见 MapboxTemperature

heatmap 由通用组件 MapboxLayer 承载,完整 Props 与事件见其文档。

用法

200 个随机点的密度热力(暗色底图对比更清晰):

<script setup lang="ts">
import type { FeatureCollection } from 'geojson'

const data: FeatureCollection = {
  type: 'FeatureCollection',
  features: Array.from({ length: 200 }, (_, i) => ({
    type: 'Feature',
    properties: {},
    geometry: {
      type: 'Point',
      coordinates: [116.3 + ((i * 53) % 100) / 500, 39.85 + ((i * 71) % 100) / 600]
    }
  }))
}
</script>

<template>
  <div class="h-115 w-full overflow-hidden rounded-(--ui-radius) border border-default">
    <MapboxMap
      :options="{ style: 'mapbox://styles/mapbox/dark-v11', center: [116.4, 39.93], zoom: 11 }"
    >
      <MapboxLayer
        layer-id="heat"
        type="heatmap"
        :source="{ type: 'geojson', data }"
        :paint="{
          'heatmap-radius': 24,
          'heatmap-intensity': 1,
          'heatmap-opacity': 0.85
        }"
      />
    </MapboxMap>
  </div>
</template>

API

Props

Prop Default Type
layerIdstring

图层 id,全局唯一

type"symbol" | "fill" | "line" | "circle" | "heatmap" | "fill-extrusion" | "building" | "raster" | "raster-particle" | "hillshade" | "model" | "background" | "sky" | "slot" | "clip"

图层类型,决定渲染方式与可用的 paint / layout 属性

sourcestring | mapboxgl.VectorSourceSpecification | mapboxgl.RasterSourceSpecification | mapboxgl.RasterDEMSourceSpecification | mapboxgl.RasterArraySourceSpecification | mapboxgl.GeoJSONSourceSpecification | mapboxgl.VideoSourceSpecification | mapboxgl.ImageSourceSpecification | mapboxgl.ModelSourceSpecification

source id 字符串引用,或内联 source 对象(自动创建匿名源并随图层卸载)

sourceLayerstring

矢量瓦片源内的子图层名(source-layer),消费矢量源时必填

paintPropBag

绘制样式属性,响应式变更经 setPaintProperty 增量下发

layoutPropBag

布局属性,响应式变更经 setLayoutProperty 增量下发

filtermapboxgl.ExpressionSpecification | ["has", string] | ["!has", string] | ["==", string, string | number | boolean] | ["!=", string, string | number | boolean] | [">", string, string | number | boolean] | [">=", string, string | number | boolean] | ["<", string, string | number | boolean] | ["<=", string, string | number | boolean] | (string | mapboxgl.FilterSpecification)[]

过滤表达式,仅渲染匹配的要素

minzoom0number

最小缩放级别,低于此级别不渲染

maxzoom24number

最大缩放级别,高于此级别不渲染

beforeIdstring

插入到该 id 图层之前;省略则追加到图层栈顶部

Changelog

No recent changes
Copyright © 2026 - 2026 YiXuan - MIT License