<networkDataName_uri>/traceup[.<format>]
traceUp resource represents tracing upstream analysis. By sending a GET request to traceUp, the system will return the upstream arcs and nodes that flow into the specified arcs and nodes.
Supported Methods:
Supported output formats: RJSON, JSON, HTML, XML.
Execute HTTP request on the following URI, here we take rjosn as the output format as an example. Where, supermapiserver is the server name.
http://supermapiserver:8090/iserver/services/transportationAnalyst-facilityNet/rest/networkanalyst/WaterNet%40FacilityNet/traceup.rjson
Finds the upstream arcs and nodes that flow into the specified arcs or nodes.
To execute a GET request on traceUp resource, the URI should contain the following parameters:
| Name | Type | Description |
| edgeID | int |
[One of edgeID and nodeID is required] The specified edge ID used to find it's upstream facilities. |
| nodeID | int | [One of edgeID and nodeID is required] The specified node ID used to find it's upstream facilities. |
| weightName | String | Weight field. Default is SMLENGTH. |
| isUncertainDirectionValid | boolean | true indicates uncertain flow direction is valid, the arcs with uncertain flow direction still participates in the analysis; false means uncertain flow direction is invalid, ie., the system will stop searching in that direction when the dirction is uncertain. |
| returnFeatures | boolean | Whether to return the detailed information of the result features. False means only the IDs of the result features will be returned. |
After executing tracing upstream analysis, the response fields of the result representation are as follows:
| Name | Type | Description |
| cost | double | The cost of the tracing analysis. |
| edges | int[] | The IDs of the result edges. |
| edgesFeatures | Feature[] | The detailed information of the result edges. |
| nodes | int[] | The IDs of the result nodes. |
| nodesFeature | Feature[] | The detailed information of the result nodes. |
Execute tracing upstream analysis to sample dataset "WaterNet@FacilityNet", ie., sending a GET request by using the following URI:
http://supermapiserver:8090/iserver/services/transportationAnalyst-facilityNet/rest/networkanalyst/WaterNet@FacilityNet/traceup.rjson?nodeID=1&isUncertainDirectionValid=true&returnFeatures=true&weightName=SMLENGTH
Analysis result:
{
"cost": 407511.4039991555,
"edges": [
2,
2
],
"edgesFeatures": [
{
"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": [
1,
7
],
"nodesFeatures": [
{
"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"
}
},
{
"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"
}
}
]
}
Returns the same HTTP response header as the GET request, but no response entity, which can be used to retrieve the meta data contained in response message header without having to transmit the entire response content. Meta data information includes media type, character coding, compression coding, entity content length, etc.
HEAD request is used to determine whether the traceUp resource exists, or if the user has the authority to access it. By executing an HEAD request with a .<format> URI, you can quickly determine whether the traceUp resource supports the <format> representation.