查询单条路线信息,包含分支路线

简要描述：

查询单条路线具体信息,包含分支路线

接口版本：

版本号	制定人	制定日期	修订日期
1.0.0	lenny	2022-09-22	2020-09-22

请求URL:

国际客户：https://icloud.assetscontrols.com:3443/OpenApi/Admin
国内客户：https://cloud.assetscontrols.com:3443/OpenApi/Admin

请求方式：

POST
请求头：

参数名	是否必须	类型	说明
Content-Type	是	string	请求类型： application/json

请求参数:

参数名	是否必须	类型	说明
FTokenID	是	string	令牌ID
FAction	是	string	方法名 (QueryAllRoutePlanByFGUID )
FGUID	是	string	路线唯一标识

返回示例:

正确时返回:

{
    "Result": 200,
    "Message": "check token success",
    "FObject": {
        "Table": [
            {
                "FGUID": "1e8ea88a-60f3-42bc-8176-37c676b677d8",
                "FName": "李孝祯测试001",
                "FCode": "001",
                "FStartFence": "dfd0d889-7a01-4cd4-b8ed-88825c5fb72b",
                "FStartFenceName": "海谷科技大厦",
                "FStartFormType": 2,
                "FStartTypeName": "李孝祯测试",
                "FStartPath": "[]",
                "FStartRadius": 500.0,
                "FStartCenterLon": 113.92131186,
                "FStartCenterLat": 22.67073578,
                "FEndFence": "a156ffcf-9285-4756-95f1-0cb830fdae2a",
                "FEndFenceName": "龙海家园",
                "FEndFormType": 1,
                "FEndTypeName": "李孝祯测试",
                "FEndPath": "[{\"lat\":22.54519516,\"lng\":113.89590926},{\"lat\":22.53213027,\"lng\":113.89155722},{\"lat\":22.53244843,\"lng\":113.9106911},{\"lat\":22.54478113,\"lng\":113.90775015}]",
                "FEndRadius": 0.0,
                "FEndCenterLon": 113.90137618,
                "FEndCenterLat": 22.53813873,
                "FRoadPoints": "[{\"lat\":22.67123239,\"lng\":113.92147994},{\"lat\":22.67109185,\"lng\":113.92189991},{\"lat\":22.67097135,\"lng\":113.92223909},{\"lat\":22.67084065,\"lng\":113.92266904},{\"lat\":22.67073004,\"lng\":113.92301921}},{\"lat\":22.5381929,\"lng\":113.90218871}]",
                "FRemark": "",
                "FIsMainRoute": 1,
                "FRoutePassInfo": [
                    {
                        "FRouteGUID": "1e8ea88a-60f3-42bc-8176-37c676b677d8",
                        "FPassFenceGUID": "6c19e0c2-b36c-48d3-a1be-cba35f0dcc35",
                        "FName": "AEE",
                        "FArea": 785000.0,
                        "FFormType": 2,
                        "FTypeName": "李孝祯测试",
                        "FPath": "[]",
                        "FRadius": 500.0,
                        "FCenterLon": 113.91507376,
                        "FCenterLat": 22.65319852,
                        "FIndex": 1
                    }
                ]
            }
        ],
        "Table2": [
            {
                "FGUID": "f22a64b3-35fa-401a-b46d-12dea683326f",
                "FName": "李孝帧测试003",
                "FCode": "20250728003",
                "FStartFence": "dfd0d889-7a01-4cd4-b8ed-88825c5fb72b",
                "FStartFenceName": "海谷科技大厦",
                "FStartFormType": 2,
                "FStartTypeName": "李孝祯测试",
                "FStartPath": "[]",
                "FStartRadius": 500.0,
                "FStartCenterLon": 113.92131186,
                "FStartCenterLat": 22.67073578,
                "FEndFence": "a156ffcf-9285-4756-95f1-0cb830fdae2a",
                "FEndFenceName": "龙海家园",
                "FEndFormType": 1,
                "FEndTypeName": "李孝祯测试",
                "FEndPath": "[{\"lat\":22.54519516,\"lng\":113.89590926},{\"lat\":22.53213027,\"lng\":113.89155722},{\"lat\":22.53244843,\"lng\":113.9106911},{\"lat\":22.54478113,\"lng\":113.90775015}]",
                "FEndRadius": 0.0,
                "FEndCenterLon": 113.90137618,
                "FEndCenterLat": 22.53813873,
                "FRoadPoints": "[{\"lat\":22.67053234,\"lng\":113.92123008},{\"lat\":22.67044206,\"lng\":113.92149997},{\"lat\":22.67027167,\"lng\":113.92194974},{\"lat\":22.67023145,\"lng\":113.92214964},{\"lat\":22.67023145,\"lng\":113.92214964}}]",
                "FRemark": "test",
                "FIsMainRoute": 0,
                "FRoutePassInfo": [
                    {
                        "FRouteGUID": "f22a64b3-35fa-401a-b46d-12dea683326f",
                        "FPassFenceGUID": "cd599f34-a408-4c20-8aab-6a9f246afc6d",
                        "FName": "光明城站",
                        "FArea": 8998000.0,
                        "FFormType": 1,
                        "FTypeName": "运输路线",
                        "FPath": "[{\"lat\":22.74129463,\"lng\":113.95127929},{\"lat\":22.7344746,\"lng\":113.94214189},{\"lat\":22.72191399,\"lng\":113.93294184},{\"lat\":22.71563635,\"lng\":113.95853057},{\"lat\":22.7350435,\"lng\":113.98881357}]",
                        "FRadius": 0.0,
                        "FCenterLon": 113.95822878,
                        "FCenterLat": 22.7290518,
                        "FIndex": 1
                    }
                ]
            },
            {
                "FGUID": "2c84ac97-1568-4384-925b-fa2f54ca3dde",
                "FName": "李孝祯测试004",
                "FCode": "20250729181624",
                "FStartFence": "dfd0d889-7a01-4cd4-b8ed-88825c5fb72b",
                "FStartFenceName": "海谷科技大厦",
                "FStartFormType": 2,
                "FStartTypeName": "李孝祯测试",
                "FStartPath": "[]",
                "FStartRadius": 500.0,
                "FStartCenterLon": 113.92131186,
                "FStartCenterLat": 22.67073578,
                "FEndFence": "a156ffcf-9285-4756-95f1-0cb830fdae2a",
                "FEndFenceName": "龙海家园",
                "FEndFormType": 1,
                "FEndTypeName": "李孝祯测试",
                "FEndPath": "[{\"lat\":22.54519516,\"lng\":113.89590926},{\"lat\":22.53213027,\"lng\":113.89155722},{\"lat\":22.53244843,\"lng\":113.9106911},{\"lat\":22.54478113,\"lng\":113.90775015}]",
                "FEndRadius": 0.0,
                "FEndCenterLon": 113.90137618,
                "FEndCenterLat": 22.53813873,
                "FRoadPoints": "[{\"lat\":22.67053234,\"lng\":113.92123008},{\"lat\":22.67044206,\"lng\":113.92149997},{\"lat\":22.67027167,\"lng\":113.92194974},{\"lat\":22.67023145,\"lng\":113.92214964},{\"lat\":22.67023145,\"lng\":113.92214964}}]",
                "FRemark": "",
                "FIsMainRoute": 0,
                "FRoutePassInfo": [
                    {
                        "FRouteGUID": "2c84ac97-1568-4384-925b-fa2f54ca3dde",
                        "FPassFenceGUID": "f7500fc4-1c24-426f-9459-86d99c698ed5",
                        "FName": "深港花卉",
                        "FArea": 3330000.0,
                        "FFormType": 1,
                        "FTypeName": "运输路线",
                        "FPath": "[{\"lat\":22.61231688,\"lng\":113.9326152},{\"lat\":22.61206188,\"lng\":113.92250332},{\"lat\":22.59246153,\"lng\":113.92435955},{\"lat\":22.59231458,\"lng\":113.94366762}]",
                        "FRadius": 0.0,
                        "FCenterLon": 113.93113228,
                        "FCenterLat": 22.6013057,
                        "FIndex": 1
                    }
                ]
            }
        ]
    }
}

错误时返回:

//表示传入的公司的唯一标识为空，应该是数据格式不对
{
    "Result": 102,
    "Message": "FParam is null",
    "FObject": []
}
//表示token过期异常报错
{
    "Result": 104,
    "Message": "token error or timeout",
    "FObject": []
}
//表示有异常报错
{
    "Result": 105,
    "Message": "fail",
    "FObject": null
}

返回参数Table说明:

参数名	类型	说明
FAgentGUID	String	公司唯一标识
FGUID	String	路线唯一标识
FName	String	路线名称
FCode	String	路线名称
FStartFence	String	开始围栏唯一标识
FStartFenceName	String	开始围栏名称
FStartFormType	int	开始围栏类型 1：多边形 2：圆形
FStartTypeName	String	开始围栏类型名称
FStartPath	String	开始围栏点集合，Json字符串
FStartRadius	double	开始围栏半径
FStartCenterLon	String	开始围栏中心点经度
FStartCenterLat	String	开始围栏中心点纬度
FEndFence	String	结束围栏唯一标识
FEndFenceName	String	结束围栏名称
FEndFormType	int	结束围栏类型 1：多边形 2：圆形
FEndTypeName	String	结束围栏类型名称
FEndPath	String	结束围栏点集合，Json字符串
FEndRadius	double	结束围栏半径
FEndCenterLon	String	结束围栏中心点经度
FEndCenterLat	String	结束围栏中心点纬度
FRoadPoints	String	路线所有点集合，Json字符串
FRemark	String	路线描述
FIsMainRoute	int	是否主路线 1:是 0:否
FRoutePassInfo	Object	所有途经围栏，如果为null，表示该路线无途经围栏

返回参数FRoutePassInfo说明

参数名	类型	说明
FRouteGUID	String	所属路线唯一标识
FPassFenceGUID	String	途径围栏唯一标识
FName	String	途径围栏名称
FFormType	int	围栏类型 1：多边形 2：圆形
FTypeName	String	围栏类型名称
FPath	String	围栏点集合，Json字符串
FRadius	double	开始围栏半径
FCenterLon	String	开始围栏中心点经度
FCenterLat	String	开始围栏中心点纬度
FIndex	int	途径围栏序号

返回参数Table1为分支路线, 如果为null ,表示无此路线

备注:

更多返回错误代码如下：
102：请求参数错误
104：token过期异常报错
105：表示有异常报错

请求示例:

Java:

String result = "";
//请求路径
String url = "https://cloud.assetscontrols.com:3443/OpenApi/Admin";  
//请求参数 ,json格式参数，建议用对象传入
String body = "{"FAction":"QueryAllRoutePlanByFGUID","FGUID":"e286fe13-2034-45eb-9da2-d929e8a2558a",  \"FTokenID\": \"ec51d691-d9a7-4f74-95a8-1856be2ae741\"}";
URL realUrl = new URL(url);
// 设置通用请求的属性
URLConnection conn = realUrl.openConnection(); 
conn.setRequestProperty("accept", "*/*");
conn.setRequestProperty("connection", "keep-Alive");
conn.setRequestProperty("Content-Type", "application/json");
conn.setRequestProperty("user-agent", "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1;SV1)");
conn.setRequestProperty("method", "post");
// 发送POST请求必须设置如下两行
conn.setDoOutput(true);
conn.setDoInput(true);
PrintWriter pw = new PrintWriter(conn.getOutputStream());
// 发送请求参数
pw.print(body);
// flush输出流的缓冲  
pw.flush();   
// 定义BufferedReader输入流来读取URL的响应
BufferedReader bufReader = new BufferedReader(new InputStreamReader(conn.getInputStream()));  
// 定义BufferedReader输入流来读取URL的响应
String line;
while ((line = bufReader.readLine()) != null) {
     result += line;        
 }
//返回的是json字符串
return result;

C#：

//请求路径
string url = "https://cloud.assetscontrols.com:3443/OpenApi/Admin";  
//请求参数 ,json格式参数，建议用对象传入
string body = "{"FAction":"QueryAllRoutePlanByFGUID","FGUID":"e286fe13-2034-45eb-9da2-d929e8a2558a",  \"FTokenID\": \"ec51d691-d9a7-4f74-95a8-1856be2ae741\"}"; 
Encoding encoding = Encoding.UTF8;
HttpWebRequest request = (HttpWebRequest)WebRequest.Create(url);
 //请求方式 post / get
request.Method = "post"; 
request.Accept = "*/*";    
request.ContentType = "application/json";
request.UserAgent = "Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1)";
byte[] buffer = encoding.GetBytes(body);
request.ContentLength = buffer.Length;
request.GetRequestStream().Write(buffer, 0, buffer.Length);
HttpWebResponse response = (HttpWebResponse)request.GetResponse();
using (StreamReader reader = new StreamReader(response.GetResponseStream(), Encoding.UTF8))
{
    //返回的是json字符串
    return reader.ReadToEnd();
}

Python：

url = 'https://cloud.assetscontrols.com:3443/OpenApi/Admin'
      data = {
        'FAction': 'QueryAllRoutePlanByFGUID',
        'FTokenID': 'ec51d691-d9a7-4f74-95a8-1856be2ae741',
        'FGUID': 'e286fe13-2034-45eb-9da2-d929e8a2558a' 
       }
      data = parse.urlencode(data).encode('utf-8')
      headers = {
       'User-Agent': r'Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) '
                     r'Chrome/45.0.2454.85 Safari/537.36 115Browser/6.0.3',
       'Connection': 'keep-alive'
       }
      req = request.Request(url, headers=headers, data=data)  
      page = request.urlopen(req).read()
      page = page.decode('utf-8')
      # json_array = json.loads(page)
      return page;

文档更新时间: 2025-09-18 16:50 作者：刘家帅

查询单条路线信息,包含分支路线

简要描述：

接口版本：

请求URL:

请求方式：

请求头：

请求参数:

返回示例:

返回参数Table说明:

返回参数FRoutePassInfo说明

返回参数Table1为分支路线, 如果为null ,表示无此路线

备注:

请求示例: