定位SDK支持百度POI、自定义圆形、多边形、行政区划多种方式地理围栏,您可以根据自己的业务场景需求合理创建围栏,地理围栏没有最大个数限制。 当目标进入或走出围栏时,即可使用地理围栏功能进行提醒。
多方式地理围栏功能自定位SDK V8.2.0及以后版本开始支持。
具体步骤如下:
核心代码段如下:
//实例化地理围栏客户端 GeoFenceClient mGeoFenceClient = new GeoFenceClient(getApplicationContext()); //设置希望侦测的围栏触发行为,默认只侦测用户进入围栏的行为 //public static final int GEOFENCE_IN 进入地理围栏 //public static final int GEOFENCE_OUT 退出地理围栏 //public static final int GEOFENCE_STAYED 在地理围栏内停留 //public static final int GEOFENCE_IN_OUT 进入、退出地理围栏 //public static final int GEOFENCE_IN_STAYED 进入地理围栏、在地理围栏内停留 //public static final int GEOFENCE_OUT_STAYED 退出地理围栏、在地理围栏内停留 //public static final int GEOFENCE_IN_OUT_STAYED 进入、退出、停留 mGeoFenceClient.setActivateAction(GEOFENCE_IN_OUT_STAYED); /** * setTriggerCount(int in, int out, int stay) * 设置进入围栏、离开围栏、在围栏内停留三种侦听行为的触发次数 * @param in 进入围栏的触发次数,类型为int,必须是>=0 * @param out 离开围栏的触发次数,类型为int,必须是>=0 * @param stay 在围栏内停留的触发次数,类型为int,必须是>=0 */ mGeoFenceClient.setTriggerCount(3,3,2); /** * setStayTime(int interval) * 当设置了在围栏内停留的侦听行为,可以通过这个方法设置停留时长,单位秒,默认停留时长为10分钟 * @param interval,单位秒 */ mGeoFenceClient.setStayTime(180);
1. 创建百度POI地理围栏
可以根据百度POI来创建地理围栏,百度目前提供两种方式来创建围栏,关键字地理围栏和周边POI地理围栏。
1.1根据关键字创建围栏
通过以下方法执行POI关键字搜索并创建百度POI地理围栏
mGeoFenceClient.addGeoFence(final String keyword, String poiType,final String city, int size,String customId); // keyword:POI关键字,例如百度大厦 // poiType:POI类型,例如办公楼 // city:POI所在城市,例如北京 // customID:与围栏关联的自有业务ID,例如"001KWTS83(考勤打卡)"
示例代码
mGeoFenceClient.addGeoFence("百度大厦","办公楼","北京",1," 0001");
1.2 根据周边POI创建围栏
通过以下方法执行POI周边搜索并创建百度POI地理围栏。
mGeoFenceClient.addGeoFence(final String keyword, String poiType, DPoint point, String coorType, float aroundRadius, int size, final String customId); //keyword:POI关键字,例如一点点 //poiType:POI类型,例如餐饮 //point:周边区域中心点经纬度,例如北京 //coorType:周边区域中心点坐标系类型,例如BD09LL //aroundRadius:周边半径,例如10 //size:围栏个数 //customID:业务ID
示例代码
//创建一个中心点坐标 DPoint centerPoint = new DPoint(); //设置中心点纬度 centerPoint.setLatitude(40.051D); //设置中心点经度 centerPoint.setLongitude(116.300D); //执行添加围栏的操作 //设置中心点坐标系类型 //public static final String BD09LL 百度经纬度坐标 //public static final String BD09MC 百度墨卡托米制坐标 //public static final String GCJ02 国测局坐标系 //public static final String WGS84 GPS获取的坐标 mGeoFenceClient.addGeoFence("一点点","餐饮",centerPoint,GeoFenceClient.BD09LL,1000F,10,"业务ID");
2. 创建圆形围栏
圆形围栏一次接口调用只可以创建一个围栏,创建多个自定义围栏需要多次调用创建接口。
mGeoFenceClient.addGeoFence(Point point, String coorType, float radius, String customId); //coorType:中心点坐标系类型,例如BD09LL //radius:围栏半径,例如100
示例代码
//创建一个中心点坐标 DPoint centerPoint = new DPoint(); //设置中心点纬度 centerPoint.setLatitude(40.051D); //设置中心点经度 centerPoint.setLongitude(116.300D); //设置中心点坐标系类型 //public static final String BD09LL 百度经纬度坐标 //public static final String BD09MC 百度墨卡托米制坐标 //public static final String GCJ02 国测局坐标系 //public static final String WGS84 GPS获取的坐标 mGeoFenceClient.addGeoFence (centerPoint,GeoFenceClient.BD09LL,100,"业务ID");
3. 创建多边形围栏 多边形围栏一次接口调用只可以创建一个围栏,创建多个自定义围栏需要多次调用创建接口。
mGeoFenceClient.addGeoFence(List<DPoint> points,String coorType, String customId); //points:多边形边界坐标,至少传如三个 //coorType:坐标系类型
4. 创建行政区划围栏
可根据行政区划关键字创建行政区划围栏
mGeoFenceClient.addGeoFence(String keyword, String customId);
示例代码
mGeoFenceClient.addGeoFence("海淀区","业务ID");
定位SDK 会在围栏创建成功后,自动启动定位,无需开发者进行设置。 在应用本地服务中启动 GeoFenceClient后,才能确保程序在后台也能持续监听围栏。
围栏创建完毕的信息会通过 GeoFenceListener 进行回调。可以在回调中知道创建围栏成功与否,以及查看所创建围栏的具体内容。
示例代码
//创建回调监听 GeoFenceListener fenceListenter = new GeoFenceListener() { @Override public void onGeoFenceCreateFinished(List<GeoFence> geoFenceList, int errorCode) { if(errorCode == GeoFence.ADDGEOFENCE_SUCCESS){//判断围栏是否创建成功 tvReult.setText("添加围栏成功!!"); //geoFenceList是已经添加的围栏列表,可据此查看创建的围栏 } else { tvReult.setText("添加围栏失败!!"); } } }; mGeoFenceClient.setGeoFenceListener(fenceListenter);//设置回调监听
用户进入围栏、退出围栏、在围栏内停留均为围栏触发提醒。您可以选择合适的时机进行围栏的相应提醒
1. 创建并设置PendingIntent
//定义接收的action字符串 public static final String GEOFENCE_BROADCAST_ACTION = "com.location.apis.geofencedemo.broadcast"; //创建并设置PendingIntent mGeoFenceClient.createPendingIntent(GEOFENCE_BROADCAST_ACTION);
2.创建监听
private BroadcastReceiver mGeoFenceReceiver = new BroadcastReceiver() { @Override public void onReceive(Context context, Intent intent) { if (intent.getAction().equals(GEOFENCE_BROADCAST_ACTION)) { } } };
3.注册
IntentFilter filter = new IntentFilter( ConnectivityManager.CONNECTIVITY_ACTION); filter.addAction(GEOFENCE_BROADCAST_ACTION); registerReceiver(mGeoFenceReceiver, filter);
4.解析内容
//获取Bundle Bundle bundle = intent.getExtras(); //获取围栏行为: int status = bundle.getInt(GeoFence.BUNDLE_KEY_FENCESTATUS); //获取自定义的围栏标识: String customId = bundle.getString(GeoFence.BUNDLE_KEY_CUSTOMID); //获取围栏ID: String fenceId = bundle.getString(GeoFence.BUNDLE_KEY_FENCEID); //获取当前有触发的围栏对象: GeoFence fence = bundle.getParcelable(GeoFence.BUNDLE_KEY_FENCE);
//清除所有围栏 mGeoFenceClient.removeGeoFence();