以下内容自 iOS 定位SDK V2.3.0 后支持。
第1步，引入头文件
在调用地理围栏功能的类中引入AMapFoundationKit.h和AMapLocationKit.h这两个头文件，注意Swift需要在桥接文件中引入头文件：
#import
#import
//在桥接文件中引入头文件
#import
#import
第2步，配置Key
在调用定位时，需要添加Key，需要注意的是请在 SDK 任何类的初始化以及方法调用之前设置正确的 Key。
如果您使用的是定位SDK v2.x版本需要引入基础 SDK AMapLocationKit.framework ，设置apiKey的方式如下：
iOS 定位SDK v2.x版本设置 Key：
[AMapServices sharedServices].apiKey =@"您的key";
AMapServices.shared().apiKey = "您的key"
第3步：创建地理围栏
地理围栏没有最大个数限制，您可以无限制的创建围栏。但请您根据业务需求合理的创建围栏，控制围栏个数可以有效的保证程序执行效率。定位 SDK 提供根据高德POI、行政区划，自定义圆形、自定义多边形四种方式创建地理围栏。
1、初始化地理围栏管理manager
self.geoFenceManager = [[AMapGeoFenceManager alloc] init];
self.geoFenceManager.delegate = self;
self.geoFenceManager.activeAction = AMapGeoFenceActiveActionInside | AMapGeoFenceActiveActionOutside | AMapGeoFenceActiveActionStayed; //设置希望侦测的围栏触发行为，默认是侦测用户进入围栏的行为，即AMapGeoFenceActiveActionInside，这边设置为进入，离开，停留(在围栏内10分钟以上)，都触发回调
self.geoFenceManager.allowsBackgroundLocationUpdates = YES; //允许后台定位
self.geoFenceManager = AMapGeoFenceManager()
self.geoFenceManager.delegate = self
self.geoFenceManager.activeAction = [AMapGeoFenceActiveAction.inside , AMapGeoFenceActiveAction.outside , AMapGeoFenceActiveAction.stayed ]//进入，离开，停留都要进行通知
self.geoFenceManager.allowsBackgroundLocationUpdates = true //允许后台定位
2、创建高德POI地理围栏
提供两个创建高德POI围栏的接口，一个是根据关键字创建POI围栏，另一个是根据经纬度进行周边搜索创建POI围栏。
根据关键字创建围栏：
- (void)addKeywordPOIRegionForMonitoringWithKeyword:(NSString *)keyword POIType:(NSString *)type city:(NSString *)city size:(NSInteger)size customID:(NSString *)customID;
参数说明
参数说明示例
keywordPOI关键字北京大学
typePOI类型高等院校
cityPOI所在的城市名称北京
customID与围栏关联的自有业务ID
示例代码
[self.geoFenceManager addKeywordPOIRegionForMonitoringWithKeyword:@"北京大学" POIType:@"高等院校" city:@"北京" size:20 customID:@"poi_1"];
self.geoFenceManager.addKeywordPOIRegionForMonitoring(withKeyword: "北京大学", poiType: "高等院校", city: "北京", size: 20, customID: "poi_1")
根据周边POI创建围栏：
- (void)addAroundPOIRegionForMonitoringWithLocationPoint:(CLLocationCoordinate2D)locationPoint aroundRadius:(NSInteger)aroundRadius keyword:(NSString *)keyword POIType:(NSString *)type size:(NSInteger)size customID:(NSString *)customID;
参数说明
参数说明示例
locationPoint周边区域中心点的经纬度，以此中心点建立周边地理围栏(39.908692, 116.397477)
aroundRadius周边半径，0-50000米，默认为3000米，这个是搜索半径，不是建立的围栏的半径
keywordPOI关键字肯德基
typePOI类型050301
customID与围栏关联的自有业务ID
示例代码
CLLocationCoordinate2D coordinate = CLLocationCoordinate2DMake(39.908692, 116.397477); //天安门
[self.geoFenceManager addAroundPOIRegionForMonitoringWithLocationPoint:coordinate aroundRadius:10000 keyword:@"肯德基" POIType:@"050301" size:20 customID:@"poi_2"];
let coordinate = CLLocationCoordinate2DMake(39.908692, 116.397477) //天安门
self.geoFenceManager.addAroundPOIRegionForMonitoring(withLocationPoint: coordinate, aroundRadius: 10000, keyword: "肯德基", poiType: "050301", size: 20, customID: "poi_2")
3、创建行政区域围栏
根据行政区域关键字创建行政区域围栏：
- (void)addDistrictRegionForMonitoringWithDistrictName:(NSString *)districtName customID:(NSString *)customID;
参数说明
参数说明示例
districtName行政区域关键字海淀区
customID与围栏关联的自有业务ID
示例代码
[self.geoFenceManager addDistrictRegionForMonitoringWithDistrictName:@"海淀区" customID:@"district_1"];
self.geoFenceManager.addDistrictRegionForMonitoring(withDistrictName: "海淀区", customID: "district_1")
4、创建自定义圆形围栏
需要提供中心点和半径来创建圆形围栏，一次创建一个
- (void)addCircleRegionForMonitoringWithCenter:(CLLocationCoordinate2D)center radius:(CLLocationDistance)radius customID:(NSString *)customID;
参数说明
参数说明示例
center围栏中心点的经纬度
radius要创建的围栏的半径，半径大于0，单位米
customID与围栏关联的自有业务ID
示例代码
CLLocationCoordinate2D coordinate = CLLocationCoordinate2DMake(39.908692, 116.397477); //天安门
[self.geoFenceManager addCircleRegionForMonitoringWithCenter:coordinate radius:300 customID:@"circle_1"];
let coordinate = CLLocationCoordinate2DMake(39.908692, 116.397477) //天安门
self.geoFenceManager.addCircleRegionForMonitoring(withCenter: coordinate, radius: 300, customID: "circle_1")
5、创建自定义多边形围栏
根据经纬度坐标数据添加一个闭合的多边形围栏，点与点之间按顺序尾部相连, 第一个点与最后一个点相连，一次创建一个
- (void)addPolygonRegionForMonitoringWithCoordinates:(CLLocationCoordinate2D *)coordinates count:(NSInteger)count customID:(NSString *)customID;
参数说明
参数说明示例
coordinates经纬度坐标点数据,coordinates对应的内存会拷贝,调用者负责该内存的释放，最少3个点
countcoordinates对应的个数
customID与围栏关联的自有业务ID
示例代码
NSInteger count = 4;
CLLocationCoordinate2D *coorArr = malloc(sizeof(CLLocationCoordinate2D) * count);
coorArr[0] = CLLocationCoordinate2DMake(39.933921, 116.372927); //平安里地铁站
coorArr[1] = CLLocationCoordinate2DMake(39.907261, 116.376532); //西单地铁站
coorArr[2] = CLLocationCoordinate2DMake(39.900611, 116.418161); //崇文门地铁站
coorArr[3] = CLLocationCoordinate2DMake(39.941949, 116.435497); //东直门地铁站
[self.geoFenceManager addPolygonRegionForMonitoringWithCoordinates:coorArr count:count customID:@"polygon_1"];
free(coorArr);
coorArr = NULL;
var coordinates: [CLLocationCoordinate2D] = [
CLLocationCoordinate2D(latitude: 39.933921, longitude: 116.372927),
CLLocationCoordinate2D(latitude: 39.907261, longitude: 116.376532),
CLLocationCoordinate2D(latitude: 39.900611, longitude: 116.418161),
CLLocationCoordinate2D(latitude: 39.941949, longitude: 116.435497)]
self.geoFenceManager.addPolygonRegionForMonitoring(withCoordinates: &coordinates, count: 4, customID: "polygon_1")
第4步，开始定位
当围栏创建完毕，且围栏创建成功时会启动定位，这部分无需您来设置，SDK内部执行。 定位机制：通过“远离围栏时逐渐降低定位频率”来降低电量消耗，“离近围栏时逐渐提高定位频率”来保证有足够的定位精度从而完成围栏位置检测。
需要注意，在iOS9及之后版本的系统中，如果您希望程序在后台持续检测围栏触发行为，需要保证manager的allowsBackgroundLocationUpdates为YES，设置为YES的时候必须保证 Background Modes 中的 Location updates 处于选中状态，否则会抛出异常。
第5步，获取围栏创建后的回调和围栏状态改变时的回调
创建围栏后的信息和围栏状态改变时的信息均会通过AMapGeoFenceManagerDelegate进行回调，设置内容如下：
self.geoFenceManager.delegate = self;
self.geoFenceManager.delegate = self
1、获取围栏创建后的回调
在如下回调中知道创建的围栏是否成功，以及查看所创建围栏的具体内容。
- (void)amapGeoFenceManager:(AMapGeoFenceManager *)manager didAddRegionForMonitoringFinished:(NSArray *)regions customID:(NSString *)customID error:(NSError *)error {
if (error) {
NSLog(@"创建失败 %@",error);
} else {
NSLog(@"创建成功");
}
}
func amapGeoFenceManager(_ manager: AMapGeoFenceManager!, didAddRegionForMonitoringFinished regions: [AMapGeoFenceRegion]!, customID: String!, error: Error!) {
if let error = error {
let error = error as NSError
NSLog("创建失败 %@",error);
}
else {
NSLog("创建成功")
}
}
2、围栏状态改变时的回调
在如下回调中知道围栏的状态是否发生改变，或者定位是否失败。围栏的状态表示的就是用户和围栏的关系，有未知、进入围栏、退出围栏、在围栏内停留。回调触发的条件需同时满足：1.围栏的状态从A变成B；2.B符合您在第一步设置的需要侦测的行为的范围内。当然如果self.geoFenceManager.activeAction在监听的过程中改变了，所有符合侦测范围的围栏即使状态没有改变也会再次触发回调。
- (void)amapGeoFenceManager:(AMapGeoFenceManager *)manager didGeoFencesStatusChangedForRegion:(AMapGeoFenceRegion *)region customID:(NSString *)customID error:(NSError *)error {
if (error) {
NSLog(@"status changed error %@",error);
}else{
NSLog(@"status changed success %@",[region description]);
}
}
func amapGeoFenceManager(_ manager: AMapGeoFenceManager!, didGeoFencesStatusChangedFor region: AMapGeoFenceRegion!, customID: String!, error: Error!) {
if error == nil {
print("status changed \(region.description)")
} else {
print("status changed error \(error)")
}
}
最后，移除围栏
当不再需要使用围栏时，可以调用以下几个函数对已经设定的围栏进行移除操作。
- (void)removeTheGeoFenceRegion:(AMapGeoFenceRegion *)region; //移除指定围栏
- (void)removeGeoFenceRegionsWithCustomID:(NSString *)customID; //移除指定customID的围栏
- (void)removeAllGeoFenceRegions; //移除所有围栏
