您现在的位置: 开发 > 猎鹰轨迹服务 > 开发指南 > API文档 > 围栏关系判断

围栏关系判断 最后更新时间: 2021年01月22日

简介

通过以下服务开发者可以轻松检测和判断特定终端或指定坐标与某个围栏的关系,根据此关系判断可以搭建业务预警机制等。

接口列表

接口名称

功能说明

v1/track/geofence/status/terminal

查询检测对象与围栏关系

v1/track/geofence/status/location

查询指定坐标与围栏关系

查询检测对象与围栏关系

  • 服务地址

URL

https://tsapi.amap.com/v1/track/geofence/status/terminal

请求方式

GET

  • 请求参数

参数名

含义

规则

是否必填

key

高德Key

用户在高德地图官网申请Web服务API类型Key

必填

sid

服务唯一编号

sid为终端所属service唯一编号

必填

tid

监控对象终端id

每次只能输入1个

必填

gfids

围栏的唯一标识

支持一次传入多个,以","分割;

单次最多支持100个,如超出将只截取前100个作为输入。

否;

如传入,则只判断该监控对象与 gfids 所指定的围栏的关系,不分页(忽略 page 和 pagesize 参数);

如不传,则判断该监控对象与所有绑定围栏的关系(分页返回);

page

查询页数

默认1

可选,默认1

pagesize

每页数量

单页数据数量,取值 [1, 100]

可选,默认50

  • 返回参数

参数名

含义

备注

errcode

返回状态码

0代表成功,其他参考错误码说明

errmsg

返回状态描述

参考错误码说明

data




count

数据总数量


results




gfid

地理围栏id


gfname

地理围栏名称


in

检测对象是否在围栏中

1:在,0:不在;

如果监控对象无位置信息,此字段填充为0

location

检测对象当前位置

如果监控对象无位置信息,此字段不返回

time

检测对象位置更新时间

如果监控对象无位置信息,此字段不返回

查询指定坐标与围栏关系

  • 服务地址

URL

https://tsapi.amap.com/v1/track/geofence/status/location

请求方式

GET

  • 请求参数

参数名

含义

规则

是否必填

key

高德Key

用户在高德地图官网申请Web服务API类型Key

必填

sid

服务唯一编号

sid为终端所属service唯一编号

必填

location

指定坐标

格式:x,y

必填

gfids

围栏的唯一标识

支持一次传入多个,以","分割;

单次最多支持100个,如超出将只截取前100个作为输入。

否;

如传入,则只判断该坐标与 gfids 所指定的围栏的关系,不分页(忽略 page 和 pagesize 参数);

如不传,则判断该坐标与sid下的所有围栏的关系(分页返回);

page

查询页数

默认1

可选,默认1

pagesize

每页数量

单页数据数量,取值 [1, 100]

可选,默认50

  • 返回参数

参数名

含义

备注

errcode

返回状态码

0代表成功,其他参考错误码说明

errmsg

返回状态描述

参考错误码说明

data




count

数据总数量


results




gfid

地理围栏id


gfname

地理围栏名称


in

指定坐标是否在围栏中

1:在,

0:不在;


新用户
福利
示例
中心
常见
问题
智能
客服