Synthesize Association Geometries

URL:
https://<root>/<serviceName>/UtilityNetworkServer/synthesizeAssociationGeometries
Methods:
POST
Required Capability:
Requires the ArcGIS Advanced Editing user type extension license
Version Introduced:
10.6

Description

The synthesizeAssociationGeometries operation is used to export geometries representing associations that are synthesized as line segments corresponding to the geometries of the features at the endpoints.

  • All features with an association must be in the specified extent for the geometry to be synthesized.
  • If only one of the association features intersects the extent, no geometry will be synthesized.

Request parameters

ParameterDetails

f

The output format of the response. The default response format is html.

1
f=html | json | pjson

gdbVersion

Specifies the name of the geodatabase version. The default is sde.DEFAULT .

Syntax: gdbVersion=<version>

sessionId

(Optional)

Specifies the token guid used to lock the version. If the calling client has previously started a service session (editing) and holds an exclusive lock on the specified version, the request will fail if the session ID is not provided. If the specified version is currently locked by any other session, the request will fail if the session ID is not provided or does not match the session ID that holds the exclusive lock.

Syntax: sessionId=<guid>

moment

(Optional)

Specifies the session moment (the default value is the version current moment). This should only be specified by the client when they do not want to use the current moment.

Syntax: moment=<Epoch time in seconds>

Example: moment=1701505446

attachmentAssociations

(Optional)

Boolean parameter specifying whether to return attachment associations. The default is false.

1
attachmentAssociations=true | false

connectivityAssociations

(Optional)

Boolean parameter specifying whether to return connectivity associations. The default is false.

1
connectivityAssociations=true | false

containmentAssociations

(Optional)

Boolean parameter specifying whether to return containment associations. The default is false.

1
containmentAssociations=true | false

maxGeometryCount

(Required)

Specifies the maximum number of geometries that can be synthesized and returned in the result.

extent

(Required)

Specifies the envelope of the area to synthesize association geometries.

Syntax:

1
2
3
4
5
6
7
8
9
10
{
 "xmin": <minimum x-coordinate>,
 "ymin": <minimum y-coordinate>,
 "xmax": <maximum x-coordinate>,
 "ymax": <maximum y-coordinate>,
 "spatialReference": {
  "wkid": <spatial reference well-known identifier>,
  "latestWkid": <the current wkid value associated with the wkid>
 }
}

outSR

(Optional)

Introduced at ArcGIS Enterprise 11.1. Specifies the output spatial reference for the synthesized association geometries.

Syntax:

1
"outSR": {"wkid" : <wkid>}

JSON Response syntax

JSON response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
{
  "maxGeometryCountExceeded" : <true | false>,
  "associations" : [
    {
      "globalId" : <guid>,
      "associationType" : <attachment | connectivity | containment>,
      "fromNetworkSourceId" : <long>,
      "fromGlobalId" : <guid>,
      "fromTerminalId" : <long>,
      "toNetworkSourceId" : <long>,
      "toGlobalId" : <guid>,
      "toTerminalId" : <long>,
      "geometry" : <geometry>
    }
  ],
  "success" : <true | false>,
  "error" : {                   // only if success is false
    "extendedCode" : <HRESULT>,
    "message" : <error message>,
    "details" : [ <detail> ]
  }
}

Example usage

Export connectivity association geometries that are synthesized as line segments between associated features using the synthesizeAssociationGeometries operation.

Request URL and parameters:

https://myserver.esri.com/server/rest/services/LandUse/UtilityNetworkServer/synthesizeAssociationGeometries

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
f=json
gdbVersion=SDE.DEFAULT
connectivityAssociations=true
maxGeometryCount=25
extent=
{
 "xmin": 6814287.099790375,
	"ymin": 1847003.4894856418,
	"xmax": 6814425.830360317,
	"ymax": 1847091.4713699604,
	"spatialReference": {
		"wkid": 3498,
		"latestWkid": 3498
 }
}

JSON response:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
{
 "maxGeometryCountExceeded": false,
 "associations": [
  {
   "globalId": "{1EC703AE-E366-49A3-B1BC-C47CCE64EB18}",
   "fromNetworkSourceId": 6,
   "fromGlobalId": "{401220B7-8BC5-4880-903C-1C12FDCA7AA4}",
   "fromTerminalId": 8,
   "toNetworkSourceId": 9,
   "toGlobalId": "{B7341BE2-22AC-472C-9525-AFB49D3744C6}",
   "toTerminalId": 1,
   "associationType": "connectivity",
   "geometry": {
    "paths": [
     [
      [
       6814350.21697822213,
       1847032.11133039
      ],
      [
       6814325.15600472689,
       1847030.02307997644
      ]
     ]
    ]
   }
  },
  {
   "globalId": "{BB40E459-14BF-4C95-BE03-D8DFDC41BE07}",
   "fromNetworkSourceId": 6,
   "fromGlobalId": "{401220B7-8BC5-4880-903C-1C12FDCA7AA4}",
   "fromTerminalId": 9,
   "toNetworkSourceId": 9,
   "toGlobalId": "{ECADD413-D492-4FC4-BA18-8846397D7872}",
   "toTerminalId": 1,
   "associationType": "connectivity",
   "geometry": {
    "paths": [
     [
      [
       6814294.87424114347,
       1847025.32427047193
      ],
      [
       6814325.15600472689,
       1847030.02307997644
      ]
     ]
    ]
   }
  }
 ],
 "success": true
}

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.

You can no longer sign into this site. Go to your ArcGIS portal or the ArcGIS Location Platform dashboard to perform management tasks.

Your ArcGIS portal

Create, manage, and access API keys and OAuth 2.0 developer credentials, hosted layers, and data services.

Your ArcGIS Location Platform dashboard

Manage billing, monitor service usage, and access additional resources.

Learn more about these changes in the What's new in Esri Developers June 2024 blog post.

Close