您现在的位置:

地理围栏管理

创建圆形围栏

服务介绍

可以通过此请求,创建圆形围栏。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/create_circle_fence

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

创建圆形围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

latitude

string

圆形围栏纬度

longitude

string

圆形围栏经度

radius

string

圆形围栏半径

单位:米,取值范围(0,5000]

coord_type

string

坐标类型

gcj02

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

0

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

1

取值规则:
0:表示禁用;
1:表示使用。

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

fence_id

string

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏的唯一标识

最新的围栏名称

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

latitude

string

圆形围栏纬度

longitude

string

圆形围栏经度

radius

string

圆形围栏半径

单位:米,取值范围(0,5000]

coord_type

string

坐标类型

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

创建多边形围栏

服务介绍

可以通过此请求,创建多边形围栏。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/create_polygon_fence

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

创建多边形围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

vertexes

string

多边形围栏形状点

规则:经度在前,纬度在后,用“,”分隔;每组经纬度用“;”分隔;顶点顺序可按顺时针或逆时针排列。
注意:坐标点个数取值范围:[3,100],外接矩形面积<1000平方公里。

coord_type

string

坐标类型

gcj02

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

0

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

1

取值规则:
0:表示禁用;
1:表示使用。

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

fence_id

string

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏的唯一标识

最新的围栏名称

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

vertexes

string

多边形围栏形状点

规则:经度在前,纬度在后,用“,”分隔;每组经纬度用“;”分隔;顶点顺序可按顺时针或逆时针排列。
注意:坐标点个数取值范围:[3,100],外接矩形面积<1000平方公里。

coord_type

string

坐标类型

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

创建线性围栏

服务介绍

可以通过此请求,创建线性围栏。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/create_polyline_fence

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

创建多边形围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

vertexes

string

线型围栏坐标点

规则:经度在前,纬度在后,用“,”分隔;每组经纬度用“;”分隔;顶点顺序可按顺时针或逆时针排列。
注意:线路总长度<500KM,坐标点个数取值范围 [2,100]。

offset

int

偏离距离,值域:[0,200]。

若偏离折现距离超过该距离即报警

coord_type

string

坐标类型

gcj02

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

0

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

1

取值规则:
0:表示禁用;
1:表示使用。

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

fence_id

string

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏的唯一标识

最新的围栏名称

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

vertexes

string

线型围栏坐标点

规则:经度在前,纬度在后,用“,”分隔;每组经纬度用“;”分隔;顶点顺序可按顺时针或逆时针排列。
注意:线路总长度<500KM,坐标点个数取值范围 [2,100]。

offset

int

偏离距离,值域:[0,200]。

若偏离折线距离超过该距离即报警。

coord_type

string

坐标类型

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

创建行政区围栏

服务介绍

可以通过此请求,创建行政区围栏。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/create_district_fence

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

创建行政区围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

keyword

string

行政区关键字,支持省,市,区/县名称。

注意:
若输入的行政区名称匹配多个行政区,围栏将创建失败。
不支持组合行政区搜索。示例:北京市/湖南省/雨花区。

coord_type

string

坐标类型

gcj02

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

0

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

1

取值规则:
0:表示禁用;
1:表示使用。

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

fence_id

string

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏的唯一标识

最新的围栏名称

district

string

结构化的行政区划描述

围栏创建成功时返回该字段

district_list

array

关键字匹配到多个行政区时返回的行政区列表

围栏创建失败时返回该字段

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

keyword

string

行政区关键字,支持省,市,区/县名称。

注意:
若输入的行政区名称匹配多个行政区,围栏将创建失败。
不支持组合行政区搜索。示例:北京市/湖南省/雨花区。

coord_type

string

坐标类型

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

导入围栏

服务介绍

可以通过此请求,在一个接口里批量导入圆形,多边形,线形,行政区地理围栏。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/import

请求方式

POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

导入围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

coord_type

string

坐标类型

gcj02

wgs84: GPS坐标
gcj02: 国测局加密坐标

circle_fences

array

圆形围栏参数

null

latitude

string

圆形围栏纬度

longitude

string

圆形围栏经度

radius

string

圆形围栏半径

单位:米,取值范围(0,5000]

fence_name

string

围栏名称

denoise

int

围栏去噪参数

0

polygon_fences

array

多边形围栏参数

null

vertexes

string

多边形围栏形状点

规则:经度在前,纬度在后,用“,”分隔;每组经纬度用“;”分隔;顶点顺序可按顺时针或逆时针排列。
注意:坐标点个数取值范围:[3,100],外接矩形面积<1000平方公里。

fence_name

string

围栏名称

denoise

int

围栏去噪参数。

0

polyline_fences

array

线形围栏参数

null

offset

int

偏离距离

若偏离折现距离超过该距离即报警

vertexes

string

线性围栏形状点

规则:经度在前,纬度在后,用“,”分隔;每组经纬度用“;”分隔;顶点顺序可按顺时针或逆时针排列。
注意:线路总长度<500KM,坐标点个数取值范围 [2,100]。

fence_name

string

围栏名称

denoise

int

围栏去噪参数。

0

district_fences

array

行政区围栏参数

null

keyword

string

行政区关键字,支持省,市,区/县名称。

注意:
若输入的行政区名称匹配多个行政区,围栏将创建失败。
不支持组合行政区搜索。示例:北京市/湖南省/雨花区。

fence_name

string

围栏名称

denoise

int

围栏去噪参数。

0

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

success_num

int

成功导入的围栏个数

circle_fences

array

导入圆形围栏返回结果

fence_id

int

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏名称

导入时传入的围栏名称

polygon_fences

array

导入多边形围栏返回结果

fence_id

int

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏名称

导入时传入的围栏名称

polyline_fences

array

导入线形围栏返回结果

fence_id

int

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏名称

导入时传入的围栏名称

district_fences

array

导入行政区围栏返回结果

fence_id

int

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏名称

导入时传入的围栏名称

district

string

结构化的行政区划描述

围栏创建成功时返回该字段

district_list

array

关键字匹配到多个行政区时返回的行政区列表

围栏创建失败时返回该字段

参数示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

导出围栏

服务介绍

可以通过此请求,在一个接口里批量导出圆形,多边形,线形,行政区地理围栏的信息。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/export

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

导入围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

coord_type

string

坐标类型

gcj02

gcj02: 国测局加密坐标

fence_type

string

围栏类型

0

0:表示全部;
1:表示圆形地理围栏;
2:表示多边形地理围栏;
3:表示线性地理围栏;
4:表示行政区地理围栏。

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

coord_type

string

坐标类型

data

object

返回结果

circle_fences

array

圆形围栏参数

fence_name

string

围栏名称

denoise

int

围栏去噪参数

longitude

string

圆形围栏经度

latitude

string

圆形围栏纬度

raduis

int

圆形围栏半径

polygon_fences

array

多边形围栏参数

fence_name

string

围栏名称

denoise

int

围栏去噪参数

vertexes

string

多边形围栏形状点

polyline_fences

array

线形围栏参数

fence_name

string

围栏名称

denoise

int

围栏去噪参数

vertexes

string

线型围栏坐标点

offset

int

偏离距离

district_fences

array

行政区围栏参数

fence_name

string

围栏名称

denoise

int

围栏去噪参数

keyword

string

行政区关键字

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

coord_type

string

坐标类型

fence_type

string

围栏类型

0:表示全部;
1:表示圆形地理围栏;
2:表示多边形地理围栏;
3:表示线性地理围栏;
4:表示行政区地理围栏。

更新圆形围栏

服务介绍

可以通过此请求,更新圆形围栏。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/update_circle_fence

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

更新圆形围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识,用于指定更新的围栏id。不可更新。

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

latitude

string

中心点纬度

注意:更新圆形围栏中心点坐标时经纬度需组合录入

longitude

string

中心点经度

注意:更新圆形围栏中心点坐标时经纬度需组合录入

radius

string

圆形围栏半径

单位:米,取值范围(0,5000]

coord_type

string

坐标类型

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200]。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

fence_id

int

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏的唯一标识

最新的围栏名称

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识,用于指定更新的围栏id。不可更新。

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

latitude

string

中心点经度

注意:更新圆形围栏中心点坐标时经纬度需组合录入。

longitude

string

中心点纬度

注意:更新圆形围栏中心点坐标时经纬度需组合录入。

radius

string

圆形围栏半径

单位:米,取值范围(0,5000]

coord_type

string

坐标类型

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

更新多边形围栏

服务介绍

可以通过此请求,更新多边形围栏。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/update_polygon_fence

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

更新多边形围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识,用于指定更新的围栏id。不可更新。

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

vertexes

string

多边形围栏形状点

规则:经度在前,纬度在后,用“,”分隔;每组经纬度用“;”分隔;顶点顺序可按顺时针或逆时针排列。
注意:坐标点个数取值范围:[3,100],外接矩形面积<1000平方公里。

coord_type

string

坐标类型

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200]。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

fence_id

int

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏的唯一标识

最新的围栏名称

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识,用于指定更新的围栏id。不可更新。

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

vertexes

string

多边形围栏形状点

规则:经度在前,纬度在后,用“,”分隔;每组经纬度用“;”分隔;顶点顺序可按顺时针或逆时针排列。
注意:坐标点个数取值范围:[3,100],外接矩形面积<1000平方公里。

coord_type

string

坐标类型

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

更新线性围栏

服务介绍

可以通过此请求,更新线性围栏。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/update_polyline_fence

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

创建多边形围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识,用于指定更新的围栏id。不可更新。

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

vertexes

string

线型围栏坐标点

规则:经度在前,纬度在后,用“,”分隔;每组经纬度用“;”分隔;顶点顺序可按顺时针或逆时针排列。
注意:线路总长度<500KM,坐标点个数取值范围 [2,100]。

offset

int

偏离距离,值域:[0,200]。

若偏离折现距离超过该距离即报警

coord_type

string

坐标类型

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200]。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

fence_id

int

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏的唯一标识

最新的围栏名称

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识,用于指定更新的围栏id。不可更新。

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

vertexes

string

线型围栏坐标点

规则:经度在前,纬度在后,用“,”分隔;每组经纬度用“;”分隔;顶点顺序可按顺时针或逆时针排列。
注意:线路总长度<500KM,坐标点个数取值范围 [2,100]。

offset

int

偏离距离,值域:[0,200]。

若偏离折线距离超过该距离即报警。

coord_type

string

坐标类型

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

更新行政区围栏

服务介绍

可以通过此请求,创建行政区围栏。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/update_district_fence

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

更新行政区围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识,用于指定更新的围栏id。不可更新。

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

keyword

string

行政区关键字,支持省,市,区/县名称。

注意:
若输入的行政区名称匹配多个行政区,围栏将创建失败。
不支持组合行政区搜索。示例:北京市/湖南省/雨花区。

coord_type

string

坐标类型

gcj02

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200]。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

fence_id

int

围栏的唯一标识

fence_id由系统自动生成,按正整数递增

fence_name

string

围栏的唯一标识

最新的围栏名称

district

string

结构化的行政区划描述

围栏创建成功时返回该字段

district_list

array

关键字匹配到多个行政区时返回的行政区列表

围栏创建失败时返回该字段

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识,用于指定更新的围栏id。不可更新。

fence_name

string

围栏名称

monitored_terminal

string

围栏监控对象

使用说明:
1.私有围栏,(一个terminal最多创建100个私有围栏,service总私有围栏个数无限制)监控一个terminal。
规则:monitored_terminal=HuaweiMate10
2.公共围栏(单个服务下公共围栏个数总数不能超过1000个),监控指定service_id下所有terminal。
规则:monitored_terminal= {allterminal}

keyword

string

行政区关键字,支持省,市,区/县名称。

注意:
若输入的行政区名称匹配多个行政区,围栏将创建失败。
不支持组合行政区搜索。示例:北京市/湖南省/雨花区。

coord_type

string

坐标类型

wgs84: GPS坐标
gcj02: 国测局加密坐标

denoise

int

单位:米。值域为[0,200],默认值为0,不去噪。

每个轨迹点都有一个定位误差半径radius,这个值越大,代表定位越不准确,可能是噪点。围栏计算时,如果噪点也参与计算,会造成误报的情况。设置denoise可控制,当轨迹点的定位误差半径大于设置值时,就会把该轨迹点当做噪点,不参与围栏计算。

fence_status

int

围栏使用状态。

取值规则:
0:表示禁用;
1:表示使用。

删除围栏

服务介绍

可以通过此请求,删除围栏。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/delete

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

删除围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_ids

string

支持批量删除围栏,多个围栏ID用“,”分隔。最多支持一次性删除1000个围栏。注意:fence_ids与monitored_terminal至少传入其一。

monitored_terminal

string

围栏监控对象

1、仅填写monitored_terminal字段:根据监控对象删除围栏,仅适用于删除“指定terminal创建的围栏”,并删除该terminal上的所有围栏
2、仅填写fence_ids字段:根据围栏id删除;
3、二字段均填写:根据该监控对象上的指定围栏删除

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

fence_ids

array

围栏id列表

返回删除成功的围栏id列表

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_ids

string

支持批量删除围栏,多个围栏ID用“,”分隔;最多支持一次性删除1000个围栏。注意:fence_ids与monitored_terminal至少传入其一。

monitored_terminal

string

围栏监控对象

1、仅填写monitored_terminal字段:根据监控对象删除围栏,仅适用于删除“指定terminal创建的围栏”,并删除该terminal上的所有围栏
2、仅填写fence_ids字段:根据围栏id删除;
3、二字段均填写:根据该监控对象上的指定围栏删除

查询围栏信息

服务介绍

可以通过此请求,查询围栏信息。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/query

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

查询围栏说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_ids

int

支持批量查询围栏,多个围栏ID用“,”分隔;最多支持一次性删除1000个围栏。注意:fence_ids与monitored_terminal至少传入其一。

是/否

monitored_terminal

string

围栏监控对象

是/否

仅填写monitored_terminal字段:根据监控对象查询围栏,支持3种查询方式:
1)输入某个terminal_name查询该监控对象上的所有围栏;
2)输入{allterminal},查询监控全部terminal的公共围栏;
3)输入{partofterminal},查询监控部分terminal(除{allterminal}外其他的)的公共围栏。
2、仅填写fence_ids字段:则根据围栏id查询,此时page_size和page_index不生效。
3、二字段均填写:根据该监控对象上的指定围栏查询

coord_type_output

string

输出坐标类型

gcj02:国测局经纬度

page_index

int

返回页码数。

1

值域:[1,5000]。

page_size

int

每页记录数。

100

值域:[1,1000]。

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

total

int

总的查询结果数量

size

int

本页返回的结果数量

fences

array

围栏列表

fence_id

int

围栏唯一标识

fence_name

string

围栏名称

fence_status

int

围栏使用状态。

围栏状态:
0:表示禁用;
1:表示使用。

monitored_terminal

string

围栏的监控对象

1. 该围栏仅监控一个terminal时,返回terminal_name
2. 该围栏监控service下的所有terminal时,返回:{allterminal}
3. 该围栏监控service下的部分terminal时,返回:{partofterminal}

shape

string

围栏形状

围栏的四种形状:
circle:圆形
polygon:多边形
polyline:线型
district:行政区划

longitude

double

经度

shape=circle时返回

latitude

double

纬度

shape=circle时返回

radius

double

半径

shape=circle时返回,
单位米

vertexes

string

多边形和线形围栏的顶点列表

shape=polygon或shape=polyline时返回。示例:"40.020664,116.351592;40.02083,116.358779;40.018178,116.35885;40.01757,116.350586"

offset

double

偏移距离

仅在shape=polyline时返回偏移距离(若偏离折线距离超过该距离即报警),
单位:米。

coord_type

string

返回的坐标类型

denoise

int

围栏去燥参数

单位:米

district

string

行政区划描述

shape=district时返回。

create_time

string

围栏创建时间

格式化时间。
示例: 2020-02-20 05:16:39

modify_time

string

围栏修改时间

格式化时间。
示例: 2020-02-20 05:16:39

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_ids

string

支持批量查询围栏,多个围栏ID用“,”分隔;最多支持一次性删除1000个围栏。注意:fence_ids与monitored_terminal至少传入其一。

是/否

monitored_terminal

string

围栏监控对象

是/否

仅填写monitored_terminal字段:根据监控对象查询围栏,支持3种查询方式:
1)输入某个terminal_name查询该监控对象上的所有围栏;
2)输入{allterminal},查询监控全部terminal的公共围栏;
3)输入{partofterminal},查询监控部分terminal(除{allterminal}外其他的)的公共围栏。
2、仅填写fence_ids字段:则根据围栏id查询,此时page_size和page_index不生效。
3、二字段均填写:根据该监控对象上的指定围栏查询

coord_type_output

string

输出坐标类型

gcj02:国测局经纬度

page_index

int

返回页码数

值域:[1,5000]

page_size

int

每页记录数

值域:[1,1000]

增加围栏监控的终端

服务介绍

可以通过此请求,增加围栏监控的终端。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/add_monitored_terminal

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

增加围栏监控的终端说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识,用于指定更新的围栏id。不可更新。

monitored_terminal

string

围栏监控对象

支持同时向围栏添加多个terminal,多个terminal_name使用“,”分隔;
每次添加terminal上限为100个
示例:monitored_terminal=terminal_name1,terminal_name2,terminal_name3

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识。

monitored_terminal

string

轨迹服务中的terminal_name。

支持同时向围栏添加多个terminal,多个terminal_name使用“,”分隔;
每次添加terminal上限为100个
示例:monitored_terminal=terminal_name1,terminal_name2,terminal_name3

删除围栏可监控的终端

服务介绍

可以通过此请求,删除围栏可监控的终端。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/delete_monitored_terminal

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

删除围栏可监控的终端说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识。

monitored_terminal

string

围栏监控对象

支持通过terminal列表向围栏删除terminal。
1、支持批量删除:每次删除terminal上限为100个,多个terminal_name使用“,”分隔。
示例:monitored_terminal=terminal_name1,terminal_name2,terminal_name3。
2、删除围栏所有监控对象:{clearterminal}
示例:monitored_terminal={clearterminal}

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识。

monitored_terminal

string

轨迹服务中的terminal_name。

支持通过terminal列表向围栏删除terminal。
1、支持批量删除:每次删除terminal上限为100个,多个terminal_name使用“,”分隔。
示例:monitored_terminal=terminal_name1,terminal_name2,terminal_name3。
2、删除围栏所有监控对象:{clearterminal}
示例:monitored_terminal={clearterminal}

查询围栏监控的所有终端

服务介绍

可以通过此请求,查询围栏监控的所有终端。

接口地址

https://lbs.navinfo.com/open-api/geofence/v1/fence/query_monitored_terminal

请求方式

GET/POST
post请求参数需用x-www-form-urlencoded方式传输

请求参数

查询围栏监控的所有终端说明请参见下表:

参数名类型含义是否必填默认值备注

ak

string

开发者密钥

你的ak

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识。

page_index

int

返回页码数。

1

值域:[1,5000]。

page_size

int

每页记录数。

100

值域:[1,1000]。

响应数据

名称类型含义备注

code

int

结果状态码

message

string

结果状态码描述

data

object

返回结果

total

int

查询监控terminal的总个数

size

int

本页返回的terminal个数

monitored_terminal

array

terminal列表

服务示例

参数名 类型 含义 是否必填 备注

ak

你的ak

string

开发者密钥

点击申请

service_id

int

创建服务时返回的服务ID

fence_id

int

围栏的唯一标识。

page_index

int

返回页码数。

值域:[1,5000]。

page_size

int

每页记录数。

值域:[1,1000]。

返回顶部