如何为Google Maps Android API的UrlTileProvider配置SSL证书？

我之前帮开发者处理过类似的需求——默认的UrlTileProvider只会信任系统预装的CA证书，要让它识别你的自定义SSL证书，核心是替换默认的SSL连接逻辑，用你自己的证书上下文来建立HTTPS请求。下面是具体的实现步骤：

1. 加载自定义SSL证书到信任库 #

首先把你的SSL证书（比如.cer格式）放到项目的assets目录下，然后写一个工具类来加载证书并生成自定义的SSLContext：

import android.content.Context;
import java.io.InputStream;
import java.security.KeyStore;
import java.security.cert.CertificateFactory;
import javax.net.ssl.SSLContext;
import javax.net.ssl.TrustManagerFactory;

public class SSLUtils {
    public static SSLContext getCustomSSLContext(Context context) throws Exception {
        // 从assets读取自定义证书
        CertificateFactory certFactory = CertificateFactory.getInstance("X.509");
        InputStream certStream = context.getAssets().open("your_custom_cert.cer");
        
        // 创建空的KeyStore并导入证书
        KeyStore keyStore = KeyStore.getInstance(KeyStore.getDefaultType());
        keyStore.load(null, null);
        keyStore.setCertificateEntry("custom_geo_cert", certFactory.generateCertificate(certStream));
        certStream.close();
        
        // 初始化信任管理器工厂
        TrustManagerFactory trustManagerFactory = TrustManagerFactory.getInstance(TrustManagerFactory.getDefaultAlgorithm());
        trustManagerFactory.init(keyStore);
        
        // 创建并初始化自定义SSLContext
        SSLContext sslContext = SSLContext.getInstance("TLS");
        sslContext.init(null, trustManagerFactory.getTrustManagers(), null);
        
        return sslContext;
    }
}

2. 自定义UrlTileProvider子类，重写Tile获取逻辑 #

默认的getTile()方法会使用系统默认的连接逻辑，我们需要重写这个方法，手动用自定义SSL上下文打开HTTPS连接：

import android.content.Context;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import com.google.android.gms.maps.model.UrlTileProvider;
import java.io.IOException;
import java.io.InputStream;
import java.net.HttpURLConnection;
import java.net.URL;
import javax.net.ssl.HttpsURLConnection;

public class CustomWmsTileProvider extends UrlTileProvider {
    private final Context mContext;
    private final String mWmsUrlTemplate;

    public CustomWmsTileProvider(int tileWidth, int tileHeight, Context context, String wmsUrlTemplate) {
        super(tileWidth, tileHeight);
        mContext = context;
        mWmsUrlTemplate = wmsUrlTemplate;
    }

    @Override
    public URL getTileUrl(int x, int y, int zoom) {
        // 按GeoServer WMS规则拼接请求URL，替换x/y/zoom参数
        String formattedUrl = String.format(mWmsUrlTemplate, x, y, zoom);
        try {
            return new URL(formattedUrl);
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        }
    }

    @Override
    public Bitmap getTile(int x, int y, int zoom) {
        URL tileUrl = getTileUrl(x, y, zoom);
        if (tileUrl == null) return null;

        HttpURLConnection connection = null;
        InputStream inputStream = null;
        try {
            // 根据协议选择连接方式，HTTPS请求使用自定义SSL上下文
            if ("https".equals(tileUrl.getProtocol())) {
                HttpsURLConnection httpsConn = (HttpsURLConnection) tileUrl.openConnection();
                httpsConn.setSSLSocketFactory(SSLUtils.getCustomSSLContext(mContext).getSocketFactory());
                connection = httpsConn;
            } else {
                connection = (HttpURLConnection) tileUrl.openConnection();
            }

            // 设置超时参数
            connection.setConnectTimeout(10000);
            connection.setReadTimeout(10000);
            
            // 读取流并转换为Bitmap
            inputStream = connection.getInputStream();
            return BitmapFactory.decodeStream(inputStream);
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        } finally {
            // 关闭流和连接，避免资源泄漏
            if (inputStream != null) {
                try {
                    inputStream.close();
                } catch (IOException e) {
                    e.printStackTrace();
                }
            }
            if (connection != null) {
                connection.disconnect();
            }
        }
    }
}

3. 集成到Google Maps中 #

在你的地图初始化代码里，创建自定义TileProvider实例并添加到地图：

// 替换成你的GeoServer WMS请求模板，调整参数适配x/y/zoom
String wmsUrlTemplate = "https://your-geoserver-domain/wms?service=WMS&version=1.1.0&request=GetMap&layers=your_target_layer&styles=&bbox=%f,%f,%f,%f&width=%d&height=%d&srs=EPSG:3857&format=image/png";

// 创建自定义TileProvider实例（瓦片尺寸通常为256x256）
CustomWmsTileProvider tileProvider = new CustomWmsTileProvider(256, 256, getContext(), wmsUrlTemplate);

// 添加到Google Maps
googleMap.addTileOverlay(new TileOverlayOptions().tileProvider(tileProvider));

关键注意事项 #

• 如果你的证书是.pfx格式（带私钥的证书），需要调整KeyStore的加载方式：改用KeyStore.getInstance("PKCS12")，并在keyStore.load()方法中传入证书密码。
• 务必处理所有异常场景，比如证书加载失败、连接超时、URL拼接错误，避免APP崩溃。
• 针对Android 9及以上版本，若使用自签证书，也可通过network_security_config.xml全局信任，但上述代码已通过SSLContext单独处理了该TileProvider的请求，此步骤可选。

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