MapBox GL 地图页面保存为图片的方法

MapBox GL没有自带的截图api，在github上有人写了一个控件 https://github.com/geolonia/mbgl-export-control。

但控件只能以固定的方式使用，本人做了一下改动：

核心代码如下：

import 'canvas-toBlob'
import FileSaver from 'file-saver'
import mapboxgl from 'mapbox-gl'

function setStyles (element, styles) {
  for (const style in styles) {
    element.style[style] = styles[style]
  }
}

export default function (map, name) {
  const actualPixelRatio = window.devicePixelRatio
  Object.defineProperty(window, 'devicePixelRatio', {
    get: () => 300 / 96
  })

  const _container = document.createElement('div')
  document.body.appendChild(_container)

  const width = map.getContainer().offsetWidth
  const height = map.getContainer().offsetHeight
  // const bottomRight = map.unproject([width, height]).toArray()

  setStyles(_container, {
    visibility: 'hidden',
    position: 'absolute',
    top: 0,
    bottom: 0,
     `${width}px`,
    height: `${height}px`
  })

  let fontFamily = []
  if (map.style.glyphManager && map.style.glyphManager.localIdeographFontFamily) {
    fontFamily = map.style.glyphManager.localIdeographFontFamily
  }

  let MBGL = mapboxgl.Map
  const _map = new MBGL({
    container: _container,
    center: map.getCenter(),
    zoom: map.getZoom(),
    bearing: map.getBearing(),
    pitch: map.getPitch(),
    style: map.getStyle(),
    localIdeographFontFamily: fontFamily,
    hash: false,
    preserveDrawingBuffer: true,
    interactive: false,
    attributionControl: false
  })

  _map.once('load', () => {
    _map.getCanvas().toBlob((blob) => {
      FileSaver.saveAs(blob, name + '.png')
      _map.remove()
      _container.parentNode.removeChild(_container)
      _loading.parentNode.removeChild(_loading)
      Object.defineProperty(window, 'devicePixelRatio', {
        get: () => actualPixelRatio
      })
    })
  })
}

说明：

1. 需要安装canvas-toBlob和file-saver，前者用于转换地图的canvas，后者用于把blob存储为图片；

mapbox-gl 是使用的地图库，如果基于ol或minemap的地图应用，引入相应的库即可

2. 截图的主要原理：

a.通过参数获取当前的map对象，得到div大小，地图的图层信息，地图状态的center、zoom、pitch和bearing等

b.新建一个和map对象容器一样大的div，在该div中创建新的地图对象，添加和原map对象一样的图层，设置相同的地图状态

注意，该新的div需要设置为隐藏状态，即 visibility: 'hidden'

c.获取新的地图对象的canvas，另存为图片

提供一种思路，可以修改后用于保存其他地图库，代码请参考：

https://github.com/shiyuan598/Map-Visualization/tree/master/mapbox-template