TraceDownResult

URI

<fa3DNetworkDataName_uri>/tracedownresult[.<format>]

支持的方法

GET、HEAD

父资源

fa3DNetworkDataName

介绍

traceDownResult 为三维设施网络分析的下游追踪资源。查找指定弧段或节点的下游，返回下游包含的弧段、结点及总耗费。

支持的方法：

GET：获取下游包含的弧段、结点及总耗费信息。
HEAD：检查 traceDownResult 资源是否存在，或权限是否可以访问 traceDownResult 资源。

支持的表述格式：RJSON、JSON、XML、HTML、JSONP。

资源层次

HTTP 请求方法

对如下 URI 执行 HTTP 请求，以 rjson 输出格式为例加以说明，其中，supermapiserver 是服务器名。

http://supermapiserver:8090/iserver/services/networkAnalyst3D-Pipe3D/rest/facilityanalyst3d/{networkDataName}/tracedownresult.rjson

GET 请求

获取下游包含的弧段、结点及总耗费信息。

请求参数

对 traceDownResult 资源执行 GET 请求，需要在 URI 中包含一些参数，如下：

名称	类型	含义
edgeID	String	【必选参数】三维设施网络分析中指定的弧段 ID ，在请求 URI 中只能包含 edgeID 参数或 nodeID 参数，两者不能同时存在。
nodeID	String	【必选参数】三维设施网络分析中指定的节点 ID ，在请求 URI 中只能包含 nodeID 参数与 edgeID 参数，两者不能同时存在。
isUncertainDirectionValid	boolean	三维设施网络分析中指定不确定流向是否有效。指定为 true，表示不确定流向有效，遇到不确定流向时分析继续进行；指定为 false，表示不确定流向无效，遇到不确定流向将停止在该方向上继续查找。默认为 false ，流向字段的值为 2 时代表该弧段的流向为不确定流向。
weightName	String	【必选参数】三维设施网络分析中指定的权值字段名称。

响应结构

对 traceDownResult 资源执行 GET 请求，返回的资源表述结构如下：

字段	类型	说明
cost	double	三维设施网络分析结果中的耗费。
edges	int[]	三维设施网络分析结果中的弧段 ID 数组。
nodes	int[]	三维设施网络分析结果中的结点 ID 数组。

响应示例

对 traceDownResult 资源执行 GET 请求（http://localhost:8090/iserver/services/networkAnalyst3D-Pipe3D/rest/facilityanalyst3d/Network@Pipe3D/tracedownresult.rjson?edgeID=2&isUncertainDirectionValid=true&weightName=SMLENGTH），返回 rjson 格式的资源描述如下：

{ "cost": 2921.1391792773893, "edges": [ 3, 4, 5, 166, 6, 7, 496, 8, 170, 171, 172, 173, 9, 10, 465, 11, 12, 13, 174, 175, 178, 176, 177, 187, 188, 189, 193, 190, 192, 200, 201, 202, 203, 191, 194, 204, 195, 196, 198, 220, 199, 250, 500, 501, 502, 503, 251, 252, 253, 254, 255, 256, 257, 258, 259, 221, 222, 223, 225, 226, 227, 228, 229, 230, 231, 232, 233, 234, 240, 241, 242, 243, 244, 245, 246, 247, 248, 249, 235, 236, 237, 238, 239, 224, 197, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 217, 218, 219, 14, 15, 149, 150, 151, 152, 153, 154, 155, 156, 157, 260, 158, 159, 160, 161, 162, 163, 164, 468, 165, 469, 261, 262, 263, 264, 265, 267, 266, 268, 16, 293, 17, 21, 18, 19, 87, 88, 90, 91, 93, 94, 97, 98, 99, 100, 95, 96, 101, 102, 103, 138, 104, 105, 106, 107, 108, 110, 111, 113, 114, 115, 116, 118, 457, 458, 459, 460, 461, 462, 463, 464, 117, 112, 109, 139, 140, 141, 143, 144, 146, 147, 148, 179, 180, 181, 182, 183, 184, 185, 186, 145, 142, 92, 89, 20, 22, 292, 23, 24, 26, 27, 28, 29, 31, 30, 33, 34, 35, 36, 38, 39, 40, 41, 44, 45, 47, 48, 50, 51, 49, 52, 269, 273, 281, 282, 470, 471, 472, 283, 284, 285, 286, 287, 288, 289, 290, 291, 274, 275, 489, 276, 277, 278, 279, 490, 491, 270, 280, 271, 272, 46, 42, 43, 53, 54, 56, 57, 58, 60, 59, 61, 62, 63, 65, 66, 68, 69, 70, 71, 72, 74, 75, 76, 84, 77, 82, 78, 79, 80, 81, 83, 85, 86, 73, 67, 64, 55, 37, 32, 119, 120, 121, 122, 123, 124, 125, 126, 127, 134, 135, 137, 136, 128, 129, 130, 131, 132, 486, 487, 488, 133, 25, 294, 295, 296, 297, 298, 299, 301, 302, 303, 304, 305, 306, 307, 314, 315, 316, 317, 318, 319, 422, 423, 425, 424, 426, 427, 428, 429, 430, 320, 308, 309, 310, 311, 313, 312, 300, 466, 467, 497, 498, 499, 167, 168, 169 ], "nodes": [ 71, 72, 73, 74, 69, 70, 102, 67, 44, 31, 30, 1, 68, 65, 100, 66, 63, 64, 128, 183, 129, 184, 230, 229, 231, 232, 268, 185, 233, 234, 235, 236, 237, 186, 333, 269, 411, 334, 412, 413, 414, 444, 415, 445, 465, 466, 456, 457, 458, 459, 460, 461, 462, 463, 464, 404, 405, 406, 431, 432, 433, 434, 435, 436, 437, 408, 409, 438, 410, 397, 398, 399, 400, 401, 402, 403, 363, 364, 439, 440, 441, 442, 443, 407, 343, 270, 271, 272, 273, 274, 275, 276, 277, 278, 279, 280, 281, 305, 306, 307, 59, 60, 40, 41, 42, 43, 39, 28, 29, 27, 24, 25, 14, 15, 16, 17, 18, 19, 20, 22, 21, 23, 26, 4, 5, 6, 2, 7, 3, 8, 96, 61, 127, 97, 146, 147, 172, 173, 257, 258, 260, 261, 264, 265, 266, 159, 262, 263, 304, 331, 319, 332, 320, 321, 322, 323, 324, 389, 390, 392, 393, 478, 479, 503, 482, 483, 484, 485, 486, 477, 496, 497, 480, 391, 325, 339, 340, 341, 394, 395, 487, 488, 489, 498, 499, 490, 491, 492, 481, 493, 500, 396, 342, 259, 182, 148, 121, 98, 122, 123, 125, 126, 142, 143, 144, 158, 152, 153, 154, 155, 157, 163, 164, 165, 250, 251, 314, 315, 317, 318, 316, 377, 378, 382, 427, 428, 476, 494, 495, 423, 424, 425, 426, 450, 451, 452, 453, 454, 383, 384, 429, 385, 386, 387, 388, 430, 455, 379, 362, 380, 381, 252, 166, 167, 168, 169, 171, 177, 178, 180, 179, 221, 222, 223, 294, 295, 312, 313, 336, 360, 337, 361, 369, 370, 375, 371, 373, 372, 420, 421, 422, 374, 359, 376, 338, 296, 224, 170, 156, 145, 254, 267, 255, 297, 298, 299, 256, 253, 300, 226, 227, 181, 228, 301, 302, 303, 326, 327, 328, 329, 330, 225, 124, 62, 54, 93, 94, 55, 56, 58, 47, 48, 49, 50, 51, 92, 52, 53, 46, 87, 88, 89, 84, 85, 91, 86, 113, 114, 111, 115, 112, 90, 95, 117, 118, 119, 116, 120, 57, 99, 130, 103, 131, 149, 101, 104, 150 ] }

HEAD 请求

返回跟 GET 请求一样的 HTTP 响应头，但是没有响应实体。可以在不必传输整个响应内容的情况下，获取包含在响应消息头中的元数据信息。元数据信息包括媒体类型，字符编码，压缩编码，实体内容长度等。

HEAD 请求可以用来判断 traceDownResult 资源是否存在，或者客户端是否有权限访问 traceDownResult 资源。通过对加.<format>的 URI 执行 HEAD 请求，还可以快速判断 traceDownResult 资源是否支持<format>格式的表述。