基本概念

基本概念

鹰眼轨迹产品中涉及到以下名词概念:

service

概念:一个service(即鹰眼轨迹工程)对应一个轨迹管理系统,一个service里可管理多条轨迹,每个service由唯一标识符service_id区分。例如,针对某出租车公司的轨迹管理系统,可以创建一个service,在其中管理所有出租车的轨迹。

配额:一个开发者最多可创建10个service。

使用:开发者可在轨迹管理台管理service,包括service的创建、编辑和查看。


entity

概念:一个entity代表现实中一个被追踪轨迹的事物,它可以是一个人、一辆车或者任何运动物体。entity以entity_name作为唯一标识。

配额:一个service管理至多100万个entity

使用:鹰眼Web API提供了entity的增、删、改、查接口。

注意:MTK 2502 SDK中的track_name对应鹰眼轨迹接口中的entity_name。


entity column

概念:entity的自定义属性字段,由开发者管理,用以描述entity,如:对于车辆可以是车牌号、司机姓名字段等。

配额:开发者可以自定义最多5个属性字段,其中可设置2个属性作为检索字段。

使用:鹰眼Web API提供了entity column的增、删、查接口,但不提供字段修改接口。


track

概念:一个track由一系列位置点(point)组成,它是一个entity的运动轨迹。

配额:轨迹点数量无限制。

使用:鹰眼Web API提供了添加轨迹点、批量添加轨迹点、查询历史轨迹接口。使用鹰眼Android SDK时,SDK会根据开发者设定的频率定位,回传轨迹点。


track column

概念:track中的每个位置点的自定义属性字段,由开发者管理。track中的每个位置点拥有一系列描述字段,如:汽车的油量、发动机转速等,用以记录行程中的实时状态信息。

配额:开发者可以自定义10个字段。

使用:鹰眼Web API提供了track自定义字段的增、删、查接口,但不提供字段修改接口。使用鹰眼Android SDK时,开发者须重写OnTrackListener监听器中的onTrackAttrCallback()接口,在回传轨迹点时回传属性数据。


fence

概念:fence即地理围栏,是指一定范围(圆形、多边形)的虚拟地理区域。当entity进入、离开该区域时,用户可以接收到自动报警通知。

配额:一个entity最多可创建10个地理围栏。

使用:鹰眼Web API和Android SDK提供了fence的增删改查接口,以及查询某围栏内被监控者状态、历史报警信息。entity可以为自己创建围栏,也可将观察者设为自己。


conf

概念:设置entity的配置信息(仅在使用MTK2502芯片时调用该接口)。