# Movk Mapbox > 声明式 Mapbox GL v3 封装库：提供 MapboxMap / MapboxSource / MapboxLayer 等组件与 composables，原生支持 Nuxt 4 模块，并经 Vite 插件在纯 Vue + Vite 项目中通用；内置 3D 建筑、雷达 / 扩散 / 辉光等动态效果，fog / terrain / 天气环境，绘制、天地图、WMS / WMTS 与多坐标系本土化。 ## Docs - [介绍](https://mapbox.mhaibaraai.cn/raw/docs/getting-started.md): 了解 Movk Mapbox 的声明式设计、上下文注入架构与 Nuxt / Vue 双模式，从安装到组合地图、数据源、图层与控件。 - [安装](https://mapbox.mhaibaraai.cn/raw/docs/getting-started/installation.md): 安装 @movk/mapbox 及其 peer 依赖，并按 Nuxt 或 Vue + Vite 选择接入方式。 - [Nuxt 4](https://mapbox.mhaibaraai.cn/raw/docs/getting-started/nuxt.md): 在 Nuxt 4 中注册 @movk/mapbox 模块，配置 token，组件与 composables 自动导入。 - [Vue + Vite](https://mapbox.mhaibaraai.cn/raw/docs/getting-started/vue.md): 在纯 Vue + Vite 项目中经 @movk/mapbox/vite 与 vue-plugin 使用同一套组件。 - [MCP Server](https://mapbox.mhaibaraai.cn/raw/docs/getting-started/ai/mcp.md): 文档站内置 MCP Server，供 AI 智能体检索本库组件、composables、示例，并提供坐标转换等增强工具。 - [llms.txt](https://mapbox.mhaibaraai.cn/raw/docs/getting-started/ai/llms-txt.md): 文档站自动生成 llms.txt 与 llms-full.txt，为大模型提供结构化的库能力与文档索引。 - [Agent Skills](https://mapbox.mhaibaraai.cn/raw/docs/getting-started/ai/skills.md): 文档站发布 movk-mapbox Agent Skill，让 AI 工具一条命令即可学会用本库声明式地构建地图。 - [MapboxMap](https://mapbox.mhaibaraai.cn/raw/docs/core/map.md): 根组件，在客户端创建 Mapbox GL 实例并经 MapboxContext 下发，支持相机 v-model 双向绑定与跨路由持久化。 - [MapboxSource](https://mapbox.mhaibaraai.cn/raw/docs/core/source.md): 声明式数据源，支持 geojson / vector / raster / image / video，按类型增量更新且可被多个图层复用。 - [MapboxLayer](https://mapbox.mhaibaraai.cn/raw/docs/core/layer.md): 声明式图层，按 type 渲染并经 paint / layout / filter 控制样式，支持内联 source 与图层交互事件。 - [MapboxLayerGroup](https://mapbox.mhaibaraai.cn/raw/docs/core/layer-group.md): 图层组，为子图层提供统一的插入锚点与组级显隐开关。 - [MapboxCustomLayer](https://mapbox.mhaibaraai.cn/raw/docs/core/custom-layer.md): 托管 CustomLayerInterface，把自定义 WebGL 图层接入声明式生命周期与样式重载重建。 - [MapboxMarker](https://mapbox.mhaibaraai.cn/raw/docs/core/marker.md): 标记，默认插槽渲染自定义 DOM，支持 v-model:lnglat 双向绑定与拖拽回写。 - [MapboxLottieMarker](https://mapbox.mhaibaraai.cn/raw/docs/core/lottie-marker.md): 在标记位用 lottie-web 渲染矢量动画，支持 animationData 内联或 path 远程加载。 - [MapboxPopup](https://mapbox.mhaibaraai.cn/raw/docs/core/popup.md): 弹窗，默认插槽渲染内容，lnglat 锚定且响应式更新位置。 - [MapboxTooltip](https://mapbox.mhaibaraai.cn/raw/docs/core/tooltip.md): 悬浮提示，鼠标移到目标图层要素时跟随显示，slot 暴露命中要素。 - [circle](https://mapbox.mhaibaraai.cn/raw/docs/layers/circle.md): 用 MapboxLayer 的 circle 类型渲染圆点图层，经内联 geojson 源与 paint 控制半径、颜色与描边。 - [MapboxVideoLayer](https://mapbox.mhaibaraai.cn/raw/docs/layers/video.md): 视频覆盖图层，把视频按四角经纬度贴合到地图，暴露播放控制。 - [MapboxRasterLayer](https://mapbox.mhaibaraai.cn/raw/docs/layers/raster.md): 栅格瓦片图层，叠加 XYZ/TMS 模板的外部瓦片服务。 - [MapboxBufferCircle](https://mapbox.mhaibaraai.cn/raw/docs/layers/buffer-circle.md): 圆形缓冲区，基于 turf 测地圆按米半径生成填充与描边图层。 - [MapboxBufferEllipse](https://mapbox.mhaibaraai.cn/raw/docs/layers/buffer-ellipse.md): 椭圆缓冲区，按米半轴与方位角生成填充与描边图层。 - [MapboxBufferLine](https://mapbox.mhaibaraai.cn/raw/docs/layers/buffer-line.md): 线缓冲区，沿线两侧扩展指定米宽生成走廊面。 - [MapboxBufferPolygon](https://mapbox.mhaibaraai.cn/raw/docs/layers/buffer-polygon.md): 多边形缓冲区，向外扩展或负值向内收缩指定米宽。 - [MapboxBufferSector](https://mapbox.mhaibaraai.cn/raw/docs/layers/buffer-sector.md): 扇形缓冲区，按起止方位角与米半径生成扇面。 - [fill](https://mapbox.mhaibaraai.cn/raw/docs/layers/fill.md): 用 MapboxLayer 的 fill 类型渲染面图层，经 paint 控制填充色与透明度，支持数据驱动着色。 - [line](https://mapbox.mhaibaraai.cn/raw/docs/layers/line.md): 用 MapboxLayer 的 line 类型渲染线图层，经 paint 控制线宽、颜色与端点样式。 - [symbol](https://mapbox.mhaibaraai.cn/raw/docs/layers/symbol.md): 用 MapboxLayer 的 symbol 类型渲染文字与图标标注，layout 读取要素属性。 - [fill-extrusion](https://mapbox.mhaibaraai.cn/raw/docs/layers/fill-extrusion.md): 用 MapboxLayer 的 fill-extrusion 类型把面挤出为 3D 体块，高度可数据驱动。 - [heatmap](https://mapbox.mhaibaraai.cn/raw/docs/layers/heatmap.md): 用 MapboxLayer 的 heatmap 类型把点密度渲染为热力图，paint 控制半径与强度。 - [MapboxClusterLayer](https://mapbox.mhaibaraai.cn/raw/docs/layers/cluster.md): 点聚合图层，基于 geojson cluster 自动渲染聚合圆、计数与散点三层，点击聚合圆展开。 - [MapboxBuildingLayer](https://mapbox.mhaibaraai.cn/raw/docs/layers/building.md): 3D 建筑图层，挤出官方样式的 composite/building 矢量源，可调颜色、透明度与起始缩放。 - [MapboxImageLayer](https://mapbox.mhaibaraai.cn/raw/docs/layers/image.md): 静态图片覆盖图层，把一张图片按四角经纬度贴合到地图上。 - [MapboxNavigationControl](https://mapbox.mhaibaraai.cn/raw/docs/controls/navigation.md): 导航控件，提供缩放按钮与指北罗盘，position 控制停靠角，options 透传至 mapbox-gl。 - [MapboxGeolocateControl](https://mapbox.mhaibaraai.cn/raw/docs/controls/geolocate.md): 定位控件，点击后请求浏览器定位并在地图上跟踪用户位置与方向。 - [MapboxFullscreenControl](https://mapbox.mhaibaraai.cn/raw/docs/controls/fullscreen.md): 全屏控件，点击在全屏与常态间切换地图容器。 - [MapboxScaleControl](https://mapbox.mhaibaraai.cn/raw/docs/controls/scale.md): 比例尺控件，随缩放显示当前地图比例，支持公制、英制与海里单位。 - [MapboxAttributionControl](https://mapbox.mhaibaraai.cn/raw/docs/controls/attribution.md): 版权信息控件，展示数据来源署名，支持折叠与自定义版权文本。 - [MapboxRadar](https://mapbox.mhaibaraai.cn/raw/docs/effects/radar.md): 雷达扫描效果，canvas 生成扇形扫描贴图并按帧旋转。 - [MapboxWindowBuilding](https://mapbox.mhaibaraai.cn/raw/docs/effects/window-building.md): 窗户建筑，程序生成窗户点阵贴图作 fill-extrusion-pattern。 - [MapboxSpriteImage](https://mapbox.mhaibaraai.cn/raw/docs/effects/sprite-image.md): 帧动画图标层，雪碧图切帧后由 symbol 逐帧循环播放。 - [MapboxAnimatedImage](https://mapbox.mhaibaraai.cn/raw/docs/effects/animated-image.md): 动图图标层，ImageDecoder 解码 GIF/APNG/WebP 为帧逐帧循环播放。 - [MapboxDiffusionCircle](https://mapbox.mhaibaraai.cn/raw/docs/effects/diffusion.md): 扩散圆效果，多圈同心圆周期性扩张并渐隐。 - [MapboxGlowCircle](https://mapbox.mhaibaraai.cn/raw/docs/effects/glow.md): 炫光圆效果，实心内核加模糊光晕，可选呼吸脉冲。 - [MapboxWaveCircle](https://mapbox.mhaibaraai.cn/raw/docs/effects/wave.md): 波浪圆效果，常驻底圆加周期向外扩张的描边波纹。 - [MapboxTrail](https://mapbox.mhaibaraai.cn/raw/docs/effects/trail.md): 动态轨迹，line-gradient 彗尾沿线循环平移。 - [MapboxMigration](https://mapbox.mhaibaraai.cn/raw/docs/effects/migration.md): 迁徙图，OD 对生成贝塞尔弧线，粒子沿线循环飞行并带渐变尾迹。 - [MapboxFlowBuilding](https://mapbox.mhaibaraai.cn/raw/docs/effects/flow-building.md): 流动建筑，渐变着色加高亮带沿建筑高度循环流动。 - [MapboxGradientBuilding](https://mapbox.mhaibaraai.cn/raw/docs/effects/gradient-building.md): 渐变建筑，按高度插值着色的 3D 建筑。 - [MapboxTextureBuilding](https://mapbox.mhaibaraai.cn/raw/docs/effects/texture-building.md): 纹理建筑，用户贴图作 fill-extrusion-pattern。 - [MapboxFog](https://mapbox.mhaibaraai.cn/raw/docs/environment/fog.md): 设置地图的雾 / 大气效果，options 透传 mapbox fog 规格。 - [MapboxLights](https://mapbox.mhaibaraai.cn/raw/docs/environment/lights.md): 设置地图 3D 光照（环境光 / 平行光 / 平面光），照亮 3D 建筑与地形。 - [MapboxTerrain](https://mapbox.mhaibaraai.cn/raw/docs/environment/terrain.md): 启用三维地形，基于 raster-dem 数据源并以 exaggeration 控制夸张程度。 - [MapboxTemperature](https://mapbox.mhaibaraai.cn/raw/docs/environment/temperature.md): 把温度采样点按属性渲染为热力层，支持权重范围、半径与配色断点。 - [MapboxRain](https://mapbox.mhaibaraai.cn/raw/docs/environment/rain.md): 为地图添加降雨效果，options 透传 mapbox rain 规格。 - [MapboxSnow](https://mapbox.mhaibaraai.cn/raw/docs/environment/snow.md): 为地图添加降雪效果，options 透传 mapbox snow 规格。 - [MapboxDrawControl](https://mapbox.mhaibaraai.cn/raw/docs/extensions/draw.md): 基于 mapbox-gl-draw 的声明式绘制控件，v-model 受控要素与模式，并暴露命令式实例方法。 - [movkDrawModes](https://mapbox.mhaibaraai.cn/raw/docs/extensions/draw-modes.md): movk 自定义绘制模式集合（圆/椭圆/矩形/扇形），合并进 MapboxDraw.modes 使用。 - [drawThemeStyles](https://mapbox.mhaibaraai.cn/raw/docs/extensions/draw-theme.md): 生成 mapbox-gl-draw 主题样式数组，支持要素级 user_color 覆盖。 - [MapboxTiandituLayer](https://mapbox.mhaibaraai.cn/raw/docs/extensions/tianditu.md): 以天地图 WMTS 瓦片作底图，支持矢量/影像/地形及对应注记叠加。 - [MapboxWmsLayer](https://mapbox.mhaibaraai.cn/raw/docs/extensions/wms.md): 接入标准 WMS 服务为栅格图层，透传版本、格式、CRS 等参数。 - [MapboxWmtsLayer](https://mapbox.mhaibaraai.cn/raw/docs/extensions/wmts.md): 接入标准 WMTS（KVP）服务为栅格图层，支持子域名展开与自定义鉴权参数。 - [坐标转换](https://mapbox.mhaibaraai.cn/raw/docs/extensions/coordinate.md): 基于 gcoord 在 WGS84 / GCJ02 / BD09 / EPSG3857 间转换坐标点与 GeoJSON。 - [useMap](https://mapbox.mhaibaraai.cn/raw/docs/composables/use-map.md): 注入当前 MapboxMap 上下文，在子组件中直接访问地图实例与就绪状态。 - [useMeasure](https://mapbox.mhaibaraai.cn/raw/docs/composables/use-measure.md): 测距 / 测面工具，自管 geojson 源与展示图层，turf 实时计算读数。 - [defineMapboxControl](https://mapbox.mhaibaraai.cn/raw/docs/composables/define-mapbox-control.md): 用回调式 onAdd / onRemove 快速定义一个自定义 Mapbox 控件。 - [useMapbox](https://mapbox.mhaibaraai.cn/raw/docs/composables/use-mapbox.md): 按 id 从注册表获取已挂载地图的上下文，在组件树之外或跨路由访问地图。 - [useMapboxCamera](https://mapbox.mhaibaraai.cn/raw/docs/composables/use-mapbox-camera.md): 相机操作助手，封装 flyTo / easeTo / jumpTo / fitBounds，自动等待地图加载完成。 - [useMapboxDraw](https://mapbox.mhaibaraai.cn/raw/docs/composables/use-mapbox-draw.md): 注入当前 MapboxDrawControl 的绘制实例，在子组件中程序化控制绘制。 - [useMapboxImage](https://mapbox.mhaibaraai.cn/raw/docs/composables/use-mapbox-image.md): 注册 symbol 图层可用的命名图片，样式切换后自动补回，卸载时移除。 - [useFeatureState](https://mapbox.mhaibaraai.cn/raw/docs/composables/use-feature-state.md): 在目标图层上维护 feature-state 的 hover / selected 状态，驱动数据驱动样式。 - [useFrameIcon](https://mapbox.mhaibaraai.cn/raw/docs/composables/use-frame-icon.md): 注册帧动画图标的底层原语，处理样式重载补回与缺图兜底，由 SpriteImage / AnimatedImage 共用。 - [useMapAnimation](https://mapbox.mhaibaraai.cn/raw/docs/composables/use-map-animation.md): 地图帧动画原语，基于 requestAnimationFrame，仅在地图存在且样式就绪时调用回调。 - [useMapExport](https://mapbox.mhaibaraai.cn/raw/docs/composables/use-map-export.md): 导出当前地图为图片 dataURL 或直接触发浏览器下载，免 preserveDrawingBuffer 改造。 - [transformPoint / transformGeoJSON](https://mapbox.mhaibaraai.cn/raw/docs/utils/coordinate.md): 基于 gcoord 在 WGS84 / GCJ02 / BD09 / EPSG3857 间转换坐标点与 GeoJSON。 - [bufferPaints](https://mapbox.mhaibaraai.cn/raw/docs/utils/buffer.md): 生成缓冲区图层的默认 fill / line paint 对象，统一主色与不透明度。 - [boundsOfGeoJSON](https://mapbox.mhaibaraai.cn/raw/docs/utils/geometry.md): 扫描任意 GeoJSON 的全部坐标求包围盒，可直接传给 map.fitBounds。 - [formatDistance / formatArea](https://mapbox.mhaibaraai.cn/raw/docs/utils/measure.md): 把米 / 平方米数值格式化为带单位的距离与面积读数字符串。 - [heatmapPaint](https://mapbox.mhaibaraai.cn/raw/docs/utils/heatmap.md): 生成 mapbox heatmap 图层 paint，把要素属性线性映射为热力权重并按密度着色。 ## Landing - [Movk Mapbox — 声明式 Mapbox GL v3 封装库](https://mapbox.mhaibaraai.cn/raw.md): Compose maps, sources, layers, markers and controls declaratively with MapboxMap / MapboxLayer components and composables. Native Nuxt 4 module plus a Vite plugin for plain Vue. Ships 3D buildings, radar / diffusion / glow effects, fog / terrain / weather, Tianditu and WMS / WMTS basemaps, and multi-CRS localization. ## Documentation Sets - [Movk Mapbox — 声明式 Mapbox GL v3 封装库](https://mapbox.mhaibaraai.cn/llms-full.txt): 声明式 Mapbox GL v3 封装库的完整文档：同一套 src/runtime 既作为 Nuxt 4 模块发布，也经 Vite / unplugin 插件在纯 Vue + Vite 项目通用。涵盖快速开始与双分发接入、核心组件（MapboxMap / MapboxSource / MapboxLayer 等）、图层与控件、3D 建筑及雷达 / 扩散 / 辉光等动态效果、fog / terrain / 天气环境、绘制扩展、天地图与 WMS / WMTS、多坐标系（WGS84 / GCJ02 / BD09）本土化、composables 与工具函数的全部 API 与示例。 ## Notes - mapbox - mapbox-gl - mapbox-gl-v3 - declarative - nuxt - nuxt4 - vue - vite - vue-plugin - unplugin - auto-import - map - source - layer - marker - popup - controls - navigation - 3d-buildings - effects - radar - glow - fog - terrain - weather - draw - tianditu - wms - wmts - coordinate - wgs84 - gcj02 - bd09 - turf - composables - use-map - 纯 Vue + Vite 场景经 @movk/mapbox/vite 自动导入组件与 composables，并经 @movk/mapbox/vue-plugin 注入 token；token 在 Nuxt 模式由模块配置注入，地图实例仅客户端创建，无需 ClientOnly 包裹