浏览器版本低!无法浏览完整内容,建议升级或更换浏览器。
第1行: 第1行:
 
{{yingyan-sidebar}}<div class="bluetitle"><div class="services-title-text service-page-anchor">简介</div></div><div class="serve-explain-text">
 
{{yingyan-sidebar}}<div class="bluetitle"><div class="services-title-text service-page-anchor">简介</div></div><div class="serve-explain-text">
 
地理围栏报警类接口主要提供
 
地理围栏报警类接口主要提供
 
+
 
 
1. 查询监控对象在围栏内/外:查询被监控对象在指定围栏内或外,也支持查询被监控对象目前相对于所有围栏的状态
 
1. 查询监控对象在围栏内/外:查询被监控对象在指定围栏内或外,也支持查询被监控对象目前相对于所有围栏的状态
 
+
 
 
2. 查询围栏报警信息:支持查询某时间段内单个围栏或该 service 下所有围栏的报警信息
 
2. 查询围栏报警信息:支持查询某时间段内单个围栏或该 service 下所有围栏的报警信息
 
3. 服务端报警信息推送:鹰眼将报警信息实时推送至开发者的服务端</div><div class="bluetitle"><div class="services-title-text service-page-anchor">接口列表</div></div>
 
3. 服务端报警信息推送:鹰眼将报警信息实时推送至开发者的服务端</div><div class="bluetitle"><div class="services-title-text service-page-anchor">接口列表</div></div>
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" | 模块
+
! width="100" | 模块
  ! width="200" | 接口名称
+
! width="200" | 接口名称
  ! width="300" | 功能说明
+
! width="300" | 功能说明
  |-
+
|-
  | rowspan="5" colspan="1" | fence<br/>
+
| rowspan="5" colspan="1" | fence<br/>
  | querystatus
+
| querystatus
  | 查询监控对象在围栏内或外
+
| 查询监控对象在围栏内或外
  |-
+
|-
  | querystatusbylocation
+
| querystatusbylocation
  | 查询坐标在围栏内或外
+
| 查询坐标在围栏内或外
  |-
+
|-
  | historyalarm
+
| historyalarm
  | 查询某监控对象的历史报警信息
+
| 查询某监控对象的历史报警信息
  |-
+
|-
  | batchhistoryalarm
+
| batchhistoryalarm
  | 批量查询某 service 下时间段以内的所有报警信息,用于服务端报警同步
+
| 批量查询某 service 下时间段以内的所有报警信息,用于服务端报警同步
  |-
+
|-
  | 服务端报警推送<br/>
+
| 服务端报警推送<br/>
  | 向开发者服务端推送围栏报警信息
+
| 向开发者服务端推送围栏报警信息
  |}
+
|}
  <div class="bluetitle"><div class="services-title-text service-page-anchor">坐标系说明</div></div><div class="serve-explain-text">
+
<div class="bluetitle"><div class="services-title-text service-page-anchor">坐标系说明</div></div><div class="serve-explain-text">
 
目前中国主要有以下三种坐标系:
 
目前中国主要有以下三种坐标系:
 
+
 
 
WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系
 
WGS84:为一种大地坐标系,也是目前广泛使用的GPS全球卫星定位系统使用的坐标系
 
+
 
 
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系
 
GCJ02:是由中国国家测绘局制订的地理信息系统的坐标系统。由WGS84坐标系经加密后的坐标系
 
+
 
 
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
 
BD09:为百度坐标系,在GCJ02坐标系基础上再次加密。其中bd09ll表示百度经纬度坐标,bd09mc表示百度墨卡托米制坐标
 
+
 
 
非中国地区地图,统一使用WGS84坐标
 
非中国地区地图,统一使用WGS84坐标
 
+
 
 
+
 
  鹰眼 Web服务API V3.0的默认输入输出参数为百度坐标(BD09),同时可通过"coord_type","coord_type_input","coord_type_output"(以各服务参数介绍为准)控制输入输出的坐标类型,鹰眼将自动完成转换。</div><div class="bluetitle"><div class="services-title-text service-page-anchor">围栏报警接口使用小贴士</div></div><div class="serve-explain-text">
+
鹰眼 Web服务API V3.0的默认输入输出参数为百度坐标(BD09),同时可通过"coord_type","coord_type_input","coord_type_output"(以各服务参数介绍为准)控制输入输出的坐标类型,鹰眼将自动完成转换。</div><div class="bluetitle"><div class="services-title-text service-page-anchor">围栏报警接口使用小贴士</div></div><div class="serve-explain-text">
 
1. 为保证轨迹点的顺序性,使用查询围栏报警信息(querystatus)接口时,轨迹点上传成功后,服务端会有15秒左右报警延迟。
 
1. 为保证轨迹点的顺序性,使用查询围栏报警信息(querystatus)接口时,轨迹点上传成功后,服务端会有15秒左右报警延迟。
 
+
 
 
2. 围栏报警是通过计算监控对象的轨迹来进行状态判断。为提高报警准确性,服务端将针对轨迹做去噪纠偏。
 
2. 围栏报警是通过计算监控对象的轨迹来进行状态判断。为提高报警准确性,服务端将针对轨迹做去噪纠偏。
3. 若监控对象的轨迹点异常,围栏报警计算时将会过滤该点,建议使用实际路测数据测试地理围栏报警服务功能。<br/><br/>在使用围栏时,发现轨迹点未触发围栏报警,开发者可从以下几方面排查原因:<br/>1. 轨迹点的定位时间是否早于围栏创建时间,若如此,此点将不参与围栏计算;<br/>2. 轨迹点被认为是噪点被去除,从而不参与围栏计算。噪点的判定方法,一方面是轨迹点定位误差是否超过了开发者创建围栏时设置的去噪阈值(denoise),一方面是鹰眼内部的去噪策略,开发者可通过轨迹管理台对比原始轨迹和去噪后轨迹来辨别噪点;<br/>3. 轨迹点不是真实轨迹,而是开发者构造的虚拟轨迹,围栏在计算时也将忽略这部分轨迹;<br/>4. 轨迹点上传顺序错乱问题,若定位时间较新的轨迹点已上传并参与围栏计算了,那么此时再上传定位时间较旧的轨迹点,则旧轨迹点不再参与围栏计算。<br/></div><div class="bluetitle"><div class="services-title-text">接口说明</div></div><div class="separate-title service-page-anchor">querystatus——查询监控对象相对围栏的状态</div><div class="serve-explain-text">查询被监控对象在指定围栏内或外,也支持查询被监控对象目前相对于所有围栏的状态</div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">http://yingyan.baidu.com/api/v3/fence/querystatus //GET请求
+
3. 若监控对象的轨迹点异常,围栏报警计算时将会过滤该点,建议使用实际路测数据测试地理围栏报警服务功能。<br/><br/>在使用围栏时,发现轨迹点未触发围栏报警,开发者可从以下几方面排查原因:<br/>1. 轨迹点的定位时间是否早于围栏创建时间,若如此,此点将不参与围栏计算;<br/>2. 轨迹点被认为是噪点被去除,从而不参与围栏计算。噪点的判定方法,一方面是轨迹点定位误差是否超过了开发者创建围栏时设置的去噪阈值(denoise),一方面是鹰眼内部的去噪策略,开发者可通过轨迹管理台对比原始轨迹和去噪后轨迹来辨别噪点;<br/>3. 轨迹点不是真实轨迹,而是开发者构造的虚拟轨迹,围栏在计算时也将忽略这部分轨迹;<br/>4. 轨迹点上传顺序错乱问题,若定位时间较新的轨迹点已上传并参与围栏计算了,那么此时再上传定位时间较旧的轨迹点,则旧轨迹点不再参与围栏计算。<br/></div><div class="bluetitle"><div class="services-title-text">接口说明</div></div><div class="separate-title service-page-anchor">querystatus——查询监控对象相对围栏的状态</div><div class="serve-explain-text">查询被监控对象在指定围栏内或外,也支持查询被监控对象目前相对于所有围栏的状态</div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/fence/querystatus //GET请求
 
</pre>
 
</pre>
  </div></div><div class="separate-title">请求参数</div>
+
</div></div><div class="separate-title">请求参数</div>
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" | 参数名
+
! width="100" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="80" | 是否必填
+
! width="80" | 是否必填
  ! width="250" | 备注
+
! width="250" | 备注
  |-
+
|-
  | ak
+
| ak
  | 用户的'''AK'''
+
| 用户的'''AK'''
  | string
+
| string
  | 是
+
| 是
  |  
+
|  
  |-
+
|-
  | service_id
+
| service_id
  | service的ID,service 的唯一标识。
+
| service的ID,service 的唯一标识。
  | int
+
| int
  | 是
+
| 是
  | service 的唯一标识。在轨迹管理台创建鹰眼服务时,系统返回的 service_id
+
| service 的唯一标识。在轨迹管理台创建鹰眼服务时,系统返回的 service_id
 
+
 
 
+
 
  |-
+
|-
  | monitored_person
+
| monitored_person
  | 监控对象的 entity_name
+
| 监控对象的 entity_name
  | string(128)
+
| string(128)
  | 是
+
| 是
  |  
+
|  
 
+
 
 
+
 
  |-
+
|-
  | fence_ids
+
| fence_ids
  | 围栏实体的id列表
+
| 围栏实体的id列表
  | “int,int…”
+
| “int,int…”
  | 否
+
| 否
  | 若填写,则按照指定的id全部返回围栏状态,此时page_index和page_size不生效。<br/>若不填,则查询监控对象上的所有围栏状态。<br/>fence_ids中最多填写1000个id。
+
| 若填写,则按照指定的id全部返回围栏状态,此时page_index和page_size不生效。<br/>若不填,则查询监控对象上的所有围栏状态。<br/>fence_ids中最多填写1000个id。
  |-
+
|-
  | page_index<br/>
+
| page_index<br/>
  | 分页索引<br/>
+
| 分页索引<br/>
  | int(1到2^21-1)<br/>
+
| int(1到2^21-1)<br/>
  | 否
+
| 否
  | 默认值:1<br/>与page_size一起计算从第几条结果返回,代表返回第几页<br/>
+
| 默认值:1<br/>与page_size一起计算从第几条结果返回,代表返回第几页<br/>
  |-
+
|-
  | page_size<br/>
+
| page_size<br/>
  | 每页返回数据量<br/>
+
| 每页返回数据量<br/>
  | int(1-5000)<br/>
+
| int(1-5000)<br/>
  | 否
+
| 否
  | 默认值:1000<br/>返回结果最大个数与page_index一起计算从第几条结果返回,代表返回结果中每页有几个轨迹点<br/>
+
| 默认值:1000<br/>返回结果最大个数与page_index一起计算从第几条结果返回,代表返回结果中每页有几个轨迹点<br/>
  |-
+
|-
  | sn
+
| sn
  | 用户的权限签名,'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
+
| 用户的权限签名,'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
  | string
+
| string
  | 否
+
| 否
  |  
+
|  
  |}
+
|}
  <div class="separate-title">返回参数</div>
+
<div class="separate-title">返回参数</div>
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" colspan="2" | 参数名
+
! width="100" colspan="2" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="500" | 备注
+
! width="500" | 备注
  |-
+
|-
  | colspan="2" | status
+
| colspan="2" | status
  | 状态码
+
| 状态码
  | int
+
| int
  | 返回状态,0为成功
+
| 返回状态,0为成功
  |-
+
|-
  | colspan="2" | message
+
| colspan="2" | message
  | 响应信息
+
| 响应信息
  | string
+
| string
  | 对status的中文描述
+
| 对status的中文描述
  |-
+
|-
  | colspan="2" | total
+
| colspan="2" | total
  | 总的查询结果数量
+
| 总的查询结果数量
  | int
+
| int
  | <br/>
+
| <br/>
  |-
+
|-
  | colspan="2" | size
+
| colspan="2" | size
  | 本页返回的结果数量
+
| 本页返回的结果数量
  | int
+
| int
  |  
+
|  
  |-
+
|-
  | colspan="2" | monitored_statuses
+
| colspan="2" | monitored_statuses
  | 报警的数量
+
| 报警的数量
  | array
+
| array
  |  
+
|  
  |-
+
|-
  | rowspan="2" |  
+
| rowspan="2" |  
  | fence_id
+
| fence_id
  | 围栏 id
+
| 围栏 id
  | int
+
| int
  |  
+
|  
  |-
+
|-
  | monitored_status
+
| monitored_status
  | 状态
+
| 状态
  | string
+
| string
  | unknown:未知状态
+
| unknown:未知状态
 
in:在围栏内
 
in:在围栏内
 
+
 
 
out:在围栏外
 
out:在围栏外
 
+
 
  |}
+
|}
  <div class="serve-explain-text"><div class="serveintoor-title">请求示例</div><div class="code-template"><pre class="get-url-pre">http://yingyan.baidu.com/api/v3/fence/querystatus?service_id=100000&amp;monitored_person=小明&amp;fence_ids=1,2,3&amp;ak=<用户的'''AK>'''
+
<div class="serve-explain-text"><div class="serveintoor-title">请求示例</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/fence/querystatus?service_id=100000&amp;monitored_person=小明&amp;fence_ids=1,2,3&amp;ak=<用户的'''AK>'''
 
</pre>
 
</pre>
  </div></div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">  {
+
</div></div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">  {
 
     &quot;status&quot;: 0,
 
     &quot;status&quot;: 0,
 
     &quot;message&quot;: &quot;成功&quot;,
 
     &quot;message&quot;: &quot;成功&quot;,
第168行: 第168行:
 
   }
 
   }
 
   </pre>
 
   </pre>
 
+
 
 
+
 
  <div class="separate-title service-page-anchor">querystatusbylocation——根据坐标查询监控对象相对围栏的状态</div><div class="serve-explain-text">简介:传入坐标,计算该坐标在围栏内/外。<br/>适用场景:由于querystatus接口需要保证到轨迹点的顺序性,因此查询状态会有15s的延迟。若开发者对即时性要求甚高,如共享汽车、共享单车落锁时对于是否停在规定围栏内的判断,可使用querystatusbylocation接口:传入当下定位的坐标,则鹰眼将计算该坐标相对于围栏的状态(内/外)。<br/></div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">http://yingyan.baidu.com/api/v3/fence/querystatusbylocation //GET请求
+
<div class="separate-title service-page-anchor">querystatusbylocation——根据坐标查询监控对象相对围栏的状态</div><div class="serve-explain-text">简介:传入坐标,计算该坐标在围栏内/外。<br/>适用场景:由于querystatus接口需要保证到轨迹点的顺序性,因此查询状态会有15s的延迟。若开发者对即时性要求甚高,如共享汽车、共享单车落锁时对于是否停在规定围栏内的判断,可使用querystatusbylocation接口:传入当下定位的坐标,则鹰眼将计算该坐标相对于围栏的状态(内/外)。<br/></div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/fence/querystatusbylocation //GET请求
 
</pre>
 
</pre>
  </div></div><div class="separate-title">请求参数</div>
+
</div></div><div class="separate-title">请求参数</div>
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" | 参数名
+
! width="100" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="80" | 是否必填
+
! width="80" | 是否必填
  ! width="250" | 备注
+
! width="250" | 备注
  |-
+
|-
  | ak
+
| ak
  | 用户的'''AK'''
+
| 用户的'''AK'''
  | string
+
| string
  | 是
+
| 是
  |  
+
|  
  |-
+
|-
  | service_id
+
| service_id
  | service的ID,service 的唯一标识。
+
| service的ID,service 的唯一标识。
  | int
+
| int
  | 是
+
| 是
  | service 的唯一标识。在轨迹管理台创建鹰眼服务时,系统返回的 service_id
+
| service 的唯一标识。在轨迹管理台创建鹰眼服务时,系统返回的 service_id
 
+
 
 
+
 
  |-
+
|-
  | monitored_person
+
| monitored_person
  | 监控对象的 entity_name
+
| 监控对象的 entity_name
  | string(128)
+
| string(128)
  | 是
+
| 是
  |  
+
|  
  |-
+
|-
  | fence_ids
+
| fence_ids
  | 围栏实体的id列表
+
| 围栏实体的id列表
  | “int,int…”
+
| “int,int…”
  | 否
+
| 否
  | 若填写,则按照指定的id全部返回围栏状态,此时page_index和page_size不生效。<br/>若不填,则查询监控对象上的所有围栏状态。<br/>fence_ids中最多填写1000个id。<br/>
+
| 若填写,则按照指定的id全部返回围栏状态,此时page_index和page_size不生效。<br/>若不填,则查询监控对象上的所有围栏状态。<br/>fence_ids中最多填写1000个id。<br/>
  |-
+
|-
  | longitude
+
| longitude
  | 经度
+
| 经度
  | double
+
| double
  | 是
+
| 是
  | 指定监控对象所在坐标的经度
+
| 指定监控对象所在坐标的经度
  |-
+
|-
  | latitude
+
| latitude
  | 纬度
+
| 纬度
  | double
+
| double
  | 是
+
| 是
  | 指定监控对象所在坐标的纬度
+
| 指定监控对象所在坐标的纬度
  |-
+
|-
  | coord_type
+
| coord_type
  | 坐标类型
+
| 坐标类型
  | string
+
| string
  | 是
+
| 是
  | 坐标类型定义如下:
+
| 坐标类型定义如下:
 
wgs84:GPS经纬度 gcj02:国测局经纬度 bd09ll:百度经纬度
 
wgs84:GPS经纬度 gcj02:国测局经纬度 bd09ll:百度经纬度
 
+
 
  |-
+
|-
  | page_index<br/>
+
| page_index<br/>
  | 分页索引<br/>
+
| 分页索引<br/>
  | int(1到2^21-1)<br/>
+
| int(1到2^21-1)<br/>
  | 否
+
| 否
  | 默认值:1<br/>与page_size一起计算从第几条结果返回,代表返回第几页<br/>
+
| 默认值:1<br/>与page_size一起计算从第几条结果返回,代表返回第几页<br/>
  |-
+
|-
  | page_size<br/>
+
| page_size<br/>
  | 每页返回数据量<br/>
+
| 每页返回数据量<br/>
  | int(1-5000)<br/>
+
| int(1-5000)<br/>
  | 否<br/>
+
| 否<br/>
  | 默认值:1000<br/>返回结果最大个数与page_index一起计算从第几条结果返回,代表返回结果中每页有几个轨迹点<br/>
+
| 默认值:1000<br/>返回结果最大个数与page_index一起计算从第几条结果返回,代表返回结果中每页有几个轨迹点<br/>
  |-
+
|-
  | sn
+
| sn
  | 用户的权限签名,'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
+
| 用户的权限签名,'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
  | string
+
| string
  | 否
+
| 否
  |  
+
|  
  |}
+
|}
  <div class="separate-title">返回参数</div>
+
<div class="separate-title">返回参数</div>
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" colspan="2" | 参数名
+
! width="100" colspan="2" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="500" | 备注
+
! width="500" | 备注
  |-
+
|-
  | colspan="2" | status
+
| colspan="2" | status
  | 状态码
+
| 状态码
  | int
+
| int
  | 返回状态,0为成功
+
| 返回状态,0为成功
  |-
+
|-
  | colspan="2" | message
+
| colspan="2" | message
  | 响应信息
+
| 响应信息
  | string
+
| string
  | 对status的中文描述
+
| 对status的中文描述
  |-
+
|-
  | colspan="2" | total
+
| colspan="2" | total
  | 总的查询结果数量<br/>
+
| 总的查询结果数量<br/>
  | int
+
| int
  | <br/>
+
| <br/>
  |-
+
|-
  | colspan="2" | size
+
| colspan="2" | size
  | 本页返回的结果数量
+
| 本页返回的结果数量
  | int
+
| int
  |  
+
|  
  |-
+
|-
  | colspan="2" | monitored_statuses
+
| colspan="2" | monitored_statuses
  | 报警的数量
+
| 报警的数量
  | array
+
| array
  |  
+
|  
  |-
+
|-
  | rowspan="2" |  
+
| rowspan="2" |  
  | fence_id
+
| fence_id
  | 围栏 id
+
| 围栏 id
  | int
+
| int
  |  
+
|  
  |-
+
|-
  | monitored_status
+
| monitored_status
  | 状态
+
| 状态
  | string
+
| string
  | unknown:未知状态
+
| unknown:未知状态
 
in:在围栏内
 
in:在围栏内
 
+
 
 
out:在围栏外
 
out:在围栏外
 
+
 
  |}
+
|}
  <div class="serve-explain-text"><div class="serveintoor-title">请求示例</div><div class="code-template"><pre class="get-url-pre">http://yingyan.baidu.com/api/v3/fence/querystatusbylocation?service_id=100000&amp;monitored_person=小明&amp;fence_ids=1,2,3&amp;longitude=116.334129&amp;latitude=40.010939&amp;coord_type=bd09ll&amp;ak=<用户的'''AK>'''
+
<div class="serve-explain-text"><div class="serveintoor-title">请求示例</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/fence/querystatusbylocation?service_id=100000&amp;monitored_person=小明&amp;fence_ids=1,2,3&amp;longitude=116.334129&amp;latitude=40.010939&amp;coord_type=bd09ll&amp;ak=<用户的'''AK>'''
 
</pre>
 
</pre>
  </div></div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">  {
+
</div></div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">  {
 
     &quot;status&quot;: 0,
 
     &quot;status&quot;: 0,
 
     &quot;message&quot;: &quot;成功&quot;,
 
     &quot;message&quot;: &quot;成功&quot;,
第312行: 第312行:
 
   }
 
   }
 
   </pre>
 
   </pre>
 
+
 
 
+
 
 
+
 
 
+
 
  <div class="separate-title service-page-anchor">historyalarm—— 查询某监控对象的围栏报警信息</div><div class="serve-explain-text">
+
<div class="separate-title service-page-anchor">historyalarm—— 查询某监控对象的围栏报警信息</div><div class="serve-explain-text">
 
查询围栏的监控对象7天以内(包含7天)的围栏报警信息,7天以外的报警信息将被删除。
 
查询围栏的监控对象7天以内(包含7天)的围栏报警信息,7天以外的报警信息将被删除。
 
+
 
 
+
 
  注:即使围栏或监控对象已被删除,仍能根据 fence_id 和 monitored_person 查询7天之内的报警信息。</div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">http://yingyan.baidu.com/api/v3/fence/historyalarm //GET请求
+
注:即使围栏或监控对象已被删除,仍能根据 fence_id 和 monitored_person 查询7天之内的报警信息。</div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/fence/historyalarm //GET请求
 
</pre>
 
</pre>
  </div></div><div class="separate-title">请求参数</div>
+
</div></div><div class="separate-title">请求参数</div>
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" | 参数名
+
! width="100" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="80" | 是否必填
+
! width="80" | 是否必填
  ! width="250" | 备注
+
! width="250" | 备注
  |-
+
|-
  | ak
+
| ak
  | 用户的'''AK'''
+
| 用户的'''AK'''
  | string
+
| string
  | 是
+
| 是
  |  
+
|  
  |-
+
|-
  | service_id
+
| service_id
  | service的ID,service 的唯一标识。
+
| service的ID,service 的唯一标识。
  | int
+
| int
  | 是
+
| 是
  | 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
+
| 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
  |-
+
|-
  | monitored_person
+
| monitored_person
  | 监控对象的 entity_name
+
| 监控对象的 entity_name
  | string(128)
+
| string(128)
  | 是
+
| 是
  |  
+
|  
  |-
+
|-
  | fence_ids
+
| fence_ids
  | 围栏实体的id列表
+
| 围栏实体的id列表
  | “int,int…”
+
| “int,int…”
  | 否
+
| 否
  | 若不填,则查询监控对象所有围栏的报警信息
+
| 若不填,则查询监控对象所有围栏的报警信息
  |-
+
|-
  | start_time
+
| start_time
  | 开始时间
+
| 开始时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 否
+
| 否
  | 若不填,则返回7天内所有报警信息
+
| 若不填,则返回7天内所有报警信息
  |-
+
|-
  | end_time
+
| end_time
  | 结束时间
+
| 结束时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 否
+
| 否
  | 若不填,则返回7天内所有报警信息
+
| 若不填,则返回7天内所有报警信息
  |-
+
|-
  | coord_type_output
+
| coord_type_output
  | 返回坐标类型
+
| 返回坐标类型
  | string
+
| string
  | 否
+
| 否
  | 默认为 bd09ll。
+
| 默认为 bd09ll。
 
用于控制返回结果的坐标类型
 
用于控制返回结果的坐标类型
 
+
 
 
可选值如下:
 
可选值如下:
 
+
 
 
bd09ll:百度经纬度
 
bd09ll:百度经纬度
 
+
 
 
gcj02:国测局经纬度
 
gcj02:国测局经纬度
 
+
 
 
注:国外均返回 wgs84 坐标
 
注:国外均返回 wgs84 坐标
 
+
 
  |-
+
|-
  | sn
+
| sn
  | 用户的权限签名,'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
+
| 用户的权限签名,'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
  | string
+
| string
  | 否
+
| 否
  |  
+
|  
  |}
+
|}
  <div class="separate-title">返回参数</div>
+
<div class="separate-title">返回参数</div>
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" colspan="3" | 参数名
+
! width="100" colspan="3" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="500" | 备注
+
! width="500" | 备注
  |-
+
|-
  | colspan="3" | status
+
| colspan="3" | status
  | 状态码
+
| 状态码
  | int
+
| int
  | 返回状态,0为成功
+
| 返回状态,0为成功
  |-
+
|-
  | colspan="3" | message
+
| colspan="3" | message
  | 响应信息
+
| 响应信息
  | string
+
| string
  | 对status的中文描述
+
| 对status的中文描述
  |-
+
|-
  | colspan="3" | size
+
| colspan="3" | size
  | 返回结果的数量
+
| 返回结果的数量
  | int
+
| int
  |  
+
|  
  |-
+
|-
  | colspan="3" | alarms
+
| colspan="3" | alarms
  | 报警的数量
+
| 报警的数量
  | array
+
| array
  |  
+
|  
  |-
+
|-
  | rowspan="18" |  
+
| rowspan="18" |  
  | colspan="2" | fence_id
+
| colspan="2" | fence_id
  | 围栏 id,唯一标识符
+
| 围栏 id,唯一标识符
  | int
+
| int
  |  
+
|  
  |-
+
|-
  | colspan="2" | fence_name
+
| colspan="2" | fence_name
  | 围栏的名称
+
| 围栏的名称
  | string
+
| string
  |  
+
|  
  |-
+
|-
  | colspan="2" | monitored_person
+
| colspan="2" | monitored_person
  | 监控对象
+
| 监控对象
  | string
+
| string
  |  
+
|  
  |-
+
|-
  | colspan="2" | action
+
| colspan="2" | action
  | 触发动作
+
| 触发动作
  | string
+
| string
  | 可能的返回值:
+
| 可能的返回值:
 
enter:进入围栏
 
enter:进入围栏
 
+
 
 
exit:离开围栏
 
exit:离开围栏
 
+
 
  |-
+
|-
  | colspan="2" | alarm_point
+
| colspan="2" | alarm_point
  | 触发围栏报警轨迹点
+
| 触发围栏报警轨迹点
  |  
+
|  
  |  
+
|  
  |-
+
|-
  | rowspan="6" |  
+
| rowspan="6" |  
  | longitude
+
| longitude
  | 监控对象触发围栏时的经度
+
| 监控对象触发围栏时的经度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | latitude
+
| latitude
  | 监控对象触发围栏时的纬度
+
| 监控对象触发围栏时的纬度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | radius
+
| radius
  | 定位精度
+
| 定位精度
  | int
+
| int
  | 单位:米
+
| 单位:米
  |-
+
|-
  | coord_type
+
| coord_type
  | 返回的坐标类型
+
| 返回的坐标类型
  | string
+
| string
  | 仅在国外区域返回该字段,返回值为:wgs84
+
| 仅在国外区域返回该字段,返回值为:wgs84
  |-
+
|-
  | loc_time
+
| loc_time
  | 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
+
| 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
+
| 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
  |-
+
|-
  | create_time
+
| create_time
  | 服务端接收到报警信息的时间
+
| 服务端接收到报警信息的时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
+
| 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
  |-
+
|-
  | colspan="2" | pre_point
+
| colspan="2" | pre_point
  | 触发围栏报警轨迹点的上一个轨迹点
+
| 触发围栏报警轨迹点的上一个轨迹点
  |  
+
|  
  |  
+
|  
  |-
+
|-
  | rowspan="6" |  
+
| rowspan="6" |  
  | longitude
+
| longitude
  | 监控对象触发围栏时的经度
+
| 监控对象触发围栏时的经度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | latitude
+
| latitude
  | 监控对象触发围栏时的纬度
+
| 监控对象触发围栏时的纬度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | radius
+
| radius
  | 定位精度
+
| 定位精度
  | int
+
| int
  | 单位:米
+
| 单位:米
  |-
+
|-
  | coord_type
+
| coord_type
  | 返回的坐标类型
+
| 返回的坐标类型
  | string
+
| string
  | 仅在国外区域返回该字段,返回值为:wgs84
+
| 仅在国外区域返回该字段,返回值为:wgs84
  |-
+
|-
  | loc_time
+
| loc_time
  | 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
+
| 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
+
| 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
  |-
+
|-
  | create_time
+
| create_time
  | 服务端接收到报警信息的时间
+
| 服务端接收到报警信息的时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
+
| 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
  |}
+
|}
  <div class="serve-explain-text"><div class="serveintoor-title">请求示例</div><div class="code-template"><pre class="get-url-pre">http://yingyan.baidu.com/api/v3/fence/historyalarm?service_id=127980&amp;monitored_person=小明&amp;fence_ids=1&amp;start_time=1489420800&amp;end_time=1489507200&amp;ak=<用户的AK>
+
<div class="serve-explain-text"><div class="serveintoor-title">请求示例</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/fence/historyalarm?service_id=127980&amp;monitored_person=小明&amp;fence_ids=1&amp;start_time=1489420800&amp;end_time=1489507200&amp;ak=<用户的AK>
 
</pre>
 
</pre>
  </div></div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">{
+
</div></div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">{
 
       "status": 0,
 
       "status": 0,
 
       "size": 1,
 
       "size": 1,
第546行: 第546行:
 
   }
 
   }
 
   </pre>
 
   </pre>
 
+
 
 
+
 
  <div class="separate-title service-page-anchor">batchhistoryalarm—— 批量查询所有围栏报警信息</div><div class="serve-explain-text">批量查询某 service 7天内任意1小时,所有围栏的报警信息。</div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">http://yingyan.baidu.com/api/v3/fence/batchhistoryalarm //GET请求
+
<div class="separate-title service-page-anchor">batchhistoryalarm—— 批量查询所有围栏报警信息</div><div class="serve-explain-text">批量查询某 service 7天内任意1小时,所有围栏的报警信息。</div><div class="serve-explain-text"><div class="serveintoor-title">请求URI</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/fence/batchhistoryalarm //GET请求
 
</pre>
 
</pre>
  </div></div><div class="separate-title">请求参数</div>
+
</div></div><div class="separate-title">请求参数</div>
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" | 参数名
+
! width="100" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="80" | 是否必填
+
! width="80" | 是否必填
  ! width="250" | 备注
+
! width="250" | 备注
  |-
+
|-
  | ak
+
| ak
  | 用户的'''AK'''
+
| 用户的'''AK'''
  | string
+
| string
  | 是
+
| 是
  |  
+
|  
  |-
+
|-
  | service_id
+
| service_id
  | service的ID,service 的唯一标识。
+
| service的ID,service 的唯一标识。
  | int
+
| int
  | 是
+
| 是
  | 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
+
| 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
  |-
+
|-
  | start_time
+
| start_time
  | 开始时间
+
| 开始时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 是
+
| 是
  | 查询的时间是服务端接收到报警的时间,即报警信息的 create_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
+
| 查询的时间是服务端接收到报警的时间,即报警信息的 create_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
  |-
+
|-
  | end_time
+
| end_time
  | 结束时间
+
| 结束时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 是
+
| 是
  | 结束时间需大于开始时间,但不可超过1小时。即每次请求,最多只能同步1个小时时长的报警信息。
+
| 结束时间需大于开始时间,但不可超过1小时。即每次请求,最多只能同步1个小时时长的报警信息。
  |-
+
|-
  | coord_type_output
+
| coord_type_output
  | 返回坐标类型
+
| 返回坐标类型
  | string
+
| string
  | 否
+
| 否
  | 默认为 bd09ll。
+
| 默认为 bd09ll。
 
用于控制返回结果的坐标类型
 
用于控制返回结果的坐标类型
 
+
 
 
可选值如下:
 
可选值如下:
 
+
 
 
bd09ll:百度经纬度
 
bd09ll:百度经纬度
 
+
 
 
gcj02:国测局经纬度
 
gcj02:国测局经纬度
 
+
 
 
注:国外均返回 wgs84 坐标
 
注:国外均返回 wgs84 坐标
 
+
 
  |-
+
|-
  | page_index
+
| page_index
  | 分页索引
+
| 分页索引
  | int(1到2^32-1)
+
| int(1到2^32-1)
  | 可选
+
| 可选
  | 默认值为1。page_index与page_size一起计算从第几条结果返回,代表返回第几页。
+
| 默认值为1。page_index与page_size一起计算从第几条结果返回,代表返回第几页。
  |-
+
|-
  | page_size
+
| page_size
  | 分页大小
+
| 分页大小
  | int(1-1000)
+
| int(1-1000)
  | 可选
+
| 可选
  | 默认值为500。page_size与page_index一起计算从第几条结果返回,代表返回结果中每页有几条记录。
+
| 默认值为500。page_size与page_index一起计算从第几条结果返回,代表返回结果中每页有几条记录。
  |-
+
|-
  | sn
+
| sn
  | 用户的权限签名,'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
+
| 用户的权限签名,'''若用户所用AK的校验方式为SN校验时该参数必须。'''<br/>[http://lbsyun.baidu.com/index.php?title=webapi/appendix#service-page-anchor2 SN计算规则]
  | string
+
| string
  | 否
+
| 否
  |  
+
|  
  |}
+
|}
  <div class="separate-title">返回参数</div>
+
<div class="separate-title">返回参数</div>
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" colspan="3" | 参数名
+
! width="100" colspan="3" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="500" | 备注
+
! width="500" | 备注
  |-
+
|-
  | colspan="3" | status
+
| colspan="3" | status
  | 状态码
+
| 状态码
  | int
+
| int
  | 返回状态,0为成功
+
| 返回状态,0为成功
  |-
+
|-
  | colspan="3" | message
+
| colspan="3" | message
  | 响应信息
+
| 响应信息
  | string
+
| string
  | 对status的中文描述
+
| 对status的中文描述
  |-
+
|-
  | colspan="3" | total
+
| colspan="3" | total
  | 符合条件的总报警数
+
| 符合条件的总报警数
  | int
+
| int
  |  
+
|  
  |-
+
|-
  | colspan="3" | size
+
| colspan="3" | size
  | 本页返回的结果条数
+
| 本页返回的结果条数
  | int
+
| int
  |  
+
|  
  |-
+
|-
  | colspan="3" | alarms
+
| colspan="3" | alarms
  | 报警的数量
+
| 报警的数量
  | array
+
| array
  |  
+
|  
  |-
+
|-
  | rowspan="18" |  
+
| rowspan="18" |  
  | colspan="2" | fence_id
+
| colspan="2" | fence_id
  | 围栏 id,唯一标识符
+
| 围栏 id,唯一标识符
  | int
+
| int
  |  
+
|  
  |-
+
|-
  | colspan="2" | fence_name
+
| colspan="2" | fence_name
  | 围栏的名称
+
| 围栏的名称
  | string
+
| string
  |  
+
|  
  |-
+
|-
  | colspan="2" | monitored_person
+
| colspan="2" | monitored_person
  | 监控对象
+
| 监控对象
  | string
+
| string
  |  
+
|  
  |-
+
|-
  | colspan="2" | action
+
| colspan="2" | action
  | 触发动作
+
| 触发动作
  | string
+
| string
  | 可能的返回值:
+
| 可能的返回值:
 
enter:进入围栏
 
enter:进入围栏
 
+
 
 
exit:离开围栏
 
exit:离开围栏
 
+
 
  |-
+
|-
  | colspan="2" | alarm_point
+
| colspan="2" | alarm_point
  | 触发围栏报警轨迹点
+
| 触发围栏报警轨迹点
  |  
+
|  
  |  
+
|  
  |-
+
|-
  | rowspan="6" |  
+
| rowspan="6" |  
  | longitude
+
| longitude
  | 监控对象触发围栏时的经度
+
| 监控对象触发围栏时的经度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | latitude
+
| latitude
  | 监控对象触发围栏时的纬度
+
| 监控对象触发围栏时的纬度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | radius
+
| radius
  | 定位精度
+
| 定位精度
  | int
+
| int
  | 单位:米
+
| 单位:米
  |-
+
|-
  | coord_type
+
| coord_type
  | 返回的坐标类型
+
| 返回的坐标类型
  | string
+
| string
  | 仅在国外区域返回该字段,返回值为:wgs84
+
| 仅在国外区域返回该字段,返回值为:wgs84
  |-
+
|-
  | loc_time
+
| loc_time
  | 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
+
| 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
+
| 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
  |-
+
|-
  | create_time
+
| create_time
  | 服务端接收到报警信息的时间
+
| 服务端接收到报警信息的时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
+
| 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
  |-
+
|-
  | colspan="2" | pre_point
+
| colspan="2" | pre_point
  | 触发围栏报警轨迹点的上一个轨迹点
+
| 触发围栏报警轨迹点的上一个轨迹点
  |  
+
|  
  |  
+
|  
  |-
+
|-
  | rowspan="6" |  
+
| rowspan="6" |  
  | longitude
+
| longitude
  | 监控对象触发围栏时的经度
+
| 监控对象触发围栏时的经度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | latitude
+
| latitude
  | 监控对象触发围栏时的纬度
+
| 监控对象触发围栏时的纬度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | radius
+
| radius
  | 定位精度
+
| 定位精度
  | int
+
| int
  | 单位:米
+
| 单位:米
  |-
+
|-
  | coord_type
+
| coord_type
  | 返回的坐标类型
+
| 返回的坐标类型
  | string
+
| string
  | 仅在国外区域返回该字段,返回值为:wgs84
+
| 仅在国外区域返回该字段,返回值为:wgs84
  |-
+
|-
  | loc_time
+
| loc_time
  | 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
+
| 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
+
| 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
  |-
+
|-
  | create_time
+
| create_time
  | 服务端接收到报警信息的时间
+
| 服务端接收到报警信息的时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
+
| 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
  |}
+
|}
  <div class="serve-explain-text"><div class="serveintoor-title">请求示例</div><div class="code-template"><pre class="get-url-pre">http://yingyan.baidu.com/api/v3/fence/batchhistoryalarm?&amp;service_id=127980&amp;start_time=1489420800&amp;end_time=1489424400&amp;ak=<用户的AK>
+
<div class="serve-explain-text"><div class="serveintoor-title">请求示例</div><div class="code-template"><pre class="get-url-pre">https://yingyan.baidu.com/api/v3/fence/batchhistoryalarm?&amp;service_id=127980&amp;start_time=1489420800&amp;end_time=1489424400&amp;ak=<用户的AK>
 
</pre>
 
</pre>
  </div></div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">  
+
</div></div><div class="separate-title">返回示例</div><pre class="prettyprint codestyle">  
 
   {
 
   {
 
       &quot;status&quot;: 0,
 
       &quot;status&quot;: 0,
第801行: 第801行:
 
   }
 
   }
 
   </pre>
 
   </pre>
 
+
 
 
+
 
  <div class="separate-title service-page-anchor">服务端围栏报警信息推送</div><div class="serve-explain-text">鹰眼服务端支持将报警推送至开发者的服务端、鹰眼SDK(了解报警推送至鹰眼SDK功能请前往[http://lbsyun.baidu.com/index.php?title=android-yingyan/guide/geo-fencing Android鹰眼SDK]、[http://lbsyun.baidu.com/index.php?title=ios-yingyan/guide/geo-fencing iOS鹰眼SDK])。</div>
+
<div class="separate-title service-page-anchor">服务端围栏报警信息推送</div><div class="serve-explain-text">鹰眼服务端支持将报警推送至开发者的服务端、鹰眼SDK(了解报警推送至鹰眼SDK功能请前往[http://lbsyun.baidu.com/index.php?title=android-yingyan/guide/geo-fencing Android鹰眼SDK]、[http://lbsyun.baidu.com/index.php?title=ios-yingyan/guide/geo-fencing iOS鹰眼SDK])。</div>
 
若开发者要将围栏报警信息推送至开发者的服务端,需要开发者在自己的服务端实现自己的接收报警信息的HTTP服务,同时在[http://lbsyun.baidu.com/trace/admin/service 轨迹管理台设置页面]同步配置服务地址;百度鹰眼将通过该地址向开发者的服务端发送http请求,在请求中推送围栏报警信息。
 
若开发者要将围栏报警信息推送至开发者的服务端,需要开发者在自己的服务端实现自己的接收报警信息的HTTP服务,同时在[http://lbsyun.baidu.com/trace/admin/service 轨迹管理台设置页面]同步配置服务地址;百度鹰眼将通过该地址向开发者的服务端发送http请求,在请求中推送围栏报警信息。
 
+
 
 
   http://mapopen-pub-jsapi.bj.bcebos.com/img/yingyan_guide_webmanager_alert.png
 
   http://mapopen-pub-jsapi.bj.bcebos.com/img/yingyan_guide_webmanager_alert.png
 
    
 
    
 
    
 
    
 
    
 
    
 +
 
'''使用须知'''
 
'''使用须知'''
 
+
 
 
{{bluepoint}}鹰眼服务端将向开发者发送两类请求:
 
{{bluepoint}}鹰眼服务端将向开发者发送两类请求:
 
+
 
 
【地址校验请求】百度鹰眼在拿到开发者的URL的时候,需要对该URL做有效性校验,保证URL的可用性
 
【地址校验请求】百度鹰眼在拿到开发者的URL的时候,需要对该URL做有效性校验,保证URL的可用性
 
+
 
 
【报警信息推送请求】百度鹰眼地址校验通过后,将通过该类请求向开发者推送围栏报警信息
 
【报警信息推送请求】百度鹰眼地址校验通过后,将通过该类请求向开发者推送围栏报警信息
 
+
 
 
配置地址完成后,鹰眼服务端将向开发者服务端发送地址校验请求,如成功后,将不再发送校验类请求,直到变更配置地址。
 
配置地址完成后,鹰眼服务端将向开发者服务端发送地址校验请求,如成功后,将不再发送校验类请求,直到变更配置地址。
 
+
 
 
{{bluepoint}} 鹰眼服务端推送报警时,开发者返回信息接收是否成功。如果1s之内没有收到响应信息,则推送报警失败。若推送失败,将在后续的10分钟之内每隔60s推送一次,直至收到成功响应。若10分钟之后仍未成功,将不再推送,但报警记录将存储在鹰眼服务端。为避免因此造成报警漏接收,开发者可定期使用历史报警查询接口同步报警信息。
 
{{bluepoint}} 鹰眼服务端推送报警时,开发者返回信息接收是否成功。如果1s之内没有收到响应信息,则推送报警失败。若推送失败,将在后续的10分钟之内每隔60s推送一次,直至收到成功响应。若10分钟之后仍未成功,将不再推送,但报警记录将存储在鹰眼服务端。为避免因此造成报警漏接收,开发者可定期使用历史报警查询接口同步报警信息。
 
+
 
 
{{bluepoint}}'''开发者接收报警信息后的响应信息请务必按照格式填写,且为JSON格式,服务方可正确设置成功。具体格式请参考本页面最下方示例。'''
 
{{bluepoint}}'''开发者接收报警信息后的响应信息请务必按照格式填写,且为JSON格式,服务方可正确设置成功。具体格式请参考本页面最下方示例。'''
 
+
 
 
给开发者的建议:开发者在接收到该类消息之后,使用异步方式做业务处理。即获取到消息内容之后,立即返回,而报警推送的业务处理则在另外的线程中处理。
 
给开发者的建议:开发者在接收到该类消息之后,使用异步方式做业务处理。即获取到消息内容之后,立即返回,而报警推送的业务处理则在另外的线程中处理。
 
+
 
 
+
 
 
+
 
 
'''开发者使用服务步骤'''
 
'''开发者使用服务步骤'''
 
+
 
 
第一步:开发者搭建服务,使用http协议,构建服务端接收报警信息的URL
 
第一步:开发者搭建服务,使用http协议,构建服务端接收报警信息的URL
 
+
 
 
(请注意,该URL请求无需参数,URL中不可含有&&nbsp;?等特殊字符)
 
(请注意,该URL请求无需参数,URL中不可含有&&nbsp;?等特殊字符)
  
客户服务端需要支持
+
客户服务端需要支持 Content-Type: application/json Content-Type: application/x-www-form-urlencoded
Content-Type: application/json
+
 
Content-Type: application/x-www-form-urlencoded
+
 
+
 
开发者接收报警信息的服务要求必须及时对鹰眼服务端发送的请求做出响应,如鹰眼服务端1s之内没有收到响应信息,则报警失败。
 
开发者接收报警信息的服务要求必须及时对鹰眼服务端发送的请求做出响应,如鹰眼服务端1s之内没有收到响应信息,则报警失败。
 
+
 
 
假设用户提供的URL为http://your.server.name:port/your/path
 
假设用户提供的URL为http://your.server.name:port/your/path
 
+
 
 
第二步:在[http://lbsyun.baidu.com/trace/admin/service 轨迹管理台设置页面]配置该URL<br/>'''http://mapopen-pub-jsapi.bj.bcebos.com/img/yingyan_trace_admin_service.png'''
 
第二步:在[http://lbsyun.baidu.com/trace/admin/service 轨迹管理台设置页面]配置该URL<br/>'''http://mapopen-pub-jsapi.bj.bcebos.com/img/yingyan_trace_admin_service.png'''
 
+
 
 
配置成功后,鹰眼服务端立即向开发者发送校验URL请求:
 
配置成功后,鹰眼服务端立即向开发者发送校验URL请求:
 
+
 
 
1.校验请求:POST请求,仅配置地址完成后首次报警前发送该请求。
 
1.校验请求:POST请求,仅配置地址完成后首次报警前发送该请求。
 
+
 
 
POST内容为JSON格式消息,{“type”:1, ”service_id”:2741}
 
POST内容为JSON格式消息,{“type”:1, ”service_id”:2741}
 
+
 
 
校验成功后,当鹰眼服务端围栏触发报警时,将向此URL推送地理围栏报警信息。
 
校验成功后,当鹰眼服务端围栏触发报警时,将向此URL推送地理围栏报警信息。
 
+
 
 
2.报警推送请求:POST请求,围栏触发报警即发送该类请求
 
2.报警推送请求:POST请求,围栏触发报警即发送该类请求
 
+
 
 
POST内容为JSON格式消息,{“type”:2, ”service_id”:2741, ”content”:[报警信息数组]}
 
POST内容为JSON格式消息,{“type”:2, ”service_id”:2741, ”content”:[报警信息数组]}
 
+
 
 
'''接口说明'''
 
'''接口说明'''
 
+
 
 
支持将鹰眼服务端地理围栏报警信息推送至开发者的服务端。
 
支持将鹰眼服务端地理围栏报警信息推送至开发者的服务端。
 
+
 
 
'''请求URI'''
 
'''请求URI'''
 
+
 
 
开发者构建围栏报警请求URL,鹰眼将根据此URL向开发者服务端发送请求。
 
开发者构建围栏报警请求URL,鹰眼将根据此URL向开发者服务端发送请求。
 
+
 
 
该URL需要同步在轨迹管理台配置页面配置,使鹰眼能够唯一识别对应service_id与开发者服务端地址。
 
该URL需要同步在轨迹管理台配置页面配置,使鹰眼能够唯一识别对应service_id与开发者服务端地址。
 
+
 
 
'''HTTP请求方式'''
 
'''HTTP请求方式'''
 
+
 
 
POST
 
POST
 
+
 
 
'''数据格式'''
 
'''数据格式'''
 
+
 
 
请求和返回均为JSON格式
 
请求和返回均为JSON格式
 
+
 
 
'''公共请求头'''
 
'''公共请求头'''
 
+
 
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" | 参数名
+
! width="100" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="250" | 备注
+
! width="250" | 备注
  |-
+
|-
  | SignId
+
| SignId
  |  
+
|  
 
请求来源标记
 
请求来源标记
 
+
 
  | string
+
| string
  | 允许的请求值:baidu_yingyan<br/>用户可以通过获取这个标志来判断一个http请求是否来自百度鹰眼。
+
| 允许的请求值:baidu_yingyan<br/>用户可以通过获取这个标志来判断一个http请求是否来自百度鹰眼。
  |-
+
|-
  | Content-Encoding
+
| Content-Encoding
  |  
+
|  
 
消息压缩标记
 
消息压缩标记
 
+
 
  | string
+
| string
  | 允许的请求值:gzip 或 空值<br/>为减少请求量,提高网络传输速度,鹰眼可对请求内容做gzip压缩,此时请求头中将包含该字段。
+
| 允许的请求值:gzip 或 空值<br/>为减少请求量,提高网络传输速度,鹰眼可对请求内容做gzip压缩,此时请求头中将包含该字段。
 
用户在接收到该类型请求时,需要判断Content-Encoding是否为gzip压缩:如果Content-Encoding=gzip,需要对请求体进行解压缩,解压缩之后的内容即为报警推送消息;如果Content-Encoding为空,则无需进行解压缩。
 
用户在接收到该类型请求时,需要判断Content-Encoding是否为gzip压缩:如果Content-Encoding=gzip,需要对请求体进行解压缩,解压缩之后的内容即为报警推送消息;如果Content-Encoding为空,则无需进行解压缩。
 
+
 
  |}
+
|}
 
+
 
 
<br/>'''请求体参数'''
 
<br/>'''请求体参数'''
 
+
 
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" colspan="3" | 参数名
+
! width="100" colspan="3" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="500" | 备注
+
! width="500" | 备注
  |-
+
|-
  | colspan="3" | type
+
| colspan="3" | type
  | 消息类型
+
| 消息类型
  | int
+
| int
  | 取值1或者2
+
| 取值1或者2
 
1:当type=1时,校验该URL为有效URL。此时,content为空或不存在。开发者无需对消息内容做任何处理,只需正常返回即可。
 
1:当type=1时,校验该URL为有效URL。此时,content为空或不存在。开发者无需对消息内容做任何处理,只需正常返回即可。
 
+
 
 
2:当type=2时,推送报警信息,开发者可取content中的内容做其他业务处理。
 
2:当type=2时,推送报警信息,开发者可取content中的内容做其他业务处理。
 
+
 
  |-
+
|-
  | colspan="3" | service_id
+
| colspan="3" | service_id
  | service的唯一标识,当前报警信息所属的鹰眼服务ID
+
| service的唯一标识,当前报警信息所属的鹰眼服务ID
  | int
+
| int
  | 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
+
| 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
  |-
+
|-
  | colspan="3" | content
+
| colspan="3" | content
  | 报警信息数组
+
| 报警信息数组
  | array
+
| array
  | 当type为1时,content为空或不存在。
+
| 当type为1时,content为空或不存在。
 
该字段为数组格式,数组的每个内容都是一个推送信息。
 
该字段为数组格式,数组的每个内容都是一个推送信息。
 
+
 
  |-
+
|-
  | rowspan="18" |  
+
| rowspan="18" |  
  | colspan="2" | fence_id
+
| colspan="2" | fence_id
  | 围栏 id,唯一标识符
+
| 围栏 id,唯一标识符
  | int
+
| int
  | 一条推送返回一个报警信息
+
| 一条推送返回一个报警信息
  |-
+
|-
  | colspan="2" | fence_name
+
| colspan="2" | fence_name
  | 围栏的名称
+
| 围栏的名称
  | string
+
| string
  |  
+
|  
  |-
+
|-
  | colspan="2" | monitored_person
+
| colspan="2" | monitored_person
  | 监控对象
+
| 监控对象
  | string
+
| string
  | 监控对象的entity_name
+
| 监控对象的entity_name
  |-
+
|-
  | colspan="2" | action
+
| colspan="2" | action
  | 报警触发动作
+
| 报警触发动作
  | string
+
| string
  | 可能的请求值:
+
| 可能的请求值:
 
enter:进入围栏
 
enter:进入围栏
 
+
 
 
exit:离开围栏
 
exit:离开围栏
 
+
 
  |-
+
|-
  | colspan="2" | alarm_point
+
| colspan="2" | alarm_point
  | 触发围栏报警轨迹点
+
| 触发围栏报警轨迹点
  |  
+
|  
  |  
+
|  
  |-
+
|-
  | rowspan="6" |  
+
| rowspan="6" |  
  | longitude
+
| longitude
  | 监控对象触发围栏时的经度
+
| 监控对象触发围栏时的经度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | latitude
+
| latitude
  | 监控对象触发围栏时的纬度
+
| 监控对象触发围栏时的纬度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | radius
+
| radius
  | 定位点的精度
+
| 定位点的精度
  | int
+
| int
  | 单位:米
+
| 单位:米
  |-
+
|-
  | coord_type
+
| coord_type
  | 坐标类型
+
| 坐标类型
  | string
+
| string
  | 国内为百度坐标系:bd09ll;国外均为 wgs84坐标系:wgs84
+
| 国内为百度坐标系:bd09ll;国外均为 wgs84坐标系:wgs84
  |-
+
|-
  | loc_time
+
| loc_time
  | 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
+
| 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
+
| 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
  |-
+
|-
  | create_time
+
| create_time
  | 服务端接收到报警信息的时间
+
| 服务端接收到报警信息的时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
+
| 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
  |-
+
|-
  | colspan="2" | pre_point
+
| colspan="2" | pre_point
  | 触发围栏报警轨迹点的上一个轨迹点
+
| 触发围栏报警轨迹点的上一个轨迹点
  |  
+
|  
  |  
+
|  
  |-
+
|-
  | rowspan="6" |  
+
| rowspan="6" |  
  | longitude
+
| longitude
  | 监控对象触发围栏时的经度
+
| 监控对象触发围栏时的经度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | latitude
+
| latitude
  | 监控对象触发围栏时的纬度
+
| 监控对象触发围栏时的纬度
  | double
+
| double
  |  
+
|  
  |-
+
|-
  | radius
+
| radius
  | 定位点的精度
+
| 定位点的精度
  | int
+
| int
  | 单位:米
+
| 单位:米
  |-
+
|-
  | coord_type
+
| coord_type
  | 坐标类型
+
| 坐标类型
  | string
+
| string
  | 国内为百度坐标系:bd09ll;国外均为wgs84坐标系:wgs84
+
| 国内为百度坐标系:bd09ll;国外均为wgs84坐标系:wgs84
  |-
+
|-
  | loc_time
+
| loc_time
  | 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
+
| 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
+
| 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
  |-
+
|-
  | create_time
+
| create_time
  | 服务端接收到报警信息的时间
+
| 服务端接收到报警信息的时间
  | UNIX 时间戳
+
| UNIX 时间戳
  | 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
+
| 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
  |}
+
|}
 
+
 
 
'''公共返回头'''
 
'''公共返回头'''
 
+
 
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" | 参数名
+
! width="100" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="250" | 备注
+
! width="250" | 备注
  |-
+
|-
  | SignId
+
| SignId
  | 返回值:baidu_yingyan
+
| 返回值:baidu_yingyan
 
请求来源标记。
 
请求来源标记。
 
+
 
  | string
+
| string
  | 根据该字段识别响应身份,若未返回该字段,则视为URL校验失败,不再对该URL发送推送数据。
+
| 根据该字段识别响应身份,若未返回该字段,则视为URL校验失败,不再对该URL发送推送数据。
  |}
+
|}
 
+
 
 
'''返回体参数'''
 
'''返回体参数'''
 
+
 
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="100" | 参数名
+
! width="100" | 参数名
  ! width="150" | 参数含义
+
! width="150" | 参数含义
  ! width="80" | 类型
+
! width="80" | 类型
  ! width="250" | 备注
+
! width="250" | 备注
  |-
+
|-
  | status
+
| status
  | 返回状态码
+
| 返回状态码
  | int
+
| int
  | 0或非0值
+
| 0或非0值
  |-
+
|-
  | message
+
| message
  | 返回信息
+
| 返回信息
  | string
+
| string
  | 对status的中文描述。
+
| 对status的中文描述。
  |}
+
|}
 
+
 
 
百度鹰眼不对响应内容做处理,只要http的状态码为200,则视为发送成功(返回非200的其他任何内容都视为该次调用失败)。此响应内容中的status不作为成功与否的标志,也不会根据此status的值做重试处理。
 
百度鹰眼不对响应内容做处理,只要http的状态码为200,则视为发送成功(返回非200的其他任何内容都视为该次调用失败)。此响应内容中的status不作为成功与否的标志,也不会根据此status的值做重试处理。
 
+
 
 
'''请求示例'''
 
'''请求示例'''
 
+
 
 
以下是一个校验消息的完整请求示例:
 
以下是一个校验消息的完整请求示例:
 
+
 
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="1000" | 完整请求示例
+
! width="1000" | 完整请求示例
  |-
+
|-
  ! width="1000" | 请求头
+
! width="1000" | 请求头
  |-
+
|-
  |  
+
|  
 
       "SignId": "baidu_yingyan"
 
       "SignId": "baidu_yingyan"
 
    
 
    
  |-
+
 
  ! width="1000" | 请求体
+
|-
  |-
+
! width="1000" | 请求体
  |  
+
|-
 +
|  
 
     {
 
     {
 
         "type":1,
 
         "type":1,
第1,089行: 第1,089行:
 
     }
 
     }
 
    
 
    
  |}
+
 
 
+
|}
 +
 
 
以下是一个推送消息的完整请求示例:
 
以下是一个推送消息的完整请求示例:
 
+
 
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="1000" | 完整请求示例
+
! width="1000" | 完整请求示例
  |-
+
|-
  ! width="1000" | 请求头
+
! width="1000" | 请求头
  |-
+
|-
  |  
+
|  
 
       "SignId": "baidu_yingyan"
 
       "SignId": "baidu_yingyan"
 
       "Content-Encoding": "gzip"
 
       "Content-Encoding": "gzip"
 
    
 
    
  |-
+
 
  ! width="1000" | 请求体(解压缩之后)
+
|-
  |-
+
! width="1000" | 请求体(解压缩之后)
  |  
+
|-
 +
|  
 
       {
 
       {
 
           "type":2,
 
           "type":2,
第1,136行: 第1,138行:
 
       }
 
       }
 
    
 
    
  |}
+
 
 
+
|}
 +
 
 
'''返回示例'''
 
'''返回示例'''
 
+
 
  {| border="1" cellspacing="0" cellpadding="0"
+
{| border="1" cellspacing="0" cellpadding="0"
  |-
+
|-
  ! width="1000" | 完整返回示例
+
! width="1000" | 完整返回示例
  |-
+
|-
  ! width="1000" | 返回头
+
! width="1000" | 返回头
  |-
+
|-
  |  
+
|  
 
       "SignId": "baidu_yingyan"
 
       "SignId": "baidu_yingyan"
 
    
 
    
  |-
+
 
  ! width="1000" | 返回体
+
|-
  |-
+
! width="1000" | 返回体
  |  
+
|-
 +
|  
 
     {
 
     {
 
         "status":0,
 
         "status":0,
第1,158行: 第1,162行:
 
     }
 
     }
 
    
 
    
  |}
+
 
 +
|}

2022年7月22日 (五) 20:44的版本

简介

地理围栏报警类接口主要提供

1. 查询监控对象在围栏内/外:查询被监控对象在指定围栏内或外,也支持查询被监控对象目前相对于所有围栏的状态

2. 查询围栏报警信息:支持查询某时间段内单个围栏或该 service 下所有围栏的报警信息

3. 服务端报警信息推送:鹰眼将报警信息实时推送至开发者的服务端
接口列表
模块 接口名称 功能说明
fence
querystatus 查询监控对象在围栏内或外
querystatusbylocation 查询坐标在围栏内或外
historyalarm 查询某监控对象的历史报警信息
batchhistoryalarm 批量查询某 service 下时间段以内的所有报警信息,用于服务端报警同步
服务端报警推送
向开发者服务端推送围栏报警信息
坐标系说明

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

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

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

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

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


鹰眼 Web服务API V3.0的默认输入输出参数为百度坐标(BD09),同时可通过"coord_type","coord_type_input","coord_type_output"(以各服务参数介绍为准)控制输入输出的坐标类型,鹰眼将自动完成转换。
围栏报警接口使用小贴士

1. 为保证轨迹点的顺序性,使用查询围栏报警信息(querystatus)接口时,轨迹点上传成功后,服务端会有15秒左右报警延迟。

2. 围栏报警是通过计算监控对象的轨迹来进行状态判断。为提高报警准确性,服务端将针对轨迹做去噪纠偏。

3. 若监控对象的轨迹点异常,围栏报警计算时将会过滤该点,建议使用实际路测数据测试地理围栏报警服务功能。

在使用围栏时,发现轨迹点未触发围栏报警,开发者可从以下几方面排查原因:
1. 轨迹点的定位时间是否早于围栏创建时间,若如此,此点将不参与围栏计算;
2. 轨迹点被认为是噪点被去除,从而不参与围栏计算。噪点的判定方法,一方面是轨迹点定位误差是否超过了开发者创建围栏时设置的去噪阈值(denoise),一方面是鹰眼内部的去噪策略,开发者可通过轨迹管理台对比原始轨迹和去噪后轨迹来辨别噪点;
3. 轨迹点不是真实轨迹,而是开发者构造的虚拟轨迹,围栏在计算时也将忽略这部分轨迹;
4. 轨迹点上传顺序错乱问题,若定位时间较新的轨迹点已上传并参与围栏计算了,那么此时再上传定位时间较旧的轨迹点,则旧轨迹点不再参与围栏计算。
接口说明
querystatus——查询监控对象相对围栏的状态
查询被监控对象在指定围栏内或外,也支持查询被监控对象目前相对于所有围栏的状态
请求URI
https://yingyan.baidu.com/api/v3/fence/querystatus //GET请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的AK string
service_id service的ID,service 的唯一标识。 int service 的唯一标识。在轨迹管理台创建鹰眼服务时,系统返回的 service_id


monitored_person 监控对象的 entity_name string(128)


fence_ids 围栏实体的id列表 “int,int…” 若填写,则按照指定的id全部返回围栏状态,此时page_index和page_size不生效。
若不填,则查询监控对象上的所有围栏状态。
fence_ids中最多填写1000个id。
page_index
分页索引
int(1到2^21-1)
默认值:1
与page_size一起计算从第几条结果返回,代表返回第几页
page_size
每页返回数据量
int(1-5000)
默认值:1000
返回结果最大个数与page_index一起计算从第几条结果返回,代表返回结果中每页有几个轨迹点
sn 用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。
SN计算规则
string
返回参数
参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
total 总的查询结果数量 int
size 本页返回的结果数量 int
monitored_statuses 报警的数量 array
fence_id 围栏 id int
monitored_status 状态 string unknown:未知状态

in:在围栏内

out:在围栏外

请求示例
https://yingyan.baidu.com/api/v3/fence/querystatus?service_id=100000&monitored_person=小明&fence_ids=1,2,3&ak=<用户的'''AK>'''
返回示例
  {
    "status": 0,
    "message": "成功",
    "size": 2,
    "monitored_statuses": [
      {
        "fence_id": 2,
        "monitored_status": "in"
      },
      {
        "fence_id": 3,
        "monitored_status": "unknown"
      }
    ]
  
  }
  


querystatusbylocation——根据坐标查询监控对象相对围栏的状态
简介:传入坐标,计算该坐标在围栏内/外。
适用场景:由于querystatus接口需要保证到轨迹点的顺序性,因此查询状态会有15s的延迟。若开发者对即时性要求甚高,如共享汽车、共享单车落锁时对于是否停在规定围栏内的判断,可使用querystatusbylocation接口:传入当下定位的坐标,则鹰眼将计算该坐标相对于围栏的状态(内/外)。
请求URI
https://yingyan.baidu.com/api/v3/fence/querystatusbylocation //GET请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的AK string
service_id service的ID,service 的唯一标识。 int service 的唯一标识。在轨迹管理台创建鹰眼服务时,系统返回的 service_id


monitored_person 监控对象的 entity_name string(128)
fence_ids 围栏实体的id列表 “int,int…” 若填写,则按照指定的id全部返回围栏状态,此时page_index和page_size不生效。
若不填,则查询监控对象上的所有围栏状态。
fence_ids中最多填写1000个id。
longitude 经度 double 指定监控对象所在坐标的经度
latitude 纬度 double 指定监控对象所在坐标的纬度
coord_type 坐标类型 string 坐标类型定义如下:

wgs84:GPS经纬度 gcj02:国测局经纬度 bd09ll:百度经纬度

page_index
分页索引
int(1到2^21-1)
默认值:1
与page_size一起计算从第几条结果返回,代表返回第几页
page_size
每页返回数据量
int(1-5000)

默认值:1000
返回结果最大个数与page_index一起计算从第几条结果返回,代表返回结果中每页有几个轨迹点
sn 用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。
SN计算规则
string
返回参数
参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
total 总的查询结果数量
int
size 本页返回的结果数量 int
monitored_statuses 报警的数量 array
fence_id 围栏 id int
monitored_status 状态 string unknown:未知状态

in:在围栏内

out:在围栏外

请求示例
https://yingyan.baidu.com/api/v3/fence/querystatusbylocation?service_id=100000&monitored_person=小明&fence_ids=1,2,3&longitude=116.334129&latitude=40.010939&coord_type=bd09ll&ak=<用户的'''AK>'''
返回示例
  {
    "status": 0,
    "message": "成功",
    "size": 2,
    "monitored_statuses": [
      {
        "fence_id": 2,
        "monitored_status": "in"
      },
      {
        "fence_id": 3,
        "monitored_status": "unknown"
      }
    ]
  
  }
  



historyalarm—— 查询某监控对象的围栏报警信息

查询围栏的监控对象7天以内(包含7天)的围栏报警信息,7天以外的报警信息将被删除。


注:即使围栏或监控对象已被删除,仍能根据 fence_id 和 monitored_person 查询7天之内的报警信息。
请求URI
https://yingyan.baidu.com/api/v3/fence/historyalarm //GET请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的AK string
service_id service的ID,service 的唯一标识。 int 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
monitored_person 监控对象的 entity_name string(128)
fence_ids 围栏实体的id列表 “int,int…” 若不填,则查询监控对象所有围栏的报警信息
start_time 开始时间 UNIX 时间戳 若不填,则返回7天内所有报警信息
end_time 结束时间 UNIX 时间戳 若不填,则返回7天内所有报警信息
coord_type_output 返回坐标类型 string 默认为 bd09ll。

用于控制返回结果的坐标类型

可选值如下:

bd09ll:百度经纬度

gcj02:国测局经纬度

注:国外均返回 wgs84 坐标

sn 用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。
SN计算规则
string
返回参数
参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
size 返回结果的数量 int
alarms 报警的数量 array
fence_id 围栏 id,唯一标识符 int
fence_name 围栏的名称 string
monitored_person 监控对象 string
action 触发动作 string 可能的返回值:

enter:进入围栏

exit:离开围栏

alarm_point 触发围栏报警轨迹点
longitude 监控对象触发围栏时的经度 double
latitude 监控对象触发围栏时的纬度 double
radius 定位精度 int 单位:米
coord_type 返回的坐标类型 string 仅在国外区域返回该字段,返回值为:wgs84
loc_time 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间 UNIX 时间戳 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
create_time 服务端接收到报警信息的时间 UNIX 时间戳 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
pre_point 触发围栏报警轨迹点的上一个轨迹点
longitude 监控对象触发围栏时的经度 double
latitude 监控对象触发围栏时的纬度 double
radius 定位精度 int 单位:米
coord_type 返回的坐标类型 string 仅在国外区域返回该字段,返回值为:wgs84
loc_time 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间 UNIX 时间戳 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
create_time 服务端接收到报警信息的时间 UNIX 时间戳 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
请求示例
https://yingyan.baidu.com/api/v3/fence/historyalarm?service_id=127980&monitored_person=小明&fence_ids=1&start_time=1489420800&end_time=1489507200&ak=<用户的AK>
返回示例
{
      "status": 0,
      "size": 1,
      "message": "成功",
      " alarms ": [
          {
              "fence_id": 1,
              "fence_name":"围栏名称",
              "monitored_person":"entity1",
              "action": "exit", 
              "alarm_point":{
               
                  "longitude":116.2333,
                  "latitude":43.892,
                  "radius":27,
                  "loc_time": 1419388604
                  "create_time": 1419388609
                },
              "pre_point":{
                  "longitude":116.2367,
                  "latitude":43.894,
                  "radius":28,
                  "loc_time": 1419388724
                  "create_time": 1419388729
                }           
          }
      ]
  
  }
  


batchhistoryalarm—— 批量查询所有围栏报警信息
批量查询某 service 7天内任意1小时,所有围栏的报警信息。
请求URI
https://yingyan.baidu.com/api/v3/fence/batchhistoryalarm //GET请求
请求参数
参数名 参数含义 类型 是否必填 备注
ak 用户的AK string
service_id service的ID,service 的唯一标识。 int 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
start_time 开始时间 UNIX 时间戳 查询的时间是服务端接收到报警的时间,即报警信息的 create_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
end_time 结束时间 UNIX 时间戳 结束时间需大于开始时间,但不可超过1小时。即每次请求,最多只能同步1个小时时长的报警信息。
coord_type_output 返回坐标类型 string 默认为 bd09ll。

用于控制返回结果的坐标类型

可选值如下:

bd09ll:百度经纬度

gcj02:国测局经纬度

注:国外均返回 wgs84 坐标

page_index 分页索引 int(1到2^32-1) 可选 默认值为1。page_index与page_size一起计算从第几条结果返回,代表返回第几页。
page_size 分页大小 int(1-1000) 可选 默认值为500。page_size与page_index一起计算从第几条结果返回,代表返回结果中每页有几条记录。
sn 用户的权限签名,若用户所用AK的校验方式为SN校验时该参数必须。
SN计算规则
string
返回参数
参数名 参数含义 类型 备注
status 状态码 int 返回状态,0为成功
message 响应信息 string 对status的中文描述
total 符合条件的总报警数 int
size 本页返回的结果条数 int
alarms 报警的数量 array
fence_id 围栏 id,唯一标识符 int
fence_name 围栏的名称 string
monitored_person 监控对象 string
action 触发动作 string 可能的返回值:

enter:进入围栏

exit:离开围栏

alarm_point 触发围栏报警轨迹点
longitude 监控对象触发围栏时的经度 double
latitude 监控对象触发围栏时的纬度 double
radius 定位精度 int 单位:米
coord_type 返回的坐标类型 string 仅在国外区域返回该字段,返回值为:wgs84
loc_time 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间 UNIX 时间戳 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
create_time 服务端接收到报警信息的时间 UNIX 时间戳 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
pre_point 触发围栏报警轨迹点的上一个轨迹点
longitude 监控对象触发围栏时的经度 double
latitude 监控对象触发围栏时的纬度 double
radius 定位精度 int 单位:米
coord_type 返回的坐标类型 string 仅在国外区域返回该字段,返回值为:wgs84
loc_time 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间 UNIX 时间戳 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
create_time 服务端接收到报警信息的时间 UNIX 时间戳 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
请求示例
https://yingyan.baidu.com/api/v3/fence/batchhistoryalarm?&service_id=127980&start_time=1489420800&end_time=1489424400&ak=<用户的AK>
返回示例
 
  {
      "status": 0,
      "total": 2000,
      "size": 500,
      "message": "成功",
      " alarms ": [
          {
              "fence_id": 1,
              "fence_name":"学校",
              "monitored_person":"小明",
              "action": "exit", 
              "alarm_point":{
               
                  "longitude":116.2333,
                  "latitude":43.892,
                  "radius":27,
                  "loc_time": 1419388604
                  "create_time": 1419388609
                },
              "pre_point":{
                  "longitude":116.2367,
                  "latitude":43.894,
                  "radius":28,
                  "loc_time": 1419388724
                  "create_time": 1419388729
                }                
          },
         {
              "fence_id": 1,
              "fence_name":" 学校",
              "monitored_person":"小明",
              "action": "enter", 
              "alarm_point":{           
                  "longitude":116.2333,
                  "latitude":43.892,
                  "radius":12,
                  "loc_time": 1419387405,
                  "create_time": 1419387405
                }, 
               "pre_point": {
                  "longitude":116.2367,
                  "latitude":43.894,
                  "radius":15,
                  "loc_time": 1419387465,
                  "create_time": 1419387465
                }           
          }
      ]
  
  }
  


服务端围栏报警信息推送
鹰眼服务端支持将报警推送至开发者的服务端、鹰眼SDK(了解报警推送至鹰眼SDK功能请前往Android鹰眼SDKiOS鹰眼SDK)。

若开发者要将围栏报警信息推送至开发者的服务端,需要开发者在自己的服务端实现自己的接收报警信息的HTTP服务,同时在轨迹管理台设置页面同步配置服务地址;百度鹰眼将通过该地址向开发者的服务端发送http请求,在请求中推送围栏报警信息。

 yingyan_guide_webmanager_alert.png
 
 
 

使用须知

鹰眼服务端将向开发者发送两类请求:

【地址校验请求】百度鹰眼在拿到开发者的URL的时候,需要对该URL做有效性校验,保证URL的可用性

【报警信息推送请求】百度鹰眼地址校验通过后,将通过该类请求向开发者推送围栏报警信息

配置地址完成后,鹰眼服务端将向开发者服务端发送地址校验请求,如成功后,将不再发送校验类请求,直到变更配置地址。

鹰眼服务端推送报警时,开发者返回信息接收是否成功。如果1s之内没有收到响应信息,则推送报警失败。若推送失败,将在后续的10分钟之内每隔60s推送一次,直至收到成功响应。若10分钟之后仍未成功,将不再推送,但报警记录将存储在鹰眼服务端。为避免因此造成报警漏接收,开发者可定期使用历史报警查询接口同步报警信息。

开发者接收报警信息后的响应信息请务必按照格式填写,且为JSON格式,服务方可正确设置成功。具体格式请参考本页面最下方示例。

给开发者的建议:开发者在接收到该类消息之后,使用异步方式做业务处理。即获取到消息内容之后,立即返回,而报警推送的业务处理则在另外的线程中处理。


开发者使用服务步骤

第一步:开发者搭建服务,使用http协议,构建服务端接收报警信息的URL

(请注意,该URL请求无需参数,URL中不可含有& ?等特殊字符)

客户服务端需要支持 Content-Type: application/json Content-Type: application/x-www-form-urlencoded

开发者接收报警信息的服务要求必须及时对鹰眼服务端发送的请求做出响应,如鹰眼服务端1s之内没有收到响应信息,则报警失败。

假设用户提供的URL为http://your.server.name:port/your/path

第二步:在轨迹管理台设置页面配置该URL
yingyan_trace_admin_service.png

配置成功后,鹰眼服务端立即向开发者发送校验URL请求:

1.校验请求:POST请求,仅配置地址完成后首次报警前发送该请求。

POST内容为JSON格式消息,{“type”:1, ”service_id”:2741}

校验成功后,当鹰眼服务端围栏触发报警时,将向此URL推送地理围栏报警信息。

2.报警推送请求:POST请求,围栏触发报警即发送该类请求

POST内容为JSON格式消息,{“type”:2, ”service_id”:2741, ”content”:[报警信息数组]}

接口说明

支持将鹰眼服务端地理围栏报警信息推送至开发者的服务端。

请求URI

开发者构建围栏报警请求URL,鹰眼将根据此URL向开发者服务端发送请求。

该URL需要同步在轨迹管理台配置页面配置,使鹰眼能够唯一识别对应service_id与开发者服务端地址。

HTTP请求方式

POST

数据格式

请求和返回均为JSON格式

公共请求头

参数名 参数含义 类型 备注
SignId

请求来源标记

string 允许的请求值:baidu_yingyan
用户可以通过获取这个标志来判断一个http请求是否来自百度鹰眼。
Content-Encoding

消息压缩标记

string 允许的请求值:gzip 或 空值
为减少请求量,提高网络传输速度,鹰眼可对请求内容做gzip压缩,此时请求头中将包含该字段。

用户在接收到该类型请求时,需要判断Content-Encoding是否为gzip压缩:如果Content-Encoding=gzip,需要对请求体进行解压缩,解压缩之后的内容即为报警推送消息;如果Content-Encoding为空,则无需进行解压缩。


请求体参数

参数名 参数含义 类型 备注
type 消息类型 int 取值1或者2

1:当type=1时,校验该URL为有效URL。此时,content为空或不存在。开发者无需对消息内容做任何处理,只需正常返回即可。

2:当type=2时,推送报警信息,开发者可取content中的内容做其他业务处理。

service_id service的唯一标识,当前报警信息所属的鹰眼服务ID int 在轨迹管理台创建鹰眼服务时,系统返回的 service_id
content 报警信息数组 array 当type为1时,content为空或不存在。

该字段为数组格式,数组的每个内容都是一个推送信息。

fence_id 围栏 id,唯一标识符 int 一条推送返回一个报警信息
fence_name 围栏的名称 string
monitored_person 监控对象 string 监控对象的entity_name
action 报警触发动作 string 可能的请求值:

enter:进入围栏

exit:离开围栏

alarm_point 触发围栏报警轨迹点
longitude 监控对象触发围栏时的经度 double
latitude 监控对象触发围栏时的纬度 double
radius 定位点的精度 int 单位:米
coord_type 坐标类型 string 国内为百度坐标系:bd09ll;国外均为 wgs84坐标系:wgs84
loc_time 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间 UNIX 时间戳 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
create_time 服务端接收到报警信息的时间 UNIX 时间戳 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。
pre_point 触发围栏报警轨迹点的上一个轨迹点
longitude 监控对象触发围栏时的经度 double
latitude 监控对象触发围栏时的纬度 double
radius 定位点的精度 int 单位:米
coord_type 坐标类型 string 国内为百度坐标系:bd09ll;国外均为wgs84坐标系:wgs84
loc_time 围栏实际触发时间,即触发围栏报警的轨迹点的定位时间 UNIX 时间戳 即使触发围栏的轨迹点未实时上传,由于轨迹点中携带了 loc_time,鹰眼仍能根据 loc_time判断围栏实际触发时间。
create_time 服务端接收到报警信息的时间 UNIX 时间戳 由于鹰眼 API 围栏为服务端围栏,即只有当轨迹点上传鹰眼服务端时,才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性,而晚于围栏实际触发时间 loc_time。例如,轨迹点实际触发围栏时间为13:00,但若由于各种原因,轨迹点上传至服务端进行围栏计算的时间为14:00,则该报警的 create_time为14:00。

公共返回头

参数名 参数含义 类型 备注
SignId 返回值:baidu_yingyan

请求来源标记。

string 根据该字段识别响应身份,若未返回该字段,则视为URL校验失败,不再对该URL发送推送数据。

返回体参数

参数名 参数含义 类型 备注
status 返回状态码 int 0或非0值
message 返回信息 string 对status的中文描述。

百度鹰眼不对响应内容做处理,只要http的状态码为200,则视为发送成功(返回非200的其他任何内容都视为该次调用失败)。此响应内容中的status不作为成功与否的标志,也不会根据此status的值做重试处理。

请求示例

以下是一个校验消息的完整请求示例:

完整请求示例
请求头
     "SignId": "baidu_yingyan"
 
请求体
   {
       "type":1,
       "service_id":2741
   }
 

以下是一个推送消息的完整请求示例:

完整请求示例
请求头
     "SignId": "baidu_yingyan"
     "Content-Encoding": "gzip"
 
请求体(解压缩之后)
     {
         "type":2,
         "service_id": 2741,
         "content":[
             {
                 "fence_id": 1,
                 "fence_name": "A_01",
                 "monitored_person": "A001",
                 "action": "enter",
                 "alarm_point": {
                     "longitude": 113.29251520916,
                     "latitude": 23.45610760748,
                     "radius": 3,
                     "coord_type" : "bd09ll",
                     "loc_time": 1490179579,
                     "create_time": 1490179593
                 },
                 "pre_point": {
                     "longitude": 113.20148113236,
                     "latitude": 23.431332045033,
                     "radius": 10,
                     "coord_type" : "bd09ll",
                     "loc_time": 1490179557,
                     "create_time": 1490179569
                 }
             }
         ]
     }
 

返回示例

完整返回示例
返回头
     "SignId": "baidu_yingyan"
 
返回体
   {
       "status":0,
       "message":"成功"
   }
 
  • 文档根本没法用

  • 文档水平很差

  • 文档水平一般

  • 文档不错

  • 文档写的很好

如发现文档错误,或对此文档有更好的建议,请在下方反馈。问题咨询请前往反馈平台提交工单咨询。

提交反馈

拖动标注工具

添加矩形标注

添加箭头标注

完成

取消