addEntity method

Future<bool> addEntity (
  1. {@required AddEntityOption addEntityOption,
  2. EntityCallBack entityCallBack}
)

添加Entity 使用要点: entity标识:可以是一个人、一辆车、或任何一个可以被记录轨迹的对象。在查询任何entity的实时位置、历史轨迹之前,都必须先创建entity。

columnKey字段用于指定新创建的实体的自定义属性的值。假设有一些物流配送人员需要管理, 可以设置columnKey字段的值为"region=haidian,gender=male",即指定新创建的entity的地区属性为海淀区,性别属性为男。 需要注意的是:这里的region和gender属性必须先通过鹰眼web api的entity/addcolumn接口进行添加。 如果这两个属性是可检索的,调用queryEntityList()方法时,若columnKey字段指定为"gender=male"时,对应的entity就会被检索出来。 如果不是可检索的,只会作为queryEntityList()方法的结果,不能用来检索。

添加Entity有2种途径,一是通过调用addEntity()方法主动添加; 二是在实例化Trace时,指定entityName, 开启轨迹服务成功后(即调用startTrace()方法,回调接口状态码为:0,消息为:success), 服务端会自动创建以entityName命名的entity。 需要注意的是:服务端自动创建的entity不包含自定义属性的值,若需要指定entity自定义属性的值,需要再调用updateEntity()方法, 通过columnKey字段指定自定义属性的值。

@param addEntityOption 请求参数对象 @param listener Entity监听器,对应回调接口为: {@link OnEntityListener#onAddEntityCallback(AddEntityResponse)}

Implementation

Future<bool> addEntity(
    {@required AddEntityOption addEntityOption,
    EntityCallBack entityCallBack}) async {
  return await _entityManager.addEntity(
      addEntityOption: addEntityOption, entityCallBack: entityCallBack);
}