二维地图快速入门

Appearance

Source 源 ​

Source 是 OpenLayers 的数据引擎，负责获取和转换原始地理数据，与 Layer 协同工作实现地图可视化。
设计哲学：Source 处理数据获取，Layer 负责渲染呈现。

我们已经在 Layer 部分介绍了大部分 Source，这里补充了聚类（Cluster）的用法

Source 类型 ​

Source 子类描述常用场景
ol/source/Image抽象基类，用于单一图像的源（如静态地图）。不直接使用，而是使用其子类。
ol/source/ImageArcGISRest从 ArcGIS REST 服务获取图像。使用 ArcGIS REST 服务作为图层源。
ol/source/ImageCanvas基于 HTML Canvas 元素的图像源。动态生成图像（如绘制实时数据）。
ol/source/ImageMapGuide从 MapGuide 服务器获取图像。使用 MapGuide 服务器提供的地图服务。
ol/source/ImageStatic用于加载静态图像的源。加载单张图片（如航拍图、历史地图）作为图层。
ol/source/ImageWMS用于 WMS 服务的图像源。加载 WMS 服务提供的地图图片。
ol/source/Raster用于处理其他源的数据，生成栅格输出。对多个源进行像素级操作（如图像融合、计算）。
ol/source/Source所有源的抽象基类。不直接使用。
ol/source/Tile抽象基类，用于基于瓦片的源。不直接使用，而是使用其子类。
ol/source/TileArcGISRest从 ArcGIS REST 服务获取瓦片。使用 ArcGIS REST 服务作为瓦片图层源。
ol/source/TileDebug用于调试的瓦片源，显示瓦片的边界和编号。调试瓦片坐标和加载情况。
ol/source/TileImage基类，用于通过 URL 模板加载瓦片的源。通常用于自定义瓦片源，或作为其他瓦片源的基础。
ol/source/TileJSON从 TileJSON 配置加载瓦片。使用 TileJSON 格式定义的瓦片地图服务（如 Mapbox）。
ol/source/TileWMS用于 WMS 服务的瓦片源（当 WMS 服务支持瓦片时）。加载 WMS 服务提供的瓦片地图。
ol/source/UrlTile抽象基类，用于通过 URL 模板加载瓦片的源。不直接使用。
ol/source/Vector用于矢量数据的源，可以包含多个矢量要素（Feature）。加载矢量数据（GeoJSON、KML 等）或动态添加矢量要素。
ol/source/VectorTile用于矢量瓦片的源。加载矢量瓦片数据（如 Mapbox Vector Tiles）。
ol/source/XYZ用于 XYZ 格式的瓦片源（如 OpenStreetMap、Google Maps 等）。加载常见的在线瓦片地图服务。
ol/source/WMTS用于 OGC WMTS（Web Map Tile Service）服务的瓦片源。加载符合 WMTS 标准的瓦片地图服务。
ol/source/OSM预定义的 OpenStreetMap 瓦片源，继承自 XYZ。快速加载 OpenStreetMap 地图。
ol/source/BingMaps用于加载 Bing Maps 的瓦片源。使用 Bing Maps 作为底图。
ol/source/CartoDB用于加载 CartoDB 地图的瓦片源。使用 CartoDB 提供的地图服务。
ol/source/Cluster用于聚类矢量数据的源。对矢量数据进行聚类，提高可视化效果。

Source 介绍 ​

Source 类型很多，常用的下图中的几种我们在 Layer 中已经介绍完

Source 类型

补充介绍聚类（Cluster） ​

聚类数据源在项目中比较常用，这里补充介绍一下。ol/source/Cluster类中定义了聚类的相关属性和方法。

属性 ​

属性名类型默认值作用
sourceVectorSource必填原始点数据源
distancenumber20聚类像素距离（决定聚合程度）
geometryFunctionfunction点几何自定义要素几何处理逻辑
minDistancenumber0最小聚类距离（避免过近聚合）
createClusterfunction点几何自定义要素几何处理逻辑
展开代码
vue
<template>
  <div ref="mapContainer" id="map"></div>
</template>

<script setup>
import { ref, onMounted } from "vue";
import Map from "ol/Map";
import View from "ol/View";
import { Cluster, Vector as VectorSource } from "ol/source";
import { Vector as VectorLayer, Tile as TileLayer } from "ol/layer";
import { Point } from "ol/geom";
import Feature from "ol/Feature";
import XYZ from "ol/source/XYZ";
import { Style, Circle, Text, Fill, Icon } from "ol/style";
import "ol/ol.css";

const mapContainer = ref(null);

// 1. 创建原始点数据源（模拟1000个随机点）
const rawSource = new VectorSource();
for (let i = 0; i < 1000; i++) {
  const point = new Point([
    116.3 + Math.random() * 1.0, // 经度范围：116.3~117.3
    39.8 + Math.random() * 0.8, // 纬度范围：39.8~40.6
  ]);
  rawSource.addFeature(new Feature(point));
}

// 2. 创建聚类数据源（核心）
const clusterSource = new Cluster({
  source: rawSource,
  distance: 40, // 像素距离，值越大聚类越少
});

// 3. 动态样式函数（根据聚类点数设置不同样式）
const clusterStyle = (feature) => {
  const size = feature.get("features").length;
  let color, radius, image;

  if (size === 1) {
    // color = "rgba(0, 150, 255, 0.8)";
    // radius = 6;
    // 实际情况这里更多的是logo
    return new Style({
      image: new Icon({
        anchor: [0.5, 1],
        src: "/src/assets/local.png", // 使用本地图片
        scale: 0.5, // 缩放图标大小
      }),
    });
  } else if (size < 20) {
    color = "rgba(50, 200, 100, 0.8)";
    radius = 10;
    image = new Circle({
      radius,
      fill: new Fill({ color }),
    });
  } else {
    color = "rgba(255, 70, 70, 0.8)";
    radius = 15 + Math.min(size / 10, 10);
    image = new Circle({
      radius,
      fill: new Fill({ color }),
    });
  }

  return new Style({
    image,
    text: new Text({
      text: size.toString(),
      fill: new Fill({ color: "#fff" }),
      font: "bold 12px sans-serif",
    }),
  });
};

onMounted(() => {
  new Map({
    target: mapContainer.value,
    layers: [
      new TileLayer({
        // 设置高德地图为数据源底图
        source: new XYZ({
          // 设置路网图层
          url: "https://webrd04.is.autonavi.com/appmaptile?lang=zh_cn&size=1&scale=1&style=7&x={x}&y={y}&z={z}",
        }),
      }),
      new VectorLayer({
        source: clusterSource,
        style: clusterStyle, // 应用动态样式
      }),
    ],
    view: new View({
      center: [116.5, 40.0],
      zoom: 8,
      projection: "EPSG:4326",
    }),
  });
});
</script>
<style scoped>
#map {
  position: absolute;
  top: 0;
  bottom: 0;
  width: 100%;
}
</style>