Android Google Maps添加自定义路线：KmlLayer加载失败求助及替代方案

嘿，我来帮你搞定这个KML图层加载失败的问题，顺便给你推荐其他实现自定义路线的方法！

先解决mapAPI为null的核心问题 #

你遇到的mapAPI为null，本质是GoogleMap实例还没完成初始化就去创建KmlLayer了。GoogleMap是异步加载的，必须在onMapReady()回调里才能拿到可用的实例，不能在Activity的onCreate()或者其他更早的时机直接调用。

正确的实现步骤： #

• 让你的Activity/Fragment实现OnMapReadyCallback接口
• 在初始化地图时，通过SupportMapFragment调用getMapAsync(this)触发地图加载
• 重写onMapReady()方法，在这里拿到GoogleMap实例，再去加载KML图层
• 别忘了处理KML加载可能抛出的IO和XML解析异常

示例代码： #

public class MapsActivity extends AppCompatActivity implements OnMapReadyCallback {
    private GoogleMap mMap;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_maps);
        
        // 获取SupportMapFragment并触发地图加载
        SupportMapFragment mapFragment = (SupportMapFragment) getSupportFragmentManager()
                .findFragmentById(R.id.map);
        mapFragment.getMapAsync(this);
    }

    @Override
    public void onMapReady(GoogleMap googleMap) {
        mMap = googleMap; // 这里才是GoogleMap实例可用的时机

        try {
            // 现在创建KmlLayer，mMap已经不是null了
            KmlLayer layer = new KmlLayer(mMap, R.raw.kml_samples, getApplicationContext());
            layer.addLayerToMap();
            
            // 可选：自动调整地图视野到KML图层范围
            LatLngBounds bounds = layer.getBoundingBox();
            mMap.moveCamera(CameraUpdateFactory.newLatLngBounds(bounds, 100));
        } catch (IOException e) {
            e.printStackTrace();
        } catch (XmlPullParserException e) {
            e.printStackTrace();
        }
    }
}

其他实现自定义路线的方法：直接用Polyline绘制 #

如果你的路线是固定的，或者可以从KML里提取出坐标点，直接用Polyline绘制会更轻量，不需要解析KML文件：

示例代码： #

@Override
public void onMapReady(GoogleMap googleMap) {
    mMap = googleMap;

    // 准备路线的坐标点（可以从KML文件里提取，或者手动定义）
    List<LatLng> routePoints = new ArrayList<>();
    routePoints.add(new LatLng(37.7749, -122.4194)); // 旧金山
    routePoints.add(new LatLng(34.0522, -118.2437)); // 洛杉矶
    // 添加更多坐标点...

    // 创建PolylineOptions，设置样式
    PolylineOptions polylineOptions = new PolylineOptions()
            .addAll(routePoints)
            .width(10) // 路线宽度
            .color(Color.RED); // 路线颜色

    // 添加到地图
    mMap.addPolyline(polylineOptions);
    
    // 调整视野到路线范围
    LatLngBounds.Builder builder = new LatLngBounds.Builder();
    for (LatLng point : routePoints) {
        builder.include(point);
    }
    LatLngBounds bounds = builder.build();
    mMap.moveCamera(CameraUpdateFactory.newLatLngBounds(bounds, 100));
}

额外注意事项： #

• 确保你的AndroidManifest.xml里配置了正确的Google Maps API密钥：

  <meta-data
      android:name="com.google.android.geo.API_KEY"
      android:value="你的API密钥"/>
  

• 确认build.gradle（Module级）里添加了Google Maps依赖：

  implementation 'com.google.android.gms:play-services-maps:18.1.0'
  

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