如何将Flutter中获取地理位置的函数封装为全局可访问类

把地理位置相关逻辑封装成独立类，核心是解耦UI与业务逻辑，让服务类不依赖BuildContext，将权限状态、位置信息、错误提示通过返回值传递给调用方，实现全局复用。

1. 封装独立的地理位置服务类 #

创建location_service.dart，实现权限校验、位置获取、地址解析的核心逻辑：

import 'package:geocoding/geocoding.dart';
import 'package:geolocator/geolocator.dart';

class LocationService {
  // 处理位置权限，返回权限状态及错误信息
  Future<({bool hasPermission, String? errorMessage})> handleLocationPermission() async {
    bool serviceEnabled;
    LocationPermission permission;

    serviceEnabled = await Geolocator.isLocationServiceEnabled();
    if (!serviceEnabled) {
      return (
        hasPermission: false,
        errorMessage: '位置服务已禁用，请启用该服务'
      );
    }

    permission = await Geolocator.checkPermission();
    if (permission == LocationPermission.denied) {
      permission = await Geolocator.requestPermission();
      if (permission == LocationPermission.denied) {
        return (
          hasPermission: false,
          errorMessage: '位置权限已被拒绝'
        );
      }
    }

    if (permission == LocationPermission.deniedForever) {
      return (
        hasPermission: false,
        errorMessage: '位置权限被永久拒绝，无法再次请求'
      );
    }

    return (hasPermission: true, errorMessage: null);
  }

  // 获取当前位置坐标
  Future<Position?> getCurrentPosition() async {
    final permissionResult = await handleLocationPermission();
    if (!permissionResult.hasPermission) return null;

    try {
      return await Geolocator.getCurrentPosition(desiredAccuracy: LocationAccuracy.high);
    } catch (e) {
      debugPrint('获取位置失败: $e');
      return null;
    }
  }

  // 通过坐标解析地址
  Future<String?> getAddressFromLatLng(Position position) async {
    try {
      final placemarks = await placemarkFromCoordinates(position.latitude, position.longitude);
      if (placemarks.isEmpty) return null;

      final place = placemarks[0];
      return '${place.street ?? ''}, ${place.subLocality ?? ''}, ${place.subAdministrativeArea ?? ''}, ${place.postalCode ?? ''}'
          .replaceAll(RegExp(r',\s*,'), ',') // 处理空字段导致的多余逗号
          .trim();
    } catch (e) {
      debugPrint('解析地址失败: $e');
      return null;
    }
  }
}

2. 在页面中调用封装的服务类 #

修改原LocationPage，去掉内部逻辑，直接调用LocationService：

import 'package:flutter/material.dart';
import 'package:geolocator/geolocator.dart';
import 'location_service.dart';

class LocationPage extends StatefulWidget {
  const LocationPage({Key? key}) : super(key: key);

  @override
  State<LocationPage> createState() => _LocationPageState();
}

class _LocationPageState extends State<LocationPage> {
  final LocationService _locationService = LocationService();
  String? _currentAddress;
  Position? _currentPosition;

  Future<void> _fetchLocation() async {
    // 先校验权限
    final permissionResult = await _locationService.handleLocationPermission();
    if (!permissionResult.hasPermission) {
      if (permissionResult.errorMessage != null) {
        ScaffoldMessenger.of(context).showSnackBar(
          SnackBar(content: Text(permissionResult.errorMessage!)),
        );
      }
      return;
    }

    // 获取位置
    final position = await _locationService.getCurrentPosition();
    if (position == null) return;

    setState(() => _currentPosition = position);

    // 解析地址
    final address = await _locationService.getAddressFromLatLng(position);
    setState(() => _currentAddress = address);
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text("位置页面")),
      body: SafeArea(
        child: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: [
              Text('纬度: ${_currentPosition?.latitude ?? ""}'),
              Text('经度: ${_currentPosition?.longitude ?? ""}'),
              Text('地址: ${_currentAddress ?? ""}'),
              const SizedBox(height: 32),
              ElevatedButton(
                onPressed: _fetchLocation,
                child: const Text("获取当前位置"),
              )
            ],
          ),
        ),
      ),
    );
  }
}

3. 关键优化点 #

• 解耦UI与逻辑：服务类不依赖BuildContext，错误提示由调用页面处理，适配不同场景的UI需求
• 返回值结构化：用Dart 3.0的记录类型返回权限状态和错误信息，语义更清晰
• 异常统一处理：服务类内部捕获异常并打印日志，避免崩溃
• 地址格式化优化：处理空字段导致的多余逗号，提升显示整洁度

4. 注意事项 #

• 确保已在pubspec.yaml中添加依赖：

  dependencies:
    geolocator: ^11.0.0
    geocoding: ^3.0.0
  

• 根据平台配置权限：
  • Android：在AndroidManifest.xml中添加ACCESS_FINE_LOCATION、ACCESS_COARSE_LOCATION权限
  • iOS：在Info.plist中添加NSLocationWhenInUseUsageDescription、NSLocationAlwaysAndWhenInUseUsageDescription描述

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