本文主要是介绍Mapbox Android学习笔记（11）地图快照，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
Snapshotter
Snapshotter 是官方文档的最后一部分内容。用于Android的Mapbox Maps SDK的快照功能生成一个静态地图图像，用于您的Android项目。获取任何Mapbox Map的快照并将图像添加到：
- 应用程序中的另一个屏幕
- 一个主屏幕
- 主屏幕小部件
- 活动通知
- ListView / RecyclerView
- 可以放置 Bitmap 位图的地方
使用快照功能不需要显示Mapbox地图。MapSnapshotter 可以在应用程序的任何地方调用。
除非您已经缓存了地图块，否则设备将需要一个internet连接来下载呈现地图所需的样式和块，从而下载快照。
快照生成可以发生在设备的后台线程上，不会影响用户体验。
这个快照特性与 Mapbox 静态图像API不同。 MapboxStaticMap 类帮助您构建一个URL来请求一个静态地图图像，该图像看起来像一个嵌入式地图，没有交互性或控件。
Taking a map snapshot
MapSnapshotter 构造函数需要一个 MapSnapshotter.Options 对象，示例如下：
// 初始化
MapSnapshotter.Options snapShotOptions = new MapSnapshotter.Options(500, 500);// 设置 snapShotOptions
snapShotOptions.withRegion(mapboxMap.getProjection().getVisibleRegion().latLngBounds);
snapShotOptions.withStyle(mapboxMap.getStyle().getUrl());// 作为参数传入 mapSnapshotter
MapSnapshotter mapSnapshotter = new MapSnapshotter(this, snapShotOptions);
以下是 MapSnapshotter.Options 中可用的各种设置。您将以与上面代码片段中使用 withRegion() 和 withStyle() 相同的方式使用它们。
- withApiBaseUrl：指定用于地图API端点的URL。很少需要更改API基本URL。
- withLocalIdeographFontFamily：在“CJK统一表意文字（CJK Unified Ideographs）”和“汉古音节（Hangul Syllables）”范围内设置用于本地生成表意文字符号的字体族。
- withCameraPosition：用于快照图像的相机位置。如果还使用 withRegion，则此位置是覆盖的。
- withLogo：一个布尔标志，用于确定快照图像中是否包含Mapbox徽标。
- withPixelRatio：使用的像素比。默认值是1。
- withRegion：要在快照图像中显示的区域。这是应用后的相机位置。
- withStyle：要在快照图像中使用的地图样式URL。
- withStyleJson：要使用的地图样式JSON，而不是地图样式URL。
创建 MapSnapshotter 对象后，使用 Start() 启动快照进程。当 MapSnapshot 就绪时，使用 snap.getbitmap() 检索 Bitmap 位图图像。示例如下：
mapSnapshotter.start(new MapSnapshotter.SnapshotReadyCallback() {@Overridepublic void onSnapshotReady(MapSnapshot snapshot) {// Display, share, or use bitmap image how you'd likeBitmap bitmapImage = snapshot.getBitmap();}
});
一旦你有了位图图像，你就可以随心所欲地使用它了。
Mapbox Android 演示应用程序有两个例子，展示了如何使用快照位图图像。详情见官方示例 在通知中使用快照图像 和 分享实时快照地图。
这篇关于Mapbox Android学习笔记（11）地图快照的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
