开发Android应用：基于osmdroid实现运行时下载OpenStreetMap离线地图是否可行？

当然可以实现运行时加载离线地图！用osmdroid完全能搞定这个需求，我来一步步给你拆解具体操作：

osmdroid本身就支持离线瓦片地图的加载，而且完全支持在应用运行时动态切换瓦片源、根据用户位置调整地图显示区域，你的需求完全可以实现。

1. 提前准备离线地图瓦片 #

首先你需要用工具下载对应区域的OSM瓦片，推荐用Mobile Atlas Creator（MOBAC），下载时选择osmdroid的格式，瓦片会自动按[缩放级别]/[x坐标]/[y坐标].png的目录结构保存。之后把这些瓦片放到应用的私有存储目录，比如/Android/data/你的应用包名/files/osmdroid/tiles/下，也可以按不同区域分文件夹存放（比如CityA、CityB）。

2. 获取用户当前位置 #

要根据用户位置加载地图，首先得拿到用户的经纬度：

• 用Android的FusedLocationProviderClient来获取高精度位置，注意要申请运行时权限（ACCESS_FINE_LOCATION或ACCESS_COARSE_LOCATION），Android 13+还要处理权限弹窗请求。
• 示例代码（简化版）：

  private void getUserLocation() {
      FusedLocationProviderClient client = LocationServices.getFusedLocationProviderClient(this);
      if (ActivityCompat.checkSelfPermission(this, Manifest.permission.ACCESS_FINE_LOCATION) != PackageManager.PERMISSION_GRANTED) {
          ActivityCompat.requestPermissions(this, new String[]{Manifest.permission.ACCESS_FINE_LOCATION}, 1001);
          return;
      }
      client.getLastLocation().addOnSuccessListener(location -> {
          if (location != null) {
              double lat = location.getLatitude();
              double lon = location.getLongitude();
              // 拿到位置后加载对应地图
              loadMapForLocation(lat, lon);
          }
      });
  }
  

3. 配置离线瓦片源并加载对应区域 #

osmdroid的OfflineTileProvider会自动根据地图当前显示的区域去查找本地瓦片，所以核心是根据用户位置调整地图中心，并配置正确的瓦片路径：

基础版（单区域瓦片） #

如果你的离线瓦片是一个大区域（比如整个城市），直接配置TileProvider后把地图中心移到用户位置即可：

private void loadMapForLocation(double lat, double lon) {
    // 初始化osmdroid（建议在Application或Activity onCreate中做）
    Configuration.getInstance().load(this, PreferenceManager.getDefaultSharedPreferences(this));
    
    // 指定离线瓦片存储目录
    File tileDir = new File(getExternalFilesDir(null), "osmdroid/tiles/Mapnik");
    ITileProvider tileProvider = new OfflineTileProvider(new SimpleRegisterReceiver(this), tileDir);
    
    // 设置地图的TileProvider
    mapView.setTileProvider(tileProvider);
    
    // 将地图中心移动到用户位置，设置合适缩放级别
    GeoPoint userLocation = new GeoPoint(lat, lon);
    IMapController mapController = mapView.getController();
    mapController.setCenter(userLocation);
    mapController.setZoom(15); // 缩放级别要和你下载的瓦片级别匹配，比如10-18级
}

进阶版（多区域瓦片切换） #

如果你按不同区域存放了瓦片（比如多个城市），可以根据用户位置判断所属区域，动态切换TileProvider：

private File getTargetTileDir(double lat, double lon) {
    // 这里根据经纬度判断用户所在区域，比如判断是否在城市A的坐标范围内
    if (lat > 39.0 && lat < 40.0 && lon > 116.0 && lon < 117.0) {
        return new File(getExternalFilesDir(null), "osmdroid/tiles/Beijing");
    } else if (lat > 31.0 && lat < 32.0 && lon > 121.0 && lon < 122.0) {
        return new File(getExternalFilesDir(null), "osmdroid/tiles/Shanghai");
    }
    // 默认返回通用区域
    return new File(getExternalFilesDir(null), "osmdroid/tiles/Default");
}

private void loadMapForLocation(double lat, double lon) {
    File targetDir = getTargetTileDir(lat, lon);
    ITileProvider tileProvider = new OfflineTileProvider(new SimpleRegisterReceiver(this), targetDir);
    mapView.setTileProvider(tileProvider);
    mapView.invalidate(); // 刷新地图
    
    // 移动到用户位置
    GeoPoint userLocation = new GeoPoint(lat, lon);
    mapView.getController().setCenter(userLocation);
}

4. 关键注意事项 #

• 权限配置：在AndroidManifest.xml中添加必要权限：

  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  

• 瓦片级别匹配：设置的地图缩放级别必须在你下载的瓦片级别范围内，否则会显示空白。
• ** fallback 方案**：可以组合离线和在线瓦片源，当离线瓦片不存在时自动加载在线地图：

  ITileProvider onlineProvider = new MapnikTileProvider(new SimpleRegisterReceiver(this));
  ITileProvider offlineProvider = new OfflineTileProvider(new SimpleRegisterReceiver(this), tileDir);
  MapTileProviderArray combinedProvider = new MapTileProviderArray(onlineProvider.getTileSource(), null, new ITileProvider[]{offlineProvider, onlineProvider});
  mapView.setTileProvider(combinedProvider);
  

内容的提问来源于stack exchange，提问作者TikTak