Flutter MapMyIndia插件在低版本Android中无法加载地图求助

1. 核对AndroidManifest.xml权限与配置 #

低版本Android（API < 30）需要补充必要的权限声明，同时确认MapMyIndia API密钥配置正确：

<!-- 必须的网络权限 -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

<!-- 位置权限 -->
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<!-- API < 30 需额外添加 -->
<uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />

<!-- MapMyIndia API密钥配置 -->
<meta-data
    android:name="com.mapmyindia.sdk.api_key"
    android:value="你的API_KEY"/>

2. 提前完成权限请求 #

低版本Android权限校验逻辑和Android 12有差异，务必在地图初始化前完成位置权限请求并确认授予状态，可借助permission_handler插件实现：

import 'package:permission_handler/permission_handler.dart';

Future<bool> requestLocationPerm() async {
  final status = await Permission.location.request();
  return status.isGranted;
}

// 在页面初始化时调用
@override
void initState() {
  super.initState();
  requestLocationPerm().then((granted) {
    if (granted) {
      // 权限通过后再初始化地图相关逻辑
    }
  });
}

3. 调整Gradle兼容配置 #

检查android/app/build.gradle中的最低SDK版本，确保不低于mapmyindia_gl要求的版本，同时统一Google Play服务依赖版本避免冲突：

android {
    defaultConfig {
        minSdkVersion 21 // 建议不低于21，适配多数低版本设备
        // 其他配置...
    }
}

dependencies {
    // 统一Google Play服务位置模块版本
    implementation 'com.google.android.gms:play-services-location:21.0.1'
}

4. 排查错误日志 #

在onMapError回调中详细打印错误信息，定位具体问题（比如密钥无效、网络请求失败等）：

onMapError: (code, message) {
    print("地图错误码: $code, 错误信息: $message");
},

同时检查Android端日志，确认是否有API密钥验证失败、资源加载失败等提示。

5. 正确初始化地图控制器 #

不要注释onMapCreated中的控制器赋值逻辑，持有控制器实例能保证地图正常渲染：

MapmyIndiaMapController? _mapController;

// ...

onMapCreated: (map) {
    _mapController = map;
    // 手动触发地图定位，确保视图加载
    _mapController?.moveCamera(CameraUpdate.newLatLng(const LatLng(12.972442, 77.580643)));
},

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