地理围栏报警
查询监控终端在围栏内或外
服务介绍
可以通过此请求，查询监控终端在围栏内或外。
接口地址
https://lbs.navinfo.com/open-api/geofence/v1/fence/query_status
请求方式
GET/POST
post请求参数需用x-www-form-urlencoded方式传输
请求参数
查询监控终端在围栏内或外说明请参见下表：
| 参数名 | 类型 | 含义 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
ak | string | 开发者密钥 | 是 | 你的ak | |
service_id | int | 创建服务时返回的服务ID | 是 | ||
monitored_terminal | string | 监控终端 | 是 | ||
fence_ids | string | 围栏实体的id列表，多个围栏ID用“,”分隔。 | 否 | 若填写，则按照指定的id全部返回围栏状态，此时page_index和page_size不生效；若不填，则查询监控对象上的所有围栏状态；fence_ids中最多填写1000个id。 | |
page_index | int | 返回页码数。 | 否 | 1 | 值域：[1,5000]。 |
page_size | int | 每页记录数。 | 否 | 1000 | 值域：[1,1000]。 |
响应数据
| 名称 | 类型 | 含义 | 备注 | ||
|---|---|---|---|---|---|
code | int | 结果状态码 | |||
message | string | 结果状态码描述 | |||
data | object | 返回结果 | |||
total | int | 查询监控terminal的总个数 | |||
size | int | 本页返回的terminal个数 | |||
monitored_statuses | array | 围栏状态列表 | |||
fence_id | int | 围栏id | |||
monitored_status | string | 状态 | unknown：未知状态 | ||
服务示例
查询坐标在围栏内或外
服务介绍
可以通过此请求，查询坐标在围栏内或外。
接口地址
https://lbs.navinfo.com/open-api/geofence/v1/fence/query_location_status
请求方式
GET/POST
post请求参数需用x-www-form-urlencoded方式传输
请求参数
查询坐标在围栏内或外说明请参见下表：
| 参数名 | 类型 | 含义 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
ak | string | 开发者密钥 | 是 | 你的ak | |
service_id | int | 创建服务时返回的服务ID | 是 | ||
monitored_terminal | string | 监控终端 | 是 | ||
fence_ids | string | 围栏实体的id列表，多个围栏ID用“,”分隔。 | 否 | 若填写，则按照指定的id全部返回围栏状态，此时page_index和page_size不生效；若不填，则查询监控对象上的所有围栏状态；fence_ids中最多填写1000个id。 | |
longitude | double | 指定监控对象所在坐标的经度 | 是 | ||
latitude | double | 指定监控对象所在坐标的纬度 | 是 | ||
coord_type | string | 坐标系 | 否 | gcj02 | |
page_index | int | 返回页码数。 | 否 | 1 | 值域：[1,5000]。 |
page_size | int | 每页记录数。 | 否 | 1000 | 值域：[1,1000]。 |
响应数据
| 名称 | 类型 | 含义 | 备注 | ||
|---|---|---|---|---|---|
code | int | 结果状态码 | |||
message | string | 结果状态码描述 | |||
data | object | 返回结果 | |||
total | int | 查询监控terminal的总个数 | |||
size | int | 本页返回的terminal个数 | |||
monitored_statuses | array | 围栏状态列表 | |||
fence_id | int | 围栏id | |||
monitored_status | string | 状态 | unknown：未知状态 | ||
服务示例
查询某监控终端的历史报警
服务介绍
可以通过此请求，查询某监控终端的历史报警。
接口地址
https://lbs.navinfo.com/open-api/geofence/v1/fence/terminal_history_alarm
请求方式
GET/POST
post请求参数需用x-www-form-urlencoded方式传输
请求参数
查询某监控终端的历史报警说明请参见下表：
| 参数名 | 类型 | 含义 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
ak | string | 开发者密钥 | 是 | 你的ak | |
service_id | int | 创建服务时返回的服务ID | 是 | ||
monitored_terminal | string | 监控终端 | 是 | ||
fence_ids | string | 围栏实体的id列表，多个围栏ID用“,”分隔。 | 否 | 若填写，则按照指定的id全部返回围栏状态，此时page_index和page_size不生效；若不填，则查询监控对象上的所有围栏状态；fence_ids中最多填写1000个id。 | |
start_time | UNIX秒时间戳 | 查询开始时间。 | 否 | 注意： | |
end_time | UNIX秒时间戳 | 查询结束时间。eg：162062641 | 否 | ||
coord_type | string | 坐标系 | 否 | gcj02 | |
page_index | int | 返回页码数。 | 否 | 1 | 值域：[1,5000]。 |
page_size | int | 每页记录数。 | 否 | 1000 | 值域：[1,1000]。 |
响应数据
| 名称 | 类型 | 含义 | 备注 | |||
|---|---|---|---|---|---|---|
code | int | 结果状态码 | ||||
message | string | 结果状态码描述 | ||||
data | object | 返回结果 | ||||
total | int | 查询监控terminal的总个数 | ||||
size | int | 本页返回的terminal个数 | ||||
alarms | array | 报警结果 | ||||
fence_id | int | 触发报警的围栏id | ||||
fence_name | string | 围栏名称 | ||||
monitord_terminal | string | 监控对象 | ||||
action | string | 触发动作 | 可能的返回值: | |||
alarm_point | object | 触发围栏报警轨迹点 | ||||
longitude | double | 轨迹点经度 | ||||
latitude | double | 轨迹点纬度 | ||||
radius | string | 定位精度 | 单位:米 | |||
coord_type | string | 返回的坐标类型 | ||||
loc_time | UNIX 秒时间戳 | 围栏实际触发时间,即轨迹点定位时间 | ||||
create_time | UNIX 秒时间戳 | 服务端接收到报警信息的时间 | 由于LBS API 围栏为服务端围栏，即只有当轨迹点上传LBS服务端时，才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性，而晚于围栏实际触发时间 loc_time。例如，轨迹点实际触发围栏时间为13:00，但若由于各种原因，轨迹点上传至服务端进行围栏计算的时间为14:00，则该报警的 create_time为14:00。 | |||
pre_point | object | 触发围栏报警轨迹点的上一个轨迹点 | ||||
longitude | double | 轨迹点经度 | ||||
latitude | double | 轨迹点纬度 | ||||
radius | int | 定位精度 | 单位:米 | |||
coord_type | string | 返回的坐标类型 | ||||
loc_time | UNIX 秒时间戳 | 围栏实际触发时间,即轨迹点定位时间。 | ||||
create_time | UNIX 秒时间戳 | 服务端接收到报警信息的时间 | ||||
服务示例
查询某服务下时间段以内所有报警信息
服务介绍
可以通过此请求，查询某服务下时间段以内所有报警信息。
接口地址
https://lbs.navinfo.com/open-api/geofence/v1/fence/service_history_alarm
请求方式
GET/POST
post请求参数需用x-www-form-urlencoded方式传输
请求参数
查询某服务下时间段以内所有报警信息说明请参见下表：
| 参数名 | 类型 | 含义 | 是否必填 | 默认值 | 备注 |
|---|---|---|---|---|---|
ak | string | 开发者密钥 | 是 | 你的ak | |
service_id | int | 创建服务时返回的服务ID | 是 | ||
start_time | UNIX秒时间戳 | 开始时间 | 是 | 查询的时间是服务端接收到报警的时间，即报警信息的 create_time。例如，轨迹点实际触发围栏时间为13:00，但若由于各种原因，轨迹点上传至服务端进行围栏计算的时间为14:00，则该报警的 create_time为14:00。eg：162062641 | |
end_time | UNIX秒时间戳 | 查询结束时间。 | 是 | 结束时间需大于开始时间，但不可超过1小时。即每次请求，最多只能同步1个小时时长的报警信息。eg：162062641 | |
coord_type_output | string | 返回坐标类型 | 否 | gcj02 | |
page_index | int | 返回页码数。 | 否 | 1 | 值域：[1,5000]。 |
page_size | int | 每页记录数。 | 否 | 1000 | 值域：[1,1000]。 |
响应数据
| 名称 | 类型 | 含义 | 备注 | |||
|---|---|---|---|---|---|---|
code | int | 结果状态码 | ||||
message | string | 结果状态码描述 | ||||
data | object | 返回结果 | ||||
total | int | 查询监控terminal的总个数 | ||||
size | int | 本页返回的terminal个数 | ||||
alarms | array | 报警结果 | ||||
fence_id | int | 触发报警的围栏id | ||||
fence_name | string | 围栏名称 | ||||
monitord_terminal | string | 监控对象 | ||||
action | string | 触发动作 | 可能的返回值: | |||
alarm_point | object | 触发围栏报警轨迹点 | ||||
longitude | double | 轨迹点经度 | ||||
latitude | double | 轨迹点纬度 | ||||
radius | string | 定位精度 | 单位:米 | |||
coord_type | string | 返回的坐标类型 | ||||
loc_time | UNIX 秒时间戳 | 围栏实际触发时间,即轨迹点定位时间 | ||||
create_time | UNIX 秒时间戳 | 服务端接收到报警信息的时间 | 由于LBS API 围栏为服务端围栏，即只有当轨迹点上传LBS服务端时，才能进行围栏触发判断。因此服务端接收到报警的时间可能由于轨迹点上传的不及时性，而晚于围栏实际触发时间 loc_time。例如，轨迹点实际触发围栏时间为13:00，但若由于各种原因，轨迹点上传至服务端进行围栏计算的时间为14:00，则该报警的 create_time为14:00。 | |||
pre_point | object | 触发围栏报警轨迹点的上一个轨迹点 | ||||
longitude | double | 轨迹点经度 | ||||
latitude | double | 轨迹点纬度 | ||||
radius | int | 定位精度 | 单位:米 | |||
coord_type | string | 返回的坐标类型 | ||||
loc_time | UNIX 秒时间戳 | 围栏实际触发时间,即轨迹点定位时间 | ||||
create_time | UNIX 秒时间戳 | 服务端接收到报警信息的时间 | ||||
服务示例