fences

地理围栏

注意

下面的接口介绍创建围栏示例代码以圆形服务围栏为例，多边形围栏、线型围栏可下载demo 参考

//mapopen-website-wiki.cdn.bcebos.com/demos/andDemos/yingyan/地理围栏.mp4

扫码体验

使用产品

鹰眼地理围栏

下载源码

核心接口

类

接口

描述

LBSTraceClient

createFence(CreateFenceRequest request, OnFenceListener listener)

创建围栏

CreateFenceRequest

buildServerCircleRequest(int tag, long serviceId, java.lang.String fenceName, java.lang.String monitoredPerson, LatLng center, double radius, int denoise, CoordType coordType)

创建服务端圆形围栏请求实例

重点介绍

围栏报警支持推送至鹰眼SDK，统一由OnTraceListener监听器中的onPushCallback()推送回调接口接收。开发者可在报警回调中触发自身业务，如发送短信至其他监控者、推送至开发者服务端等。

当接收报警的手机断网或网络状态不好时，会导致报警推送失败，鹰眼服务端将在后续的10分钟之内每隔15s推送一次，直至收到成功响应。若10分钟之后仍未成功，将不再推送，但报警记录将存储在鹰眼服务端。为避免因此造成报警漏接收，开发者可定期使用历史报警查询接口同步报警信息。

核心代码

注意：请求和回调是相对应关系。

1.发起检索请求

JAVA

/**
* 创建圆形服务围栏
*/
private void createFence() {
    // 请求标识
    int tag = 3;
    // 轨迹服务ID
    long serviceId = 0123443l;
    // 围栏名称
    String fenceName = "server_circle";
    // 监控对象 "#allentity" 为监控全部entity的特殊字符
    String monitoredPerson = "#allentity";
    // 围栏圆心
    com.baidu.trace.model.LatLng center = new com.baidu.trace.model.LatLng(39.9151190000, 116.4039630000);
    // 围栏半径（单位 : 米）
    double radius = 2000;
    // 去噪精度
    int denoise = 200;
    // 坐标类型
    CoordType coordType = CoordType.bd09ll;

    // 创建服务端圆形围栏请求实例
    CreateFenceRequest request = CreateFenceRequest.buildServerCircleRequest(tag, serviceId, fenceName, monitoredPerson, center, radius, denoise, coordType);
    // 创建围栏
    trackApp.mClient.createFence(request, fenceListener);

复制

深色

复制成功

2.检索结果处理

JAVA

OnFenceListener fenceListener = new OnFenceListener() {
@Override
public void onCreateFenceCallback(CreateFenceResponse response) {
    // 创建围栏回调接口
}

@Override
public void onUpdateFenceCallback(UpdateFenceResponse response) {
    // 更新围栏回调接口
}

@Override
public void onDeleteFenceCallback(DeleteFenceResponse response) {
    // 删除围栏回调处理
}

@Override
public void onFenceListCallback(FenceListResponse response) {
    // 查询围栏列表回调接口

}

@Override
public void onMonitoredStatusCallback(MonitoredStatusResponse response) {
    // 查询监控对象状态回调接口
}

@Override
public void onMonitoredStatusByLocationCallback(MonitoredStatusByLocationResponse response) {
    // 查询指定位置监控对象状态回调接口
}

@Override
public void onHistoryAlarmCallback(HistoryAlarmResponse response) {
    // 查询围栏历史报警信息回调接口
}

@Override
public void onAddMonitoredPersonCallback(AddMonitoredPersonResponse response) {
    // 添加服务端围栏需要监控的对象（轨迹entity）
}

@Override
public void onDeleteMonitoredPersonCallback(DeleteMonitoredPersonResponse response) {
    // 删除服务端围栏需要监控的对象（轨迹entity）
}

@Override
public void onListMonitoredPersonCallback(ListMonitoredPersonResponse response) {
    // 查询围栏监控的所有entity
}
};
}

复制

深色

复制成功

3.围栏报警推送

JAVA

traceListener = new OnTraceListener() {
    ......
    /**
     * 推送消息回调接口
     *
     * @param messageType 状态码
     * @param pushMessage 消息
     *                  
     *                  0x01：配置下发
     *                  0x02：语音消息
     *                  0x03：服务端围栏报警消息
     *                  0x04：本地围栏报警消息
     *                  0x05~0x40：系统预留
     *                  0x41~0xFF：开发者自定义
     */
    @Override
    public void onPushCallback(byte messageType, PushMessage pushMessage) {
        if (messageType < 0x03 || messageType > 0x04) {
            viewUtil.showToast(TracingActivity.this, pushMessage.getMessage());
            return;
        }
        FenceAlarmPushInfo alarmPushInfo = pushMessage.getFenceAlarmPushInfo();
        if (null == alarmPushInfo) {
            viewUtil.showToast(TracingActivity.this,
                    String.format("onPushCallback, messageType:%d, messageContent:%s ", messageType,
                            pushMessage));
            return;
        }
        StringBuffer alarmInfo = new StringBuffer();
        alarmInfo.append("您于")
                .append(CommonUtil.getHMS(alarmPushInfo.getCurrentPoint().getLocTime() * 1000))
                .append(alarmPushInfo.getMonitoredAction() == MonitoredAction.enter? "进入": "离开")
                .append(messageType == 0x03? "云端": "本地")
                .append("围栏：").append(alarmPushInfo.getFenceName());

        if (Build.VERSION.SDK_INT > Build.VERSION_CODES.JELLY_BEAN) {
            Notification notification = new Notification.Builder(trackApp)
                    .setContentTitle(getResources().getString(R.string.alarm_push_title))
                    .setContentText(alarmInfo.toString())
                    .setSmallIcon(R.mipmap.icon_app)
                    .setWhen(System.currentTimeMillis()).build();
            notificationManager.notify(notifyId++, notification);
        }
    }

};

复制

深色

复制成功

//mapopen-website-wiki.cdn.bcebos.com/demos/ioscodes/yingyan/地理围栏.mp4

扫码体验

使用产品

鹰眼地理围栏

下载源码

核心接口

类

接口

描述

BTKServerCircleFence

-(instancetype)initWithCenter:(CLLocationCoordinate2D)center radius:(double)radius coordType:(BTKCoordType)coordType denoiseAccuracy:(NSUInteger)denoiseAccuracy fenceName:(NSString *)fenceName monitoredObject:(NSString*)monitoredObject;

创建围栏

BTKCreateServerFenceRequest

-(instancetype)initWithServerCircleFence:(BTKServerCircleFence *)fence serviceID:(NSUInteger)serviceID tag:(NSUInteger)tag;

创建服务端圆形围栏请求实例

BTKFenceAction

-(void)createServerFenceWith:(BTKCreateServerFenceRequest *)request delegate:(id <BTKFenceDelegate>)delegate;

发起创建请求

重点介绍

当服务端围栏被触发之后，会通过长连接将报警信息推送给SDK，SDK会通过 BTKActionDelegate 协议的 -(void)onGetPushMessage:(BTKPushMessage *)message; 方法将报警信息推送给开发者。因此服务端围栏的报警推送要求网络畅通。当接收报警的手机断网或网络状态不好时，会导致报警推送失败，鹰眼服务端将在后续的10分钟之内每隔15s推送一次，直至收到成功响应。若10分钟之后仍未成功，将不再推送，但报警记录将存储在鹰眼服务端。为避免因此造成报警漏接收，开发者可定期使用历史报警查询接口同步报警信息。

核心代码

1.发起检索请求

Objective-C

BTKServerCircleFence *fence = [[BTKServerCircleFence alloc] initWithCenter:self.circleCenter radius:radius coordType:BTK_COORDTYPE_BD09LL denoiseAccuracy:denoise fenceName:fenceName monitoredObject:monitoredObject];
BTKCreateServerFenceRequest *request = [[BTKCreateServerFenceRequest alloc] initWithServerCircleFence:fence serviceID:serviceID tag:1];
[[BTKFenceAction sharedInstance] createServerFenceWith:request delegate:self];

复制

深色

复制成功

2.检索结果处理

注意：请求和回调是相对应关系。

Objective-C

#pragma mark - BTKFenceDelegate
-(void)onCreateServerFence:(NSData *)response {
    NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:response options:NSJSONReadingAllowFragments error:nil];
    if (nil == dict) {
        NSLog(@"Server Fence Create 格式转换出错");
        return;
    }
    if (0!= [dict[@"status"] intValue]) {
        NSLog(@"Server Fence Create 返回错误");
    }
}

-(void)onUpdateServerFence:(NSData *)response {
    NSDictionary *dict = [NSJSONSerialization JSONObjectWithData:response options:NSJSONReadingAllowFragments error:nil];
    if (nil == dict) {
        NSLog(@"Server Fence Update 格式转换出错");
        return;
    }
    if (0!= [dict[@"status"] intValue]) {
        NSLog(@"Server Fence Update 返回错误");
    }
}

复制

深色

复制成功

3.围栏报警推送

Objective-C

-(void)onGetPushMessage:(BTKPushMessage *)message {
    NSLog(@"收到推送消息，消息类型:%@", @(message.type));
    if (message.type == 0x03) {
        BTKPushMessageFenceAlarmContent *content = (BTKPushMessageFenceAlarmContent *)message.content;
        if (content.actionType == BTK_FENCE_MONITORED_OBJECT_ACTION_TYPE_ENTER) {
            NSLog(@"被监控对象 %@ 进入 服务端地理围栏 %@ ", content.monitoredObject, content.fenceName);
        } else if (content.actionType == BTK_FENCE_MONITORED_OBJECT_ACTION_TYPE_EXIT) {
            NSLog(@"被监控对象 %@ 离开 服务端地理围栏 %@ ", content.monitoredObject, content.fenceName);
        }
    }
}

复制

深色

复制成功

文档全面上新