查询entity

GET

/api/v3/entity/list

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://yingyan.baidu.com/api/v3/entity/list?service_id&ak=&sn='

响应示例

{
  {
  "status": 0,
  "message": "成功",
  "size": 2,
  "total": 2,
  "entities": [
  {
      "entity_name": "小王",
      "create_time": "2016-11-01 11:56:32",
      "modify_time": "2016-11-01 13:27:59",
      "latest_location": {
        "loc_time": 1477978078,
        "longitude": 116.3189288575,
        "latitude": 40.04780579193,
        "direction": 64,
        "height": 53,
        "radius": 4,
        "speed": 37.73
      },
      "city": "北京",
      "district": "海淀",
      "entity_desc": "小王_01"
    },
    {
      "entity_name": "小明",
      "create_time": "2017-03-15 15:56:04",
      "modify_time": "2017-06-01 14:01:31",
      "latest_location": {
        "loc_time": 1488785466,
        "longitude": 116.45644006808,
        "latitude": 39.929082990815,
        "direction": 12,
        "height": 113.76,
        "radius": 3,
        "speed": 15.23
      },
      "city": "北京",
      "district": "海淀",
      "entity_desc": "小明_01"
    }
  ]
}

请求参数

Query 参数

service_id

integer

必需

service的ID，service 的唯一标识；在轨迹管理台创建鹰眼服务时，系统返回的 service_id

filter

string

可选

过滤条件；支持根据多个条件筛选，多个条件用竖线分隔（active_time 和 inactive_time 不可同时输入）规则：filter=key1:value1|key2:value2。示例："filter=entity_names:张三,李四|active_time:1471708800|team:北京" 目前，支持的筛选字段为： 1）entity_names: entity_name列表，多个entity用逗号分隔，精确筛选。示例："entity_names:张三,李四" 2）active_time：unix时间戳，查询在此时间之后有定位信息上传的entity（loc_time>=active_time）。如查询2016-8-21 00:00:00之后仍活跃的entity，示例："active_time:1471708800" 3）inactive_time：unix时间戳，查询在此时间之后无定位信息上传的entity（loc_time<inactive_time）。如查询2016-8-21 00:00:00之后不活跃的entity示例："inactive_time:1471708800" 4）开发者自定义的可筛选的entity属性字段，示例："team:北京"

coord_type_output

string

可选

返回结果的坐标类型；默认值：bd09ll 该字段用于控制返回结果中坐标的类型。可选值为： bd09ll：百度经纬度坐标 gcj02：国测局加密坐标注：该字段在国外无效，国外均返回 wgs84坐标

page_index

string

可选

分页索引；默认值为1。page_index与page_size一起计算从第几条结果返回，代表返回第几页。

page_size

integer

可选

分页大小；默认值为100。page_size与page_index一起计算从第几条结果返回，代表返回结果中每页有几条记录。

string

必需

开发者的访问密钥，必填项。v2之前该属性为key。申请秘钥

默认值:

string

可选

可选，若开发者所用AK的校验方式为SN校验时该参数必须。

默认值:

返回响应

🟢200成功

application/json

Body

status

integer

必需

状态码；返回状态，0为成功

message

string

必需

响应信息；对status的中文描述

size

integer

必需

本页返回的结果条数；代表本页返回了多少条符合条件的entity

total

integer

必需

本次检索总结果条数；代表符合本次检索条件的结果总数

entities

array [object {6}]

必需

entity详情列表

entity_name

string

必需

entity名称，其唯一标识

entity_desc

string

必需

entity可读性描述

create_time

string

必需

entity创建时间；该时间为服务端时间

modify_time

string

必需

entity属性修改时间；该时间为服务端时间

<column-key>

string

必需

开发者自定义的entity属性信息；只有当开发者为entity创建了自定义属性字段，且赋过值，才会返回。

latest_location

object