浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。

鹰眼轨迹服务

百度鹰眼是一套轨迹追踪开放服务,开发者在终端集成鹰眼API/SDK 后,可同时管理并追踪数千万终端设备的轨迹,适用于车队管理、共享出行、外勤人员管理、智能穿戴等领域。

简介

entity 类接口主要用于 entity 的增删改查、以及 entity 自定义字段的管理

坐标系的说明

目前中国主要有以下三种坐标系:


WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系。


GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系。


BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标


注:非中国地区地图,统一使用WGS84坐标


鹰眼 Web服务API v2.0的输入参数支持以上三种坐标系,可通过"coord_type"标明输入坐标类型。输出坐标仅支持百度经纬度坐标(bd09ll)。

add——添加entity

接口说明

添加一个新的entity,一个entity可以是一个人、一辆车、或者任何运动的物体。

请求URI

http://api.map.baidu.com/trace/v2/entity/add

HTTP请求方式

POST

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必选
service_id service的ID,作为其唯一标识 Int 必选
entity_name entity名称,作为其唯一标识。 string(128) 必选。仅支持中文、英文大小字母、英文下划线"_"、英文横线"-"和数字。同一service服务中entity_name不可重复。
<column-key> 开发者自定义字段 string(128) 可选

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述

请求示例

entityadd.png

返回格式

JSON

响应实例
{
   "status": 0,
   "message": "成功"

}

delete——删除entity

接口说明

根据entity_name删除一个entity。

请求URI

http://api.map.baidu.com/trace/v2/entity/delete

HTTP请求方式

POST

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必选
service_id service的ID,作为其唯一标识 Int 必选
entity_name entity名称,作为其唯一标识。 string(128) 必选。同一service服务中entity_name不可重复。

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述

请求示例

entitydeletepng.png

返回格式

JSON

响应实例
{
   "status": 0,
   "message": "成功"

}

update——更新entity信息

接口说明

更新entity信息。

请求URI

http://api.map.baidu.com/trace/v2/entity/update

HTTP请求方式

POST

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必选
service_id service的ID,作为其唯一标识 Int 必选
entity_name entity名称,作为其唯一标识。 string(128) 必选。仅支持中文、英文大小字母、英文下划线"_"、英文横线"-"和数字。同一service服务中entity_name不可重复。同一service服务中entity_name不可重复。
<column-key> 开发者自定义字段 string(128) 可选

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述

请求示例

entityupdate.png

返回格式

JSON

响应实例
{
   "status": 0,
   "message": "成功"

}

list——查询entity

接口说明

根据service_id、entity_name和自定义检索字段,查询本service中所有符合条件的entity信息及其实时位置。

请求URI

http://api.map.baidu.com/trace/v2/entity/list

HTTP请求方式

GET

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必选
service_id 该track所属的service服务的唯一标识 Int 必选
entity_names 要检索的entity_name集合。 string 可选,支持输入多个entity_name,以英文 ’,’ 逗号分开,如: car01,car02,car03
<column-key> 开发者自定义的entity可检索的属性字段 string(128) 可选
active_time 活跃时间 UNIX时间戳 可选,指定该字段时,返回从该时间点之后仍有位置变动的entity。
return_type 返回结果的类型 int 可选。0代表返回全部结果,1代表只返回entity_name字段。默认值为0。
page_index 分页索引 int(1到2^32-1) 可选,默认值为1。page_index与page_size一起计算从第几条结果返回,代表返回第几页。
page_size 分页大小 int(1-1000) 可选,默认值为100。page_size与page_index一起计算从第几条结果返回,代表返回结果中每页有几条记录。

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
total 本次检索总结果条数 int 代表符合本次检索条件的结果总数
size 本页返回的结果条数 int 代表本页返回了多少条符合条件的entity
entities entity详细信息列表
realtime_point 实时轨迹信息
location 经纬度 Array 百度加密坐标
loc_time 该entity最新定位时间 UNIX时间戳 该entity最新定位时间(定位时设备的时间)
direction 方向 int 范围为[0,359],0度为正北方向,顺时针
speed 速度 double 单位:km/h
radius 定位精度 double 单位:m
<column-key> 开发者自定义track的属性 UNIX时间戳 只有当开发者为track创建了自定义属性字段,且赋过值,才会返回。
entity_name entity名称,其唯一标识 string
modify_time entity属性修改时间 格式化时间 该时间为服务端时间
create_time entity创建时间 格式化时间 该时间为服务端时间
<column-key> 开发者自定义的entity属性信息 string 只有当开发者为entity创建了自定义属性字段,且赋过值,才会返回。

请求示例

entitylist.png

返回格式

JSON

响应实例
{
   "status": 0,  
   “size”: 2,
   “total”: 2,
   “entities”: [
       {    
          "realtimepoint":[
               {
                  “loc_time”: “1442824667”,
                  “location”: [116.1556024,40.0820658]
                  "direction": 240,
                  "speed": 0.9,
                  "radius": 65
                }
                ]
           “entity_name”: “jiejingC_A932578”,
           “modify_time”: “2014-09-29 18:42:26”,
           “create_time”: “2014-09-29 18:42:26”
       },
       {
           "realtimepoint":[
                 {
                  “loc_time”: “1409309247”,
                  “location”: [116.3579834,40.0280849]
                  "direction": 185,
                  "speed": 2.9,
                  "radius": 21
                 }
             ]
           “entity_name”: “test116”,
           “modify_time”: “2014-09-30 13:36:39”,
           “create_time”: “2014-09-30 13:36:39”         
       }
     ]

“message”: “成功”

}

addcolumn——添加entity属性字段

接口说明

为entity添加一个属性字段,字段只能为字符类型,支持最大长度为128。

请求URI

http://api.map.baidu.com/trace/v2/entity/addcolumn

HTTP请求方式

POST

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必选
service_id 该track所属的service服务的唯一标识 Int 必选
column_key 字段名称 string(45) 必选。
命名规则:仅允许英文大小字母、英文下划线"_"、英文横线"-"和数字,不允许使用下划线"_"开头。
最多创建5个属性字段,同一个service下entity的column_key不能重复,且不能与以下系统字段重名:entity_desc,entity_name,entity_names
column_desc 字段描述 string(0-128) 可选
is_search 是否为检索字段 int(0-1) 可选。1代表检索字段,0代表非检索字段。最多设置2个检索字段,且字段一经创建,此属性将不可更改。

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述

请求示例

entityaddcolumn.png

返回格式

JSON

响应实例
{
   "status": 0,
   "message": "成功"

}

deletecolumn——删除entity属性字段

接口说明

删除entity某个属性字段。

请求URI

http://api.map.baidu.com/trace/v2/entity/deletecolumn

HTTP请求方式

POST

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必选
service_id 该track所属的service服务的唯一标识 Int 必选
column_key 字段名称 string(45) 必选,最多创建5个属性字段,同一个service下entity的column_key不能重复。

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述

请求示例

entitydeletecolumn.png

返回格式

JSON

响应实例
{

"status": 0,

"message": "成功"

}

listcolumn——列出entity属性字段

接口说明

列出entity所有自定义属性字段。

请求URI

http://api.map.baidu.com/trace/v2/entity/listcolumn

HTTP请求方式

GET

请求参数

参数名 参数含义 类型 备注
ak 用户的ak,授权使用 string 必选
service_id 该track所属的service服务的唯一标识 Int 必选

返回值

参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
columns 字段列表 array dict
column_key 字段名称 string
column_desc 字段描述 string
create_time 字段创建时间 格式化日期
modify_time 字段更新时间 格式化日期
is_search 是否为检索字段 int

请求示例

entitylistcolumn.png

返回格式

JSON

响应示例
{
   "status": 0,
    "columns": [
           {
               "column_key": "stuff_team",
               "column_desc": "人员编队",
               "create_time": "2015-05-18 09:02:25",
               "create_time": "2015-05-18 09:02:25",
               "is_search": 1
               
           },
           {
               "column_key": "description",
               "column_desc": "描述",
                "create_time": "2015-05-18 09:34:42",
               "create_time": "2015-05-18 09:34:42",
               "is_search": 0
           }
       ]
   "message": "成功"

}