traceDown

URI

<networkDataName_uri_uri>/tracedown[.<format>]

支持的方法

父资源

networkDataName

介绍

traceDown 资源表示下游追踪分析，对 traceDown 执行 GET 请求，可查找给定弧段或节点的下游弧段和结点。

支持的方法：

GET：查找给定弧段或节点的下游弧段和节点。
HEAD：检查 traceDown 资源是否存在，或权限是否可以访问 traceDown 资源。

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

资源层次

HTTP 请求方法

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

http://supermapiserver:8090/iserver/services/transportationAnalyst-facilityNet/rest/networkanalyst/WaterNet@FacilityNet/tracedown.rjson

GET 请求

查找给定弧段或节点的下游弧段和节点。

请求参数

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

名称	类型	含义
edgeID	int	【与nodeID必填一项】需查找上游设施的弧段 ID 。
nodeID	int	【与edgeID必填一项】需查找上游设施的结点 ID 。
weightName	String	权重字段，默认为 SMLENGTH。
isUncertainDirectionValid	boolean	选择是，表示不确定流向有效，遇到不确定流向时分析继续进行；选择否，表示不确定流向无效，遇到不确定流向将停止在该方向上继续查找。
withIndex	boolean	当使用 FlatGeobuf 表述时该参数可选。表示返回的表述为 FlatGeobuf 的结果是否包含空间索引，默认为true。
returnFeatures	boolean	否返回结果要素的详细描述信息。若为 false，只返回结果要素的 ID 集合。

响应结构

描述

字段	类型	说明
cost	double	分析结果中的耗费。
edges	int[]	分析结果弧段 ID 集合。
edgesFeatures	Feature[]	分析结果弧段详细描述信息。
nodes	int[]	分析结果中的结点 ID 集合。
nodesFeature	Feature[]	分析结果中的结点要素的详细描述信息。

响应示例

对示范数据 WaterNet@FacilityNet 数据集执行上游追踪分析，即对如下 URI 执行 GET 请求：

http://supermapiserver:8090/iserver/services/transportationAnalyst-facilityNet/rest/networkanalyst/WaterNet@FacilityNet/tracedown.rjson?edgeID=1&isUncertainDirectionValid=true&returnFeatures=true&weightName=SMLENGTH

返回结果如下：

{

"cost": 490392.3672126023,

"edges": [

1,

2,

2

],

"edgesFeatures": [

{

"ID": 1,

"fieldNames": [

"SMID",

"SMSDRIW",

"SMSDRIN",

"SMSDRIE",

"SMSDRIS",

"SMUSERID",

"SMRESISTANCEA",

"SMRESISTANCEB",

"SMLENGTH",

"SMTOPOERROR",

"SMFNODE",

"SMTNODE",

"SMEDGEID",

"SMGEOMETRYSIZE",

"DIRECTION"

],

"fieldValues": [

"1",

"-948942.3",

"3856350.0",

"-926875.44",

"3791757.5",

"3332",

"1.0",

"1.0",

"82880.9632134468",

"1",

"2",

"7",

"1",

"632",

"1"

],

"geometry": {

"center": {

"x": -926972.563544177,

"y": 3826413.0521438215

},

"id": 1,

"partTopo": null,

"parts": [39],

"points": [

{

"x": -941483.7569166485,

"y": 3856349.8855158235

},

{

"x": -942765.4042135794,

"y": 3853741.8282586816

},

{

"x": -943883.8576401076,

"y": 3851853.94355556

},

{

"x": -944163.6582859682,

"y": 3849501.8216074924

},

{

"x": -943682.0625984033,

"y": 3848103.741719451

},

{

"x": -942896.95807764,

"y": 3846722.2000929313

},

{

"x": -941486.8876817955,

"y": 3845068.129615492

},

{

"x": -939929.5695138746,

"y": 3844437.836164761

},

{

"x": -938168.7730279022,

"y": 3843818.4586299863

},

{

"x": -933916.5052925996,

"y": 3842211.0133842216

},

{

"x": -932983.020075049,

"y": 3841852.605190063

},

{

"x": -931956.7262807183,

"y": 3839772.193372

},

{

"x": -931443.1132447799,

"y": 3837766.41048471

},

{

"x": -931073.2835533952,

"y": 3836565.856309187

},

{

"x": -929962.6060571494,

"y": 3834794.6863347134

},

{

"x": -929176.6882087882,

"y": 3833412.885338366

},

{

"x": -927879.8650005814,

"y": 3831955.9660093724

},

{

"x": -926875.4594167685,

"y": 3830280.228622274

},

{

"x": -926883.7482657861,

"y": 3828551.9486851217

},

{

"x": -926972.563544177,

"y": 3826413.0521438215

},

{

"x": -927865.6994237883,

"y": 3824130.405792608

},

{

"x": -928627.8684607756,

"y": 3823175.8246027

},

{

"x": -929884.876685566,

"y": 3821992.3630313408

},

{

"x": -931952.1577797777,

"y": 3820766.421233274

},

{

"x": -934414.5315977258,

"y": 3819316.906936594

},

{

"x": -936386.3225472053,

"y": 3818197.6277481425

},

{

"x": -937441.5077787752,

"y": 3817024.198449457

},

{

"x": -938729.4167850106,

"y": 3814517.595375112

},

{

"x": -939830.2433983588,

"y": 3812326.4907802665

},

{

"x": -941962.1487272659,

"y": 3810385.2249598163

},

{

"x": -944119.7861036116,

"y": 3808951.710151221

},

{

"x": -945569.0461299194,

"y": 3807554.3591885213

},

{

"x": -947538.7330514987,

"y": 3804504.4852072173

},

{

"x": -948352.7391655098,

"y": 3802632.3853419162

},

{

"x": -948942.3154318775,

"y": 3800365.279127587

},

{

"x": -948876.7589196367,

"y": 3799149.4491934534

},

{

"x": -948576.0448517092,

"y": 3797335.61439268

},

{

"x": -948371.5294164096,

"y": 3795415.281548102

},

{

"x": -947728.2672767679,

"y": 3791757.5905491877

}

],

"prjCoordSys": null,

"style": null,

"type": "LINE"

}

},

{

"ID": 2,

"fieldNames": [

"SMID",

"SMSDRIW",

"SMSDRIN",

"SMSDRIE",

"SMSDRIS",

"SMUSERID",

"SMRESISTANCEA",

"SMRESISTANCEB",

"SMLENGTH",

"SMTOPOERROR",

"SMFNODE",

"SMTNODE",

"SMEDGEID",

"SMGEOMETRYSIZE",

"DIRECTION"

],

"fieldValues": [

"2",

"-1130331.0",

"3830856.5",

"-947728.25",

"3791757.5",

"3331",

"1.0",

"1.0",

"203755.70199957775",

"1",

"1",

"7",

"2",

"1128",

"2"

],

"geometry": {

"center": {

"x": -1032342.2904773944,

"y": 3830365.2858050363

},

"id": 2,

"partTopo": null,

"parts": [70],

"points": [

{

"x": -1130330.9808985773,

"y": 3829150.748031182

},

{

"x": -1128234.7904652364,

"y": 3828104.009454467

},

{

"x": -1126255.1325870433,

"y": 3827191.2146250424

},

{

"x": -1122147.7608089868,

"y": 3826389.2424355363

},

{

"x": -1118996.4354008625,

"y": 3826349.818749717

},

{

"x": -1116633.011077165,

"y": 3825863.564885844

},

{

"x": -1112647.1905697775,

"y": 3823530.7633450227

},

{

"x": -1109404.8613276782,

"y": 3823699.9458534885

},

{

"x": -1104963.4434357388,

"y": 3824236.9347074623

},

{

"x": -1103095.9252104952,

"y": 3823521.1464944556

},

{

"x": -1101196.1951914872,

"y": 3822197.7651115553

},

{

"x": -1098288.6053171528,

"y": 3821027.851704959

},

{

"x": -1095832.1990014191,

"y": 3822578.9350222354

},

{

"x": -1093939.1641607706,

"y": 3823288.186820875

},

{

"x": -1089976.8523173246,

"y": 3823290.9789834903

},

{

"x": -1086937.4282131107,

"y": 3823449.774688991

},

{

"x": -1083262.9294079782,

"y": 3823133.4122251435

},

{

"x": -1080308.5822595612,

"y": 3822982.831215473

},

{

"x": -1078235.039456045,

"y": 3824107.3188307434

},

{

"x": -1074918.6602512866,

"y": 3824788.8615466543

},

{

"x": -1070455.5874198638,

"y": 3824919.863382298

},

{

"x": -1067245.7101189618,

"y": 3825697.427543476

},

{

"x": -1064819.9154555884,

"y": 3825925.5840080306

},

{

"x": -1062809.7304527196,

"y": 3826335.4115854916

},

{

"x": -1060473.8727126697,

"y": 3826355.6158234435

},

{

"x": -1058230.3011492807,

"y": 3828099.3509229296

},

{

"x": -1054952.5848149788,

"y": 3829489.731349712

},

{

"x": -1051625.6774255729,

"y": 3829968.265531121

},

{

"x": -1047545.0995276025,

"y": 3829673.290573323

},

{

"x": -1044249.4125167541,

"y": 3828829.0674762647

},

{

"x": -1042493.8496550785,

"y": 3828310.5953339576

},

{

"x": -1041165.826380332,

"y": 3828176.832533287

},

{

"x": -1039155.6566114768,

"y": 3828586.9595481395

},

{

"x": -1035916.0248894612,

"y": 3830686.606986321

},

{

"x": -1034604.3518378383,

"y": 3830856.5284370193

},

{

"x": -1032342.2904773944,

"y": 3830365.2858050363

},

{

"x": -1028336.6603973655,

"y": 3829557.9055637843

},

{

"x": -1022852.5477079265,

"y": 3827709.800223688

},

{

"x": -1018665.7468791755,

"y": 3827318.389545431

},

{

"x": -1016111.2374263101,

"y": 3827045.36609677

},

{

"x": -1014350.740225432,

"y": 3826425.973536659

},

{

"x": -1013228.427009851,

"y": 3824451.650495656

},

{

"x": -1009849.8947843194,

"y": 3822087.1597893927

},

{

"x": -1006175.5904245786,

"y": 3821770.687496191

},

{

"x": -1003343.990563439,

"y": 3822019.717379139

},

{

"x": -998459.1918259463,

"y": 3821868.487222808

},

{

"x": -996184.2784175407,

"y": 3819243.2520305067

},

{

"x": -993627.724074437,

"y": 3817038.830280837

},

{

"x": -991616.0285358524,

"y": 3815517.9332023095

},

{

"x": -989677.3802649409,

"y": 3813484.626188326

},

{

"x": -987073.9536520431,

"y": 3812299.242406637

},

{

"x": -985356.8102337797,

"y": 3812490.72093764

},

{

"x": -982632.4309204014,

"y": 3812836.136456593

},

{

"x": -981320.3740559996,

"y": 3813006.377378464

},

{

"x": -978793.3263470794,

"y": 3813239.7172276108

},

{

"x": -975107.3118963279,

"y": 3812720.595938644

},

{

"x": -971150.6936600255,

"y": 3812825.47120951

},

{

"x": -968125.6205907371,

"y": 3811357.451177546

},

{

"x": -966017.596189799,

"y": 3809942.458276486

},

{

"x": -963306.8848134733,

"y": 3808661.392554484

},

{

"x": -961428.3700631196,

"y": 3807743.219723986

},

{

"x": -960120.220576681,

"y": 3806083.3319280534

},

{

"x": -959135.954318631,

"y": 3802882.7570908335

},

{

"x": -956872.1270410249,

"y": 3800459.701882651

},

{

"x": -953579.0758960873,

"y": 3797785.9142398983

},

{

"x": -952010.252238556,

"y": 3796953.061588975

},

{

"x": -951309.5905573696,

"y": 3795261.474610711

},

{

"x": -950335.7374882551,

"y": 3792263.6138790464

},

{

"x": -948180.5669224514,

"y": 3791868.173033622

},

{

"x": -947728.2672767679,

"y": 3791757.5905491877

}

],

"prjCoordSys": null,

"style": null,

"type": "LINE"

}

},

null

],

"nodes": [

7,

2,

1

],

"nodesFeatures": [

{

"ID": 7,

"fieldNames": [

"SMID",

"SMX",

"SMY",

"SMLIBTILEID",

"SMNODEID",

"SMUSERID",

"SMGEOMETRYSIZE",

"NODETYPE",

"FILTER"

],

"fieldValues": [

"7",

"-947728.2672767679",

"3791757.5905491877",

"1",

"7",

"0",

"16",

"0",

"true"

],

"geometry": {

"center": {

"x": -947728.2672767679,

"y": 3791757.5905491877

},

"id": 7,

"partTopo": null,

"parts": [1],

"points": [{

"x": -947728.2672767679,

"y": 3791757.5905491877

}],

"prjCoordSys": null,

"style": null,

"type": "POINT"

}

},

{

"ID": 2,

"fieldNames": [

"SMID",

"SMX",

"SMY",

"SMLIBTILEID",

"SMNODEID",

"SMUSERID",

"SMGEOMETRYSIZE",

"NODETYPE",

"FILTER"

],

"fieldValues": [

"2",

"-941483.7569166485",

"3856349.8855158235",

"1",

"2",

"0",

"16",

"0",

"true"

],

"geometry": {

"center": {

"x": -941483.7569166485,

"y": 3856349.8855158235

},

"id": 2,

"partTopo": null,

"parts": [1],

"points": [{

"x": -941483.7569166485,

"y": 3856349.8855158235

}],

"prjCoordSys": null,

"style": null,

"type": "POINT"

}

},

{

"ID": 1,

"fieldNames": [

"SMID",

"SMX",

"SMY",

"SMLIBTILEID",

"SMNODEID",

"SMUSERID",

"SMGEOMETRYSIZE",

"NODETYPE",

"FILTER"

],

"fieldValues": [

"1",

"-1130330.9808985773",

"3829150.748031182",

"1",

"1",

"0",

"16",

"0",

"true"

],

"geometry": {

"center": {

"x": -1130330.9808985773,

"y": 3829150.748031182

},

"id": 1,

"partTopo": null,

"parts": [1],

"points": [{

"x": -1130330.9808985773,

"y": 3829150.748031182

}],

"prjCoordSys": null,

"style": null,

"type": "POINT"

}

}

]

}

HEAD 请求

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

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

请参见