Merge Parcel Points | ArcGIS REST APIs

URL:: https://<root>/<serviceName>/ParcelFabricServer/mergeParcelPoints
Methods:: POST
Required Capability:: ArcGIS Advanced Editing
Version Introduced:: 12.0

Description

The mergeParcelPoints operation merges two or more parcel fabric points to a single point. You can specify which point's attributes to preserve and which point's location to preserve.

Learn more about merging parcel fabric points.

Request parameters

Parameter Details

Parameter	Details
`gdbVersion` (Required)	The name of the geodatabase version (the default is the `DEFAULT` version). Syntax Use dark colors for code blocksCopy `1 gdbVersion=<version>`
`sessionId` (Required)	The token (GUID) used to lock the version. If the calling client is editing a named version, the `sessionId` value is required. If the specified version is currently locked by another session, the request will fail if the `sessionId` value is not provided or does not match the `sessionId` value that holds the exclusive lock. If the client is editing the default version, the `sessionId` value is not required. Syntax Use dark colors for code blocksCopy `1 sessionId={<guid>}`
`points` (Required)	The input points that will be merged. The points are input as a string array of point GUIDS. Syntax Use dark colors for code blocksCopy `1 points=["{guid}","{guid}", ...,"{guid}"]`
`preservePointGuid` (Required)	The point with the attributes that will be preserved. Syntax Use dark colors for code blocksCopy `1 preservePointGuid={<guid>}`
`locationPointGuid` (Required)	The point that will be used as the merged location. Syntax Use dark colors for code blocksCopy `1 locationPointGuid={<guid>}`
`updateFeatures` (Required)	Specifies whether to return the preview of the merged point or perform the merge of the points. Set to `true` to perform the merge of the points. Values: `true` \| `false` Syntax Use dark colors for code blocksCopy `1 updateFeatures=true\|false`
`removeLines` (Required)	Specifies whether to collapse parcels and remove lines when points are merged. Set to `true` to collapse parcels and remove lines. Values: `true` \| `false` Syntax Use dark colors for code blocksCopy `1 removeLines=true\|false`
`attributeOverrides` (Optional)	A list of attributes that will be used to override and replace attributes on the new merged point. Syntax Use dark colors for code blocksCopy `1 attributeOverrides={"type":"PropertySet","propertySetItems":["<FieldName>",<value>,"<FieldName>",<value>,.....]}`
`f`	Specifies the output format of the response. The default response format is `html`. Values: `html` \| `json` \| `pjson`

gdbVersion

(Required)

The name of the geodatabase version (the default is the DEFAULT version).

Syntax

Use dark colors for code blocksCopy
gdbVersion=<version>

sessionId

(Required)

The token (GUID) used to lock the version. If the calling client is editing a named version, the sessionId value is required. If the specified version is currently locked by another session, the request will fail if the sessionId value is not provided or does not match the sessionId value that holds the exclusive lock. If the client is editing the default version, the sessionId value is not required.

Syntax

Use dark colors for code blocksCopy
sessionId={<guid>}

points

(Required)

The input points that will be merged. The points are input as a string array of point GUIDS.

Syntax

Use dark colors for code blocksCopy
points=["{guid}","{guid}", ...,"{guid}"]

preservePointGuid

(Required)

The point with the attributes that will be preserved.

Syntax

Use dark colors for code blocksCopy
preservePointGuid={<guid>}

locationPointGuid

(Required)

The point that will be used as the merged location.

Syntax

Use dark colors for code blocksCopy
locationPointGuid={<guid>}

updateFeatures

(Required)

Specifies whether to return the preview of the merged point or perform the merge of the points. Set to true to perform the merge of the points.

Values: true | false

Syntax

Use dark colors for code blocksCopy
updateFeatures=true|false

removeLines

(Required)

Specifies whether to collapse parcels and remove lines when points are merged. Set to true to collapse parcels and remove lines.

Values: true | false

Syntax

Use dark colors for code blocksCopy
removeLines=true|false

attributeOverrides

(Optional)

A list of attributes that will be used to override and replace attributes on the new merged point.

Syntax

Use dark colors for code blocksCopy
attributeOverrides={"type":"PropertySet","propertySetItems":["<FieldName>",<value>,"<FieldName>",<value>,.....]}

f

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

Values: html | json | pjson

Example usage

This example shows the steps for merging parcel fabric points using the mergeParcelPoints operation.

Start a service session on the version.

Request URL and parameters:

Use dark colors for code blocksCopy
https://organization.example.com/<context>/rest/services/CountyFabric/VersionManagementServer/versions/E4DAED9D-C859-489B-9053-767A45F1D97C/startReading
f=json
sessionId={bba232fc-e671-4aa2-83d4-1c013347fa4f}

Start an edit session on the version.

Request URL and parameters:

Use dark colors for code blocksCopy
https://organization.example.com/<context>/rest/services/CountyFabric/VersionManagementServer/versions/E4DAED9D-C859-489B-9053-767A45F1D97C/startEditing
f=json
sessionId={bba232fc-e671-4aa2-83d4-1c013347fa4f}

Merge two parcel fabric points. Do not override any attributes.

Request URL and parameters:

Use dark colors for code blocksCopy
https://organization.example.com/<context>/rest/services/CountyFabric/ParcelFabricServer/shrinkToSeed
f=json
gdbVersion=admin.Version1
sessionId={bba232fc-e671-4aa2-83d4-1c013347fa4f}
points=["{D56CE33E-5D65-4558-B59C-788818CF7E74}","{CD5DA095-1F26-463D-97F6-0304064B14BD}"]
preservePointGuid={D56CE33E-5D65-4558-B59C-788818CF7E74}
locationPointGuid={D56CE33E-5D65-4558-B59C-788818CF7E74}
updateFeatures=true
removeLines=true
async=false

If edits are complete, stop the edit session.
Stop and release the service session.

JSON Response syntax

The following response is returned when async is false:

Use dark colors for code blocksCopy
    "moment": <datetime>,
    "exceededTransferLimit": <true | false>,
    "serviceEdits":
        {
            "editedFeatures":
            "spatialReference": {<spatialreference>},
            "updates": [...]
            id=<layerid>
        }
        {
            "editedFeatures":
            "deletes": [...]
            "spatialReference": {<spatialreference>},
            "updates": [...]
            id=<layerid>
        }
        {
            editedFeatures
            id=<layerid>
        }
        {
            editedFeatures
            id=<layerid>
        }
    success=True

The following response is returned when async is true :

Use dark colors for code blocksCopy
    {
		"statusUrl": <url>
    }