Flutter GetX+Geolocator获取用户位置给Google Maps报错解决

问题说明 #

开发地图页面时，通过GetX框架调用Geolocator获取用户当前位置，试图将其设为Google Maps的初始相机位置，却触发类型错误：'Future<dynamic>' is not a subtype of type 'LatLng'。

错误原因 #

1. getlocation()是异步方法，直接赋值给CameraPosition.target会返回Future对象，而非Google Maps需要的LatLng类型
2. 控制器未保存获取到的位置数据，也未返回正确的位置类型
3. 页面直接调用异步方法，未处理Future的完成状态

修复步骤 #

1. 修改LocationController控制器 #

添加可观察的位置变量，完善异步方法的位置返回逻辑：

class LocationController extends GetxController {
  static LocationController instance = Get.find();
  
  // 定义可观察的位置变量，初始值设为null
  Rx<LatLng?> currentLocation = Rx<LatLng?>(null);

  @override
  void onReady() {
    super.onReady();
    getLocation();
  }

  Future<void> getLocation() async {
    bool serviceEnabled;
    LocationPermission permission;
    
    // 检查位置服务是否启用
    serviceEnabled = await Geolocator.isLocationServiceEnabled();
    if (!serviceEnabled) {
      await Geolocator.openLocationSettings();
      return Future.error("位置服务未启用");
    }

    // 检查并请求位置权限
    permission = await Geolocator.checkPermission();
    if (permission == LocationPermission.denied) {
      permission = await Geolocator.requestPermission();
      if (permission == LocationPermission.denied) {
        return Future.error("位置权限被拒绝");
      }
    }

    if (permission == LocationPermission.deniedForever) {
      return Future.error("位置权限被永久拒绝");
    }

    // 获取当前位置并转换为LatLng，更新可观察变量
    Position position = await Geolocator.getCurrentPosition(desiredAccuracy: LocationAccuracy.high);
    currentLocation.value = LatLng(position.latitude, position.longitude);
  }
}

2. 修改MapPage页面 #

使用GetX的Obx监听位置变化，设置默认位置避免初始状态错误：

class MapPage extends StatefulWidget {
  const MapPage({super.key});

  @override
  State<MapPage> createState() => _MapPageState();
}

class _MapPageState extends State<MapPage> {
  final LocationController locationController = Get.find();
  
  // 定义默认位置，获取用户位置前使用
  final LatLng defaultLocation = const LatLng(43.6970928, -79.3967414);

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: Obx(() {
        // 优先使用用户位置，无数据则用默认位置
        LatLng targetLocation = locationController.currentLocation.value ?? defaultLocation;
        
        return Stack(
          children: [
            GoogleMap(
              initialCameraPosition: CameraPosition(
                target: targetLocation, 
                zoom: 16
              ),
              minMaxZoomPreference: const MinMaxZoomPreference(15.5, 19),
              zoomGesturesEnabled: true,
              cameraTargetBounds: CameraTargetBounds(
                LatLngBounds(
                  northeast: const LatLng(43.7970928, -79.3067414),
                  southwest: const LatLng(43.592580, -79.483674),
                ),
              ),
              // 可选：位置更新时自动移动相机到新位置
              onMapCreated: (GoogleMapController controller) {
                locationController.currentLocation.listen((newLocation) {
                  if (newLocation != null) {
                    controller.animateCamera(
                      CameraUpdate.newLatLng(newLocation)
                    );
                  }
                });
              },
            ),
          ],
        );
      }),
    );
  }
}

关键修改点 #

• 控制器中新增可观察变量currentLocation，用于实时保存用户位置
• 异步方法getLocation完善位置转换逻辑，更新可观察变量
• 页面通过Obx监听位置变化，确保位置更新时地图自动刷新
• 设置默认位置，避免初始状态下因无位置数据导致的错误
• 可选添加位置监听，实现位置变化时自动移动相机

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