Android Maps API使用GroundOverlay：如何规避超大BMP文件问题？

嘿，我来帮你搞定这个头疼的问题——那个错误提示真的很误导人，GroundOverlay完全不需要你把图片转成BMP格式！

问题根源 #

你看到的Failed to decode image. The provided image must be a Bitmap很容易让人误以为必须用BMP格式，但实际上BitmapDescriptorFactory是支持PNG、JPG等常见图片格式的。你遇到的解码失败，本质是直接用fromAsset()加载15MB的大PNG时，默认的解码逻辑没有做内存优化，导致内存不足或者解码异常，和图片格式本身无关。

解决方案：优化PNG加载逻辑，保留压缩体积 #

我们可以手动从Asset中读取PNG文件，通过BitmapFactory.Options设置内存优化参数，把它解码成Bitmap后再传给GroundOverlay。这样既能保留PNG的小体积优势，又能解决解码失败的问题。

具体优化点 #

• 内存配置调整：如果你的overlay图片不需要透明通道，把inPreferredConfig设为RGB_565，能比默认的ARGB_8888节省一半内存；如果需要透明，就保留ARGB_8888。
• 采样率压缩：通过inSampleSize设置图片的缩放比例，比如设为2，图片的宽高会缩小为原来的1/2，内存占用直接降到原来的1/4（你可以根据实际画质需求调整这个数值）。

代码实现 #

@Override
public void onMapReady(GoogleMap googleMap) {
    mMap = googleMap;
    // 定义Overlay的边界坐标
    LatLngBounds imageMapBounds = new LatLngBounds(
            new LatLng(46.709064, 2.888008),
            new LatLng(46.729014, 2.918522)
    );

    BitmapDescriptor overlayBitmap = null;
    try {
        // 从Asset中获取PNG文件的输入流
        AssetManager assetManager = getAssets();
        InputStream imgStream = assetManager.open("map.png");

        // 配置Bitmap解码参数，优化内存占用
        BitmapFactory.Options decodeOptions = new BitmapFactory.Options();
        // 若不需要透明通道，用RGB_565减少内存消耗
        decodeOptions.inPreferredConfig = Bitmap.Config.RGB_565;
        // 设置采样率，根据你的图片尺寸和需求调整，示例为宽高减半
        decodeOptions.inSampleSize = 2;

        // 解码Bitmap
        Bitmap bitmap = BitmapFactory.decodeStream(imgStream, null, decodeOptions);
        overlayBitmap = BitmapDescriptorFactory.fromBitmap(bitmap);

        imgStream.close();
    } catch (IOException e) {
        e.printStackTrace();
        Log.e("MapOverlay", "加载Overlay图片失败: " + e.getMessage());
    }

    if (overlayBitmap != null) {
        // 创建并添加GroundOverlay到地图
        GroundOverlayOptions overlayOptions = new GroundOverlayOptions()
                .image(overlayBitmap)
                .positionFromBounds(imageMapBounds);
        mMap.addGroundOverlay(overlayOptions);
    }
}

额外小贴士 #

• 如果你不确定采样率设多少合适，可以先获取图片的原始尺寸，再根据地图上的显示区域动态计算最优的采样率，平衡画质和内存占用。
• 把图片放在drawable-nodpi目录下，避免系统自动缩放图片导致额外的内存开销。

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