Flutter如何通过Geofence地理围栏获取指定公里范围内的所有placeId

地理围栏本身仅用于监听用户进出指定区域的触发事件，无法直接返回区域内的POI placeId列表，你可以结合「定位权限获取 + 周边POI检索」两个步骤实现需求。

1. 前置依赖配置 #

你需要用到两类核心依赖，直接在pubspec.yaml中引入即可：

• 定位依赖：用geolocator获取用户当前精确经纬度坐标
• POI检索依赖：国内场景可选用amap_flutter_search（高德）、baidu_map_search_flutter（百度），海外场景可选用google_maps_flutter配套的Places API

同时需要提前配置对应平台的定位权限：

• Android端在AndroidManifest.xml中添加ACCESS_FINE_LOCATION、ACCESS_COARSE_LOCATION权限，targetSdk≥33时如果需要后台定位还要额外添加ACCESS_BACKGROUND_LOCATION权限
• iOS端在Info.plist中添加NSLocationWhenInUseUsageDescription、NSLocationAlwaysAndWhenInUseUsageDescription的权限说明文案

2. 核心实现步骤 #

步骤1：获取当前精确位置 #

示例代码如下：

import 'package:geolocator/geolocator.dart';

Future<Position> getCurrentPosition() async {
  bool serviceEnabled;
  LocationPermission permission;

  serviceEnabled = await Geolocator.isLocationServiceEnabled();
  if (!serviceEnabled) {
    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('定位权限永久被拒绝，请在系统设置中开启');
  }

  return await Geolocator.getCurrentPosition();
}

步骤2：按指定半径检索周边POI获取placeId #

以高德地图检索为例的示例代码：

import 'package:amap_flutter_search/amap_flutter_search.dart';

Future<List<String>> getPlaceIdInRadius(double lat, double lng, int radiusInKm) async {
  List<String> placeIds = [];
  // 初始化检索，需提前在高德开放平台申请对应端的AppKey
  AMapSearch.instance.setApiKey(
    iosKey: '你的iOS端高德AppKey', 
    androidKey: '你的Android端高德AppKey'
  );

  // 构造周边检索参数
  PoiSearchQuery query = PoiSearchQuery(
    location: LatLng(lat, lng),
    radius: radiusInKm * 1000, // 接口单位为米，转换为对应公里数值
    types: '', // 留空代表检索所有类型POI，可根据需求指定分类编码过滤
  );

  PoiSearchResult result = await AMapSearch.instance.searchPoi(query);
  if (result.pois != null && result.pois!.isNotEmpty) {
    placeIds = result.pois!.map((poi) => poi.uid ?? '').where((id) => id.isNotEmpty).toList();
  }
  return placeIds;
}

如果是海外场景使用Google Places API，调用Nearby Search接口传入当前经纬度和radius参数，返回结果中的place_id字段即为所需取值。

注意事项 #

• 所有POI检索服务都需要提前在对应平台申请开发者账号配置AppKey，部分服务有免费调用量限制，需提前确认配额
• 半径参数最大值不同平台有差异，高德、Google Places默认最大支持50000米，超出范围会被自动截断
• 单次检索返回的POI数量有限制，默认返回20条、最多支持60条，若需要全量数据需要配合分页参数多次拉取

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