Mapbox SDK 允许在 Android 设备上使用预加载的瓦片集进行离线地图。首先，需要在应用程序的 build.gradle 文件中添加以下依赖项：

implementation 'com.mapbox.mapboxsdk:mapbox-android-sdk:9.6.3'

然后，可以在应用程序中创建 Mapbox offlineManager 实例，以便缓存地图数据。下面是代码示例：

// 创建离线管理器实例 OfflineManager offlineManager = OfflineManager.getInstance(context);

// 创建离线定义对象 OfflineTilePyramidRegionDefinition definition = new OfflineTilePyramidRegionDefinition( // 该坐标定义了离线地图覆盖的区域 LatLngBounds.from(40.700,-74.100,40.705,-74.095), // 缩放级别范围 10, 20, // 要使用的 Mapbox 样式 URL "mapbox://styles/mapbox/streets-v11");

// 设置离线下载选项 byte[] metadata = "".getBytes(); // 可选：一些关于离线区域的元数据 OfflineTilePyramidRegionTask task = new OfflineTilePyramidRegionTask(definition, metadata);

// 发出异步请求 offlineManager.createOfflineRegion(task, new OfflineManager.CreateOfflineRegionCallback() { @Override public void onCreate(OfflineRegion offlineRegion) { //下载状态变化监听 offlineRegion.setDownloadState(OfflineRegion.STATE_DOWNLOADING);

    //显示进度百分比
    OfflineRegion.OfflineRegionObserver observer = new OfflineRegion.OfflineRegionObserver() {
        @Override
        public void onStatusChanged(OfflineRegionStatus status) {
            double percentage = status.getDownloadedBytes() * 100.0 / status.getRequiredResourceCount();
            //TODO 显示进度百分比
            if (status.isComplete()) {
                offlineRegion.setDownloadState(OfflineRegion.STATE_ACTIVE);
            } else if (status.isRequiredResourceCountPrecise()) {
                //TODO 显示估计的剩余下载时间
            }
        }

        @Override
        public void onError(OfflineRegionError error) {
            // 下载错误
        }

        @Override
        public void mapboxTileCountLimitExceeded(long limit) {
            // 超出了最大瓷砖下载限制
        }
    };

    // 注册下载状态监听器
    offlineRegion.setObserver(observer);

    // 将请求发送到创建队列
    task.addRegionDownloadListener(new OfflineRegion.OfflineRegionDownloadListener() {
        @Override
        public void onProgressChanged(long regionId, int completedBytes, int requiredBytes) {

        }

        @Override
        public void onRegionDownloaded(long regionId) {

        }

        @Override
        public void onError(long regionId, OfflineRegionError error) {

        }
    });
    offlineRegion.setDownloadState(OfflineRegion.STATE_DOWNLOADING);
}

@Override
public void onError(String error) {
    // 创建离线区域错误
}

});

该代码将创建一个离线区域，该区域包括地图样式“mapbox://styles/mapbox/streets-v11”中指定的区域、缩放级别 10-20，以及其他元数据。下载会在后台进行，直到完成。可以使用离线管理器实例访问