addEntity method
- {@required AddEntityOption addEntityOption,
- 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);
}