本文主要是介绍Mapbox Android学习笔记（8）离线地图，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！
Offline
通常，您可能会发现您的用户群大部分时间都不在网格上。Maps SDK允许您下载和存储预先选择的区域，以便在设备脱机时使用。下载地图的结果是使用下载区域内的style、tile和其他资源生成功能齐全的地图。
Offline Plugin
用户的设备并不总是有足够强大的互联网连接来下载和查看地图块。您可能想要在Android项目中构建一个离线模式来解释这种情况。Android的Mapbox离线插件是一种方便的方式，可以将信息发送到Maps SDK的离线管理器类，并使用后台服务中的管理器下载地图块供离线使用。一旦离线下载区域被定义并初始化，插件将为您处理所有其他事情。因为插件使用服务，所以即使应用程序在后台运行，下载也会继续。
限制
一个应用程序可以下载多个区域供离线使用，但所有下载区域的离线下载总量都有一个最大平铺计数上限。SDK将tile ceiling设置为6000个tile。使用我们的Tile Count Estimator来计算脱机用例所需的Tile数量。在M25变焦等级为0-15的范围内，六千块tile覆盖了一个大致相当于大伦敦的区域；而在变焦等级为0-9的范围内，则覆盖了邻近的美国。磁盘上这些块的大小将根据所选的样式而变化。
Maps SDK不限制可以创建的离线区域的数量。您的mapbox支持的应用程序将重用多个区域所需的tile和资源，从而节约网络流量和磁盘空间。
SDK也不限制离线区域的下载速度，也不限制离线资源使用的磁盘空间。这些限制将取决于移动设备的存储容量和所连接网络的速度。
我们的服务条款不允许您或最终用户重新分发从Mapbox服务器下载的离线地图。
Tile的自动更新
Maps SDK在任何连接可用时下载tile，包括通过常规移动数据(2G、3G、4G等)下载。因为只有单独的高度优化的tile下载，所以在已经下载的区域打开地图，不会有用户意外下载100 MB的风险。除非用户正在浏览100 MB大小的tile。
当SDK自动更新离线地图贴片时，离线区域不会重新下载。离线tile更新过程与常规map tile的更新过程相同:只有当tile有新版本时才下载map tile。
定义一个区域
在脱机使用某个区域之前，必须下载该区域所需的资源。根据在创建区域时指定的参数，SDK计算所有资源需求，比如覆盖该区域的字体、样式和向量块。如果脱机数据库中的多个区域包含字体和样式，则在下载其他区域时不会重新下载这些字体和样式。
首先，您需要获得 offlineManager 实例，定义要下载的区域，最后创建 definition 对象。注意几件事很重要：
- 离线地图样式必须匹配用于mapView的样式
- 这个定义需要设备的屏幕密度，您应该从activities的资源中获得这个定义
- 下载使用的边界不能超过 6000 个平铺限制
示例：
// Set up the OfflineManager
OfflineManager offlineManager = OfflineManager.getInstance(MainActivity.this);// Create a bounding box for the offline region
LatLngBounds latLngBounds = new LatLngBounds.Builder().include(new LatLng(37.7897, -119.5073)) // Northeast.include(new LatLng(37.6744, -119.6815)) // Southwest.build();// Define the offline region
OfflineTilePyramidRegionDefinition definition = new OfflineTilePyramidRegionDefinition(mapboxMap.getStyleUrl(),latLngBounds,10,20,MainActivity.this.getResources().getDisplayMetrics().density);
元数据
鼓励使用至少一个区域名称来提供元数据对象，以便用户下载的各个区域可以被区分开来。除了区域名称之外，您还可以存储任何您想要的二进制区域信息。这些内容对SDK实现是不透明的，不会影响您的离线区域下载，它只存储和检索一个字节数组。示例如下：
// 使用JSON将Yosemite国家公园存储为离线区域名称的实现
byte[] metadata;
try {JSONObject jsonObject = new JSONObject();jsonObject.put(JSON_FIELD_REGION_NAME, "Yosemite National Park");String json = jsonObject.toString();metadata = json.getBytes(JSON_CHARSET);
} catch (Exception exception) {Log.e(TAG, "Failed to encode metadata: " + exception.getMessage());metadata = null;
}
除了创建元数据，还可以更新存储的信息，例如允许用户更新区域名称。 offlineManager 对象提供一个名为 updateMetadata 的方法，该方法接收更新后的元数据字节数组和一个回调函数，当更新完成或发生错误时，回调函数将被通知。
下载一个区域
现在已经创建了边界和定义对象，您可以使用 offlineManager 创建一个调用 createOfflineRegion 的异步下载。您需要传入 在定义区域和元数据部分中 创建的定义和元数据对象。这将为您提供两个方法， onCreate 和 onError 。如果启动或下载区域时发生错误，则发生 onError 。onCreate 方法提供了一个 offlineRegion 对象，您可以使用该对象检查下载，甚至向用户显示进度。如果需要暂停下载，可以使用offlineRegion.setDownloadState()来处理这个问题。
下载示例：
// 异步创建区域
offlineManager.createOfflineRegion(definition, metadata,new OfflineManager.CreateOfflineRegionCallback() {@Overridepublic void onCreate(OfflineRegion offlineRegion) {offlineRegion.setDownloadState(OfflineRegion.STATE_ACTIVE);// 使用 setObserver 监视下载过程offlineRegion.setObserver(new OfflineRegion.OfflineRegionObserver() {@Overridepublic void onStatusChanged(OfflineRegionStatus status) {// 计算下载进度（百分比）double percentage = status.getRequiredResourceCount() >= 0? (100.0 * status.getCompletedResourceCount() / status.getRequiredResourceCount()) :0.0;if (status.isComplete()) {// 下载结束Log.d(TAG, "Region downloaded successfully.");} else if (status.isRequiredResourceCountPrecise()) {Log.d(TAG, percentage);}}@Overridepublic void onError(OfflineRegionError error) {// 发生错误时，打印到 logcatLog.e(TAG, "onError reason: " + error.getReason());Log.e(TAG, "onError message: " + error.getMessage());}@Overridepublic void mapboxTileCountLimitExceeded(long limit) {// 如果脱机区域超过最大平铺数，请通知Log.e(TAG, "Mapbox tile count limit exceeded: " + limit);}});}@Overridepublic void onError(String error) {Log.e(TAG, "Error: " + error);}
});
管理下载的区域
一旦您或您的用户下载了一个区域，Maps SDK提供了一些选项来处理收集列表、将摄像机定位在下载的区域内以及删除区域的方法。
下载列表
区域列表对于向用户显示下载的信息或在代码内部收集信息非常有用。 offlineManager 提供了一个 listOfflineRegions 方法，该方法同时提供了 onList 和 onError 方法。使用 OfflineRegion 数组执行特定区域中的所有操作。
// 获取区域边界和缩放情况，并移动相机。
LatLngBounds bounds = ((OfflineTilePyramidRegionDefinition)offlineRegions[regionSelected].getDefinition()).getBounds();
double regionZoom = ((OfflineTilePyramidRegionDefinition)offlineRegions[regionSelected].getDefinition()).getMinZoom();// 新的相机位置
CameraPosition cameraPosition = new CameraPosition.Builder().target(bounds.getCenter()).zoom(regionZoom).build();// 移动相机
mapboxMap.moveCamera(CameraUpdateFactory.newCameraPosition(cameraPosition))
删除区域
要从数据库中删除脱机区域，您需要首先接收脱机区域列表，如前一节所述。 onList 方法将为您提供在设备上下载的当前脱机区域的数组，该对象是 offlineRegions 。然后，您将使用此对象选择要删除的区域并在其上调用 delete，它将为您提供一个回调函数，以便在成功删除该区域或发生错误时通知您。
删除一个区域还将删除其他区域不需要的最近请求最少的资源，直到数据库缩小到一定的大小。
移除区域回调函数：
offlineRegions[0].delete(new OfflineRegion.OfflineRegionDeleteCallback() {@Overridepublic void onDelete() {// 一旦该区域被删除，隐藏progressBar并显示toastprogressBar.setVisibility(View.INVISIBLE);progressBar.setIndeterminate(false);Toast.makeText(MainActivity.this, "Region deleted", Toast.LENGTH_LONG).show();}@Overridepublic void onError(String error) {progressBar.setVisibility(View.INVISIBLE);progressBar.setIndeterminate(false);Log.e(TAG, "Error: " + error);}
});
Offline sideloading
侧面加载是一个 为离线地区提供可用的手机应用程序 的两部分过程（two-part process）。第一步是打包在SDK外部创建离线区域所需的tile和资源，和第二步是将创建的离线包合并到SDK的离线数据库中。
生成离线包
要生成包含特定区域的tile和资源的脱机包，您有两个选项。您可以使用命令行工具，也可以使用 macOS 图形界面。 CLI 选项适用于任何操作系统，而 macOS 选项仅适用于 macOS 环境。
请注意，您的移动应用程序的脱机功能范围仅限于6000个tile。有关此“tile ceiling”的详细信息，参考上面的“限制”部分。
命令行使用参考：https://docs.mapbox.com/android/maps/overview/offline/#generate-the-offline-package
合并脱机包
一旦创建了一个新的脱机包，将该文件复制到设备，以便脱机合并 API 可以将其内容合并到主 Maps SDK 数据库中。可以使用 adb 在本地复制该文件，也可以从服务器下载该文件。Maps SDK 从一个主数据库加载所有tile和资源，并提供离线合并API来将新的辅助数据库的内容合并到主数据库中。
注意：在Android Maps SDK的v6.6.0之前，当离线合并API不可用时，边加载的解决方案是删除主数据库文件并添加自己的离线数据库。虽然这种方法在技术上仍然可行，但不再推荐使用它，因为它不允许合并多个数据库，而且很容易崩溃。
将辅助数据库合并到主Maps SDK数据库中的步骤：https://docs.mapbox.com/android/maps/overview/offline/#merge-the-offline-package
要获得完整的示例，请查看MergeOfflineRegionsActivity和示例数据库。有关更多细节，请参阅mergeOfflineRegions文档。
Android上的数据库位置
在Android上，您可以将主地图SDK数据库的位置从内部存储移动到外部存储。为此，请确保应用程序在 AndroidManifest.xml 中具有WRITE_EXTERNAL_STORAGE 权限和以下标志：
<application><meta-dataandroid:name="com.mapbox.SetStorageExternal"android:value="true" />...
</application>
这篇关于Mapbox Android学习笔记（8）离线地图的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！
