初探mapbox地图可视化实例，带你看看家附近有多少咖啡馆

本实例使用的是Mapbox GL JS，开发文档地址：请点击

Mapbox GL JS 是一个用于 Web 上矢量地图的 JavaScript 库。它的性能、实时样式和交互功能为在网络上构建快速、沉浸式地图的任何人设定了标准。

官网给大家准备了很多实例，可供参考学习。

咖啡馆地图可视化

实现效果

核心代码 （React + Typescript）

import React, { useEffect, useState } from "react";
import { history } from "umi";
import mapboxgl from "mapbox-gl";
import MapboxLanguage from "@mapbox/mapbox-gl-language";
import AllAddr from "@/utils/allAddr";
import Style from "./index.less";
import icon from "../../../public/images/coffee.png";

export default () => {
  const handleInitial = () => {
    mapboxgl.accessToken = "官方注册后提供的token";
    var map = new mapboxgl.Map({
      style: "mapbox://styles/stevage/ciz68fsec00112rpal5hjru07?refresh=1",
      center: [121.42, 31.22], //上海市长宁区
      zoom: 11.5, //缩放级别
      minZoom: 9,
      maxZoom: 19,
      container: "map",
    });
    //设置语言：中文
    var language = new MapboxLanguage({ defaultLanguage: "zh-Hans" });
    map.addControl(language);

    map.on("load", function () {
      map.addSource("places", {
        type: "geojson",
        data: {
          type: "FeatureCollection",
          features: AllAddr.coffeAddr,
        },
      });
      map.addLayer({
        id: "places",
        type: "symbol",
        source: "places",
        layout: {
          "icon-image": "{icon}",
          "text-field": "{title}",
          "text-font": ["Open Sans Semibold", "Arial Unicode MS Bold"],
          "text-size": 20,
          "text-offset": [0, 0.6],
          "text-anchor": "top",
        },
        paint: {
          'text-color': '#50B4DB', 

        },
      });

      const popup = new mapboxgl.Popup({
        closeButton: false,
        closeOnClick: false,
      });

      map.on("mouseenter", "places", (e: any) => {
        map.getCanvas().style.cursor = "pointer";
        const coordinates = e.features[0].geometry.coordinates.slice();
        const description = e.features[0].properties.description;
        while (Math.abs(e.lngLat.lng - coordinates[0]) > 180) {
          coordinates[0] += e.lngLat.lng > coordinates[0] ? 360 : -360;
        }
        popup.setLngLat(coordinates).setHTML(description).addTo(map);
      });

      map.on("mouseleave", "places", () => {
        map.getCanvas().style.cursor = "";
        popup.remove();
      });
    });
  };
  useEffect(() => {
    handleInitial();
  }, []);

  return (
    <div className={Style.mapContanier}>
      <div className={Style.leftItem}>
        <div className={Style.leftBg}>{AllAddr.bgText}</div>
        <h1>长宁区咖啡馆</h1>
      </div>
      <div id="map" className={Style.mapItem} />
    </div>
  );
};

相关配置

1、地图底图样式

mapbox://styles/mapbox/streets-v10
mapbox://styles/mapbox/outdoors-v10
mapbox://styles/mapbox/light-v9
mapbox://styles/mapbox/dark-v9
mapbox://styles/mapbox/satellite-v9
mapbox://styles/mapbox/satellite-streets-v10
mapbox://styles/mapbox/navigation-preview-day-v2
mapbox://styles/mapbox/navigation-preview-night-v2
mapbox://styles/mapbox/navigation-guidance-day-v2
mapbox://styles/mapbox/navigation-guidance-night-v2

var map = new mapboxgl.Map({
      style: "mapbox://styles/mapbox/streets-v10",
    });

2、常用配置项

circle

"layers": [
    {
        "id": "circle-id", // 唯一 id （必填）
        "type": "circle", // 类型（必填）
        "metadata": { // 元数据（可选，用于为 layer 附加任意的属性。为避免冲突，建议添加前缀，如 mapbox:）
            "mapbox:name": "test"
        },
        "source": "source-name", // 数据源的名称（除了 layer 的 type 为 background 外，source 必填） 
        "source-layer": "source-layer-name", // 数据源的图层（只有数据源 source 的 type 为 vector 时，才能设置 source-layer，其他类型的不可以设置）
        "minzoom": 0, // 最小层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时，layer 将被隐藏）
        "maxzoom": 24, // 最大层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时，layer 将被隐藏）
        "filter": [], // 过滤（可选，用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression）
        "layout": { // 布局类属性
            "visibility": "visible", // 可见性（可选，可选值为 none、visible，默认值为 visible）
        },
        "paint": { // 绘制类属性
            "circle-opacity": 1, // 圆点的不透明度（可选，取值范围为 0 ~ 1，默认值为 1）
            "circle-radius": 5, // 圆点的半径（可选，值 >= 0，默认值为 5，单位：像素）
            "circle-color": "#000000", // 圆点的颜色（可选，默认值为 #000000）
            "circle-blur": 0, // 圆点的虚化（可选，默认值为 0。当值为 1 时，表示把圆虚化到只有圆心是不透明的）
            "circle-translate": [0, 0], // 圆点的平移（可选，通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0]，单位：像素。）
            "circle-translate-anchor": "map", // 圆点的平移锚点，即相对的参考物（可选，可选值为 map、viewport，默认为 map）
            "circle-pitch-scale": "map", // 地图倾斜时圆点的缩放（可选，可选值为 map、viewport，默认为 map。值为 viewport 时，圆点不会缩放）
            "circle-pitch-alignment": "map", // 地图倾斜时圆点的对齐方式（可选，可选值为 map、viewport，默认为 map）
            "circle-stroke-width": 0, // 圆点的描边宽度（可选，值 >= 0，默认值为 0，单位：像素）
            "circle-stroke-color": "#000000", // 圆点的描边颜色（可选，默认值为 #000000）
            "circle-stroke-opacity": 1 // 圆点的描边不透明度（可选，取值范围为 0 ~ 1，默认值为 1）
        }
    }
]

symbol

"layers": [
    {
        "id": "symbol-id", // 唯一 id （必填）
        "type": "symbol", // 类型（必填）
        "metadata": { // 元数据（可选，用于为 layer 附加任意的属性。为避免冲突，建议添加前缀，如 mapbox:）
            "mapbox:name": "test"
        },
        "source": "source-name", // 数据源的名称（除了 layer 的 type 为 background 外，source 必填） 
        "source-layer": "source-layer-name", // 数据源的图层（只有数据源 source 的 type 为 vector 时，才能设置 source-layer，其他类型的不可以设置）
        "minzoom": 0, // 最小层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时，layer 将被隐藏）
        "maxzoom": 24, // 最大层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时，layer 将被隐藏）
        "filter": [], // 过滤（可选，用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression）
        "layout": { // 布局类属性
            "visibility": "visible", // 可见性（可选，可选值为 none、visible，默认值为 visible）
            "symbol-placement": "point", // 符号的位置（可选，可选值为 point、line、line-center，默认值为 point）
            // --- point：符号在几何形状的点上
            // --- line：符号在几何形状的线上（几何形状只能为 LineString 或 Polygon）
            // --- line-center：符号在几何形状的线的中心点上（几何形状只能为 LineString 或 Polygon）
            "symbol-spacing": 250, // 符号之间的距离（可选，值 >= 1，默认值为 250，单位：像素。只有 symbol-placement 为 line 时才有效）
            "symbol-avoid-edges": false, // 是否避免边缘冲突（可选，默认值为 false。当为 true 时，符号不会超过切片的边缘）
            "symbol-sort-key": 1, // 排序的参考值（可选，无默认值。值越大，越在上方） 
            "symbol-z-order": "auto", // z 轴上的顺序控制（可选，可选值为 auto、viewport-y、source，默认值为 auto）
            
            // 图标类属性（需要设置 icon-image）
            "icon-image": "", // 图标的图片（可选，这里填写在 sprite 雪碧图中图标名称）
            "icon-size": 1, // 图标的大小（可选，值 >= 0，默认值为 1。这里实际上是图标对应的原始图片的大小的缩放比例。值为 1 表示图标大小为原始图片的大小）
            "icon-padding": 2, // 图标的外边距（可选，值 >= 0，默认值为 2。可用于碰撞检测）
            "icon-offset": [0, 0], // 图标的偏移量（可选，默认值为 [0, 0]）
            "icon-anchor": "center", // 图标与锚点的位置关系（可选，可选值为 center、left、right、top、bottom、top-left、top-right、bottom-left、bottom-right，默认值为 center）
            "icon-rotation": 0, // 图标的顺时针旋转角度（可选，默认值为 0，单位：角度）
            "icon-allow-overlap": false, // 是否允许图标重叠（可选，默认值为 false。当值为 true 时，图标即使和其他符号触碰也会显示）
            "icon-ignore-placement": false, // 是否忽略图标位置（可选，默认值为 false。当值为 true 时，其他符号即使与此图标触碰也会显示）
            "icon-optional": false, // 图标是否可不显示（可选，默认值为 false。当值为 true 时，如果图标与文本标签碰撞，则显示文本标签）
            "icon-text-fit": "none", // 图标与文本的大小适应关系（可选，可选值为 none、width、height、both，默认值为 none）
            // --- none：图标按其本身的比例显示
            // --- width：图标在 x 轴上缩放以适应文本的宽度
            // --- height：图标在 y 轴上缩放以适应文本的高度
            // --- both：图标在 x 和 y 轴上缩放以适应文本的宽高
            "icon-text-fit-padding": [0, 0, 0, 0], // 图标与文本的内边距（可选，默认值为 [0,0,0,0]，单位：像素）
            "icon-keep-upright": false, // 当 icon-rotation-alignment 为 map，且 symbol-placement 为 line 或者 line-center 时，设置为 true 的话，可以避免图标上下颠倒
            "icon-rotation-alignment": "auto", // 地图旋转时图标的对齐方式（可选，可选值为 map、viewport、auto，默认值为 auto）
            // --- map：当 symbol-placement 为 point 时，图标与地图的东西方向对齐；当 symbol-placement 为 line 时，图标的 x 轴和线对齐
            // --- viewport：图标的 x 轴和视口的 x 轴对齐
            // --- auto：当 symbol-placement 为 point 时，和 viewport 一致；当 symbol-placement 为 line 时，和 map 一致
            "icon-pitch-alignment": "auto", // 地图倾斜时图标的对齐方式（可选，可选值为 map、viewport、auto，默认值为 auto）
            // --- map：图标的 x 轴与地图平面对齐
            // --- viewport：图标的 x 轴和视口的 x 轴对齐
            // --- auto：当 symbol-placement 为 point 时，和 viewport 一致；当 symbol-placement 为 line 时，和 map 一致
            
            // 文本类属性（需要指定 text-field）
            "text-rotation-alignment": "auto", // 与 icon-rotation-alignment 类似
            "text-pitch-alignment": "auto", // 与 icon-pitch-alignment 类似
            "text-field": "", // 文本所对应的字段（可选，默认值为 ""）
            "text-font": ["Open Sans Regular","Arial Unicode MS Regular"], // 文本的字体集合（可选，默认值为 ["Open Sans Regular","Arial Unicode MS Regular"]）
            "text-size": 16, // 文本的大小（可选，默认值为 16，单位：像素）
            "text-max-width": 10, // 文本的最大宽度，超过则折行（可选，默认值为 10，单位：ems） 
            "text-line-height": 1.2, // 文本的行高（可选，默认值为 1.2，单位：ems）
            "text-letter-spacing": 0, // 文本的字符间距（可选，默认值为 0，单位：ems）
            "text-justify": "center", // 文本的水平对齐方式（可选，可选值为 auto、left、center、right。默认值为 center）
            "text-anchor": "center", // 文本与锚点的位置关系（可选，可选值为 center、left、right、top、bottom、top-left、top-right、bottom-left、bottom-right，默认值为 center）
            "text-variable-anchor": "center", // 与 text-anchor（优先级更高） 类似，有点不懂
            "text-max-angle": 45, // 当 symbol-placement 为 line 或 line-center 时，文本相邻字符的最大夹角，默认 45 度
            "text-rotate": 0, // 文本的顺时针旋转角度（可选，默认值为 0，单位：角度）
            "text-padding": 2, // 文本的外边距（可选，值 >= 0，默认值为 2。可用于碰撞检测）
            "text-keep-upright": false, // 当 icon-rotation-alignment 为 map，且 symbol-placement 为 line 或者 line-center 时，设置为 true 的话，可以避免文本上下颠倒
            "text-transform": "none", // 文本大小写转换（可选，可选值为 none、uppercase、lowercase，默认值为 none）
            "text-offset": [0, 0], // 图标的偏移量（可选，默认值为 [0, 0]）
            "text-radial-offset": 0, // 文本的径向偏移量，优先级比 text-offset 高
            "text-allow-overlap": false, // 是否允许文本重叠（可选，默认值为 false。当值为 true 时，文本即使和其他符号触碰也会显示）
            "text-ignore-placement": false, // 是否忽略文本位置（可选，默认值为 false。当值为 true 时，其他符号即使与此文本触碰也会显示）
            "text-optional": false // 文本是否可不显示（可选，默认值为 false。当值为 true 时，如果文本与图标碰撞，则显示图标）
            
        },
        "paint": { // 绘制类属性
            
            // 图标类属性（需要设置 icon-image）
            "icon-opacity": 1, // 图标的不透明度（可选，取值范围为 0 ~ 1，默认值为 1）
            "icon-color": "#000000", // 图标的颜色（可选，默认值为 #000000）
            "icon-halo-color": "rgba(0,0,0,0)", // 图标的光晕颜色（可选，默认值为 rgba(0,0,0,0)）
            "icon-halo-width": 0, // 图标的光晕宽度（可选，值 >= 0，默认值为 0，单位：像素）
            "icon-halo-blur": 0, // 图标的光晕模糊宽度（可选，值 >= 0，默认值为 0，单位：像素）
            "icon-translate": [0, 0], // 图标的平移（可选，通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0]，单位：像素。）
            "icon-translate-anchor": "map", // 图标的平移锚点，即相对的参考物（可选，可选值为 map、viewport，默认为 map）
            
            // 文本类属性（需要设置 text-field）
            "text-opacity": 1, // 文本的不透明度（可选，取值范围为 0 ~ 1，默认值为 1）
            "text-color": "#000000", // 文本的颜色（可选，默认值为 #000000）
            "text-halo-color": "rgba(0,0,0,0)", // 文本的光晕颜色（可选，默认值为 rgba(0,0,0,0)）
            "text-halo-width": 0, // 文本的光晕宽度（可选，值 >= 0，默认值为 0，单位：像素）
            "text-halo-blur": 0, // 文本的光晕模糊宽度（可选，值 >= 0，默认值为 0，单位：像素）
            "text-translate": [0, 0], // 文本的平移（可选，通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0]，单位：像素。）
            "text-translate-anchor": "map", // 文本的平移锚点，即相对的参考物（可选，可选值为 map、viewport，默认为 map）
        }
    }
]

line

"layers": [
    {
        "id": "line-id", // 唯一 id （必填）
        "type": "line", // 类型（必填）
        "metadata": { // 元数据（可选，用于为 layer 附加任意的属性。为避免冲突，建议添加前缀，如 mapbox:）
            "mapbox:name": "test"
        },
        "source": "source-name", // 数据源的名称（除了 layer 的 type 为 background 外，source 必填） 
        "source-layer": "source-layer-name", // 数据源的图层（只有数据源 source 的 type 为 vector 时，才能设置 source-layer，其他类型的不可以设置）
        "minzoom": 0, // 最小层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时，layer 将被隐藏）
        "maxzoom": 24, // 最大层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时，layer 将被隐藏）
        "filter": [], // 过滤（可选，用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression）
        "layout": { // 布局类属性
            "visibility": "visible", // 可见性（可选，可选值为 none、visible，默认值为 visible）
            "line-cap": "butt", // 线末端的显示样式（可选，可选值为 butt、round、square，默认值为 butt）
            // --- butt：方型末端（仅绘制到线的端点）
            // --- round：圆型末端（以线宽的 1/2 为半径，以线的端点为圆心，绘制圆型端点，会超出线的端点）
            // --- square：方型末端（以线宽的 1/2 长度超出线的端点）
            "line-join": "miter", // 线交叉时的显示样式（可选，可选值为 bevel、round、miter，默认值为 miter）
            // --- bevel：方型交点（以线宽的 1/2 长度超出线的交点）
            // --- round：圆型交点（以线宽的 1/2 为半径，以线的交点为圆心，绘制圆型交点，会超出线的交点）
            // --- miter：尖型交点（以两线段的外沿相交，超出交点绘制）
            "line-miter-limit": 2, // 最大斜接长度（可选，用来将 miter 尖型交点自动转为 bevel 方型交点，默认值为 2。只有 line-join 为 miter 时，才需要设置此属性）
            "line-round-limit": 1.05, // 最小圆角半径（可选，用来将 round 圆型交点自动转为 miter 尖型交点，默认值为 1.05。只有 line-join 为 round 时，才需要设置此属性）
        },
        "paint": { // 绘制类属性
            "line-opacity": 1, // 线的不透明度（可选，取值范围为 0 ~ 1，默认值为 1）
            "line-pattern": "", // 线用的图案（可选，这里填写在 sprite 雪碧图中图标名称。为了图案能无缝填充，图标的高宽需要是 2 的倍数）
            "line-color": "#000000", // 线的颜色（可选，默认值为 #000000。如果设置了 line-pattern，则 line-color 将无效）
            "line-translate": [0, 0], // 线的平移（可选，通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0]，单位：像素。）
            "line-translate-anchor": "map", // 线的平移锚点，即相对的参考物（可选，可选值为 map、viewport，默认为 map）
            "line-width": 1, // 线的宽度（可选，值 >= 0，默认值为 1，单位：像素）
            "line-gap-width": 0, // 线的外部间距宽度（可选，值 >= 0，默认值为 0，单位：像素。用来在线的外部再绘制一部分，此值表示内间距）
            "line-offset": 0, // 线的偏移（可选，默认值为 0，单位：像素。对于单线，则是向右的偏移量；对于多边形，正值为内缩 inset，负值为外突 outset）
            "line-blur": 0, // 线的模糊度（可选，值 >= 0，默认值为 0，单位：像素）
            "line-dasharray": [0, 0], // 虚线的破折号部分和间隔的长度（可选，默认值为 [0, 0]。如果设置了 line-pattern，则 line-dasharray 将无效）
            "line-gradient": "#000000", // 线的渐变色（可选。如果设置了 line-pattern 或 line-dasharray，则 line-gradient 将无效。只有数据源 source 的 type 为 geojson ，且 source 的 lineMetrics 为 true 时，line-gradient 才有效）
        }
    }
]

fill

"layers": [
    {
        "id": "fill-id", // 唯一 id （必填）
        "type": "fill", // 类型（必填）
        "metadata": { // 元数据（可选，用于为 layer 附加任意的属性。为避免冲突，建议添加前缀，如 mapbox:）
            "mapbox:name": "test"
        },
        "source": "source-name", // 数据源的名称（除了 layer 的 type 为 background 外，source 必填） 
        "source-layer": "source-layer-name", // 数据源的图层（只有数据源 source 的 type 为 vector 时，才能设置 source-layer，其他类型的不可以设置）
        "minzoom": 0, // 最小层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时，layer 将被隐藏）
        "maxzoom": 24, // 最大层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时，layer 将被隐藏）
        "filter": [], // 过滤（可选，用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression）
        "layout": { // 布局类属性
            "visibility": "visible", // 可见性（可选，可选值为 none、visible，默认值为 visible）
        },
        "paint": { // 绘制类属性
            "fill-antialias": true, // 填充时是否反锯齿（可选，默认值为 true）
            "fill-opacity": 1, // 填充的不透明度（可选，取值范围为 0 ~ 1，默认值为 1）
            "fill-pattern": "", // 填充用的图案（可选，这里填写在 sprite 雪碧图中图标名称。为了图案能无缝填充，图标的高宽需要是 2 的倍数）
            "fill-color": "#000000", // 填充的颜色（可选，默认值为 #000000。如果设置了 fill-pattern，则 fill-color 将无效）
            "fill-outline-color": "#000000", // 描边的颜色（可选，默认和 fill-color 一致。如果设置了 fill-pattern，则 fill-outline-color 将无效。为了使用此属性，还需要设置 fill-antialias 为 true）
            "fill-translate": [0, 0], // 填充的平移（可选，通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0]，单位：像素。）
            "fill-translate-anchor": "map" // 平移的锚点，即相对的参考物（可选，可选值为 map、viewport，默认为 map）
        }
    }
]

fill-extrusion

"layers": [
    {
        "id": "fill-extrusion-id", // 唯一 id （必填）
        "type": "fill-extrusion", // 类型（必填）
        "metadata": { // 元数据（可选，用于为 layer 附加任意的属性。为避免冲突，建议添加前缀，如 mapbox:）
            "mapbox:name": "test"
        },
        "source": "source-name", // 数据源的名称（除了 layer 的 type 为 background 外，source 必填） 
        "source-layer": "source-layer-name", // 数据源的图层（只有数据源 source 的 type 为 vector 时，才能设置 source-layer，其他类型的不可以设置）
        "minzoom": 0, // 最小层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时，layer 将被隐藏）
        "maxzoom": 24, // 最大层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时，layer 将被隐藏）
        "filter": [], // 过滤（可选，用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression）
        "layout": { // 布局类属性
            "visibility": "visible", // 可见性（可选，可选值为 none、visible，默认值为 visible）
        },
        "paint": { // 绘制类属性
            "fill-extrusion-opacity": 1, // 三维填充的不透明度（可选，取值范围为 0 ~ 1，默认值为 1）
            "fill-extrusion-pattern": "", // 三维填充的图案（可选，这里填写在 sprite 雪碧图中图标名称。为了图案能无缝填充，图标的高宽需要是 2 的倍数）
            "fill-extrusion-color": "#000000", // 三维填充的颜色（可选，默认值为 #000000）
            "fill-extrusion-translate": [0, 0], // 三维填充的平移（可选，通过平移 [x, y] 达到一定的偏移量。默认值为 [0, 0]，单位：像素。）
            "fill-extrusion-translate-anchor": "map", // 平移的锚点，即相对的参考物（可选，可选值为 map、viewport，默认为 map）
            "fill-extrusion-height": 0, // 三维填充的高度（可选，值 >= 0，默认值为 0，单位：米）
            "fill-extrusion-base": 0, // 三维填充的底部高度（可选，值 >= 0，默认值为 0，单位：米。值必须小于等于 fill-extrusion-height）
            "fill-extrusion-vertical-gradient": true, // 是否开启垂直渐变（可选，默认值为 true）
        }
    }
]

background

"layers": [
    {
        "id": "background-id", // 唯一 id （必填）
        "type": "background", // 类型（必填）
        "metadata": { // 元数据（可选，用于为 layer 附加任意的属性。为避免冲突，建议添加前缀，如 mapbox:）
            "mapbox:name": "test"
        },
        "minzoom": 0, // 最小层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时，layer 将被隐藏）
        "maxzoom": 24, // 最大层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时，layer 将被隐藏）
        "layout": { // 布局类属性
            "visibility": "visible", // 可见性（可选，可选值为 none、visible，默认值为 visible）
        },
        "paint": { // 绘制类属性
            "background-color": "#000000", // 背景颜色（可选，默认值为 #000000。如果设置了 background-pattern，则 background-color 将无效）
            "background-pattern": "", // 背景图案（可选，这里填写在 sprite 雪碧图中图标名称。为了背景图案能无缝填充，图标的高宽需要是 2 的倍数）
            "background-opacity": 1 // 背景不透明度（可选，取值范围为 0 ~ 1，默认值为 1） 
        }
    }
]

栅格：（用于绘制栅格地图，比如卫星影像）

"layers": [
    {
        "id": "raster-id", // 唯一 id （必填）
        "type": "raster", // 类型（必填）
        "metadata": { // 元数据（可选，用于为 layer 附加任意的属性。为避免冲突，建议添加前缀，如 mapbox:）
            "mapbox:name": "test"
        },
        "source": "source-name", // 数据源的名称（除了 layer 的 type 为 background 外，source 必填） 
        "source-layer": "source-layer-name", // 数据源的图层（只有数据源 source 的 type 为 vector 时，才能设置 source-layer，其他类型的不可以设置）
        "minzoom": 0, // 最小层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时，layer 将被隐藏）
        "maxzoom": 24, // 最大层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时，layer 将被隐藏）
        "filter": [], // 过滤（可选，用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression）
        "layout": { // 布局类属性
            "visibility": "visible", // 可见性（可选，可选值为 none、visible，默认值为 visible）
        },
        "paint": { // 绘制类属性
            "raster-opacity": 1, // 图片的不透明度（可选，取值范围为 0 ~ 1，默认值为 1）
            "raster-hue-rotate": 0, // 在色轮上旋转色相的角度（可选，默认值为 0，单位：角度）
            "raster-brightness-min": 0, // 图片的最小亮度（可选，取值范围为 0 ~ 1，默认值为 0）
            "raster-brightness-max": 1, // 图片的最大亮度（可选，取值范围为 0 ~ 1，默认值为 1）
            "raster-saturation": 0, // 图片的饱和度（可选，取值范围为 -1 ~ 1，默认值为 0）
            "raster-contrast": 0, // 图片的对比度（可选，取值范围为 -1 ~ 1，默认值为 0）
            "raster-resampling": "linear", // 采样方式（可选，可选值为 linear、nearest，默认值为 linear） 
            "raster-fade-duration": 300 // 切换瓦片时的渐隐时间（可选，默认值为 300，单位：毫秒）
        }
    }
]

hillshade：坡面阴影（基于 DEM 数字高程模型进行坡面阴影的可视化渲染）

"layers": [
    {
        "id": "hillshade-id", // 唯一 id （必填）
        "type": "hillshade", // 类型（必填）
        "metadata": { // 元数据（可选，用于为 layer 附加任意的属性。为避免冲突，建议添加前缀，如 mapbox:）
            "mapbox:name": "test"
        },
        "source": "source-name", // 数据源的名称（除了 layer 的 type 为 background 外，source 必填） 
        "source-layer": "source-layer-name", // 数据源的图层（只有数据源 source 的 type 为 vector 时，才能设置 source-layer，其他类型的不可以设置）
        "minzoom": 0, // 最小层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 小于此 minzoom 时，layer 将被隐藏）
        "maxzoom": 24, // 最大层级（可选，取值范围为 0 ~ 24。当 style 的 zoom 大于此 maxzoom 时，layer 将被隐藏）
        "filter": [], // 过滤（可选，用特定的表达式过滤指定的数据源的要素。具体的表达式详见 expression）
        "layout": { // 布局类属性
            "visibility": "visible", // 可见性（可选，可选值为 none、visible，默认值为 visible）
        },
        "paint": { // 绘制类属性
            "hillshade-illumination-direction": 335, // 光照的方向（可选，取值范围为 0 ~ 359，默认值为 335，单位：角度）
            "hillshade-illumination-anchor": "viewport", // 光照的锚点（可选，可选值为 map、viewport，默认值为 viewport）
            "hillshade-exaggeration": 0.5, // 阴影的强度（可选，取值范围为 0 ~ 1，默认值为 0.5）
            "hillshade-shadow-color": "#000000", // 阴影的颜色（可选，默认值为 #000000）
            "hillshade-highlight-color": "#ffffff", // 光照部分的颜色（可选，默认值为 #ffffff）
            "hillshade-accent-color": "#000000" // 用于强调地形的颜色（可选，默认值为 #000000）
        }
    }
]