- URL:
- https://<root>/<serviceName/ParcelFabricServer/divide
- Methods:
POST
- Required Capability:
- ArcGIS Advanced Editing
- Version Introduced:
- 10.9.1
Description
The divide
operation creates new parcels by dividing an existing parcel in the parcel fabric. Parcels can be divided using the following area-based methods:
- Proportional Area—Divides a parcel into equal areas based on a specified number of parts
- Equal Area—Divides a parcel into equal areas based on a specified area and number of parts
- Equal Width—Divides a parcel into areas based on a specified width and number of parts
Learn more about dividing parcels using area-based methods
Request parameters
Parameter | Details |
---|---|
(Required) | Introduced at 10.9.1. The name of the geodatabase version (the default is the Syntax
|
(Required) | Introduced at 10.9.1. 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 Syntax
|
(Required) | Introduced at 10.9.1. The unique identifier (GUID) of the parcel being divided. Syntax
|
(Required) | Introduced at 10.9.1. The parcel type (layer ID) in which the new, divided parcels will be created. Syntax
|
(Required) | Introduced at 10.9.1. The unique identifier (GUID) of the record being used for the divide. Syntax
|
(Required) | Introduced at 10.9.1. The type of division to be performed. Syntax
Values: |
(Required) | Introduced at 10.9.1. The number of parts into which the parcel will be divided. Syntax
|
(Required) | Introduced at 10.9.1. The area of the divided parcels. This parameter is used for the Syntax
|
(Required) | Introduced at 10.9.1. The direction (in decimal degrees) of the line used to divide the parcel. Syntax
|
(Required) | Introduced at 10.9.1. Specifies whether the area being divided is starting from the leftmost (northern or western) edge of the parcel. Any remainder area will be to the right of the divided parts. If false, the area being divided starts from the rightmost (southern or eastern) edge of the parcel and any remainder area will be to the left of the divided parts. This parameter is used for the Syntax
Values: |
(Required) | Introduced at 10.9.1. Specifies whether the remainder area will be distributed or merged after the divide is performed. This parameter is used for the Syntax
Values: |
(Required) | Introduced at 10.9.1. The units in which area will be stored. The parameter is specified as a domain code from the Syntax
Example using square feet:
Example using square meters:
|
(Optional) | Introduced at 10.9.1. The COGO direction (in decimal degrees) that will be stored in the COGO Syntax
|
(Required) | Introduced at 11.3. Specifies whether to split parent parcel lines by the dividing, intersecting lines. The original parent parcel lines are will be retired as historic and new lines are created for the divided parcels. COGO dimensions are updated on the created lines with proportioned, computed values. |
(Optional) | Introduced at 11.1. Specifies whether the request will be processed asynchronously. If Values: Syntax
|
| Specifies the output format of the response. The default response format is Values: |
Example usage
This example shows the steps for dividing parcels by proportional area using the divide
operation.
-
Start a service session on the version.
Request URL and parameters:
Use dark colors for code blocks Copy https://machine.domain.com/webadaptor/rest/services/CountyFabric/VersionManagementServer/versions/E4DAED9D-C859-489B-9053-767A45F1D97C/startReading f=json sessionId={ce7b2411-2cbd-4a01-bd80-ae7452a46bf0}
-
Start an edit session on the version.
Request URL and parameters:
Use dark colors for code blocks Copy https://machine.domain.com/webadaptor/rest/services/CountyFabric/VersionManagementServer/versions/E4DAED9D-C859-489B-9053-767A45F1D97C/startEditing f=json sessionId={ce7b2411-2cbd-4a01-bd80-ae7452a46bf0}
-
Divide a parcel into two parts by proportional area. Store the direction of the divide line in the COGO
Direction
field of the divided boundary. Split the parent parcel lines.Request URL and parameters:
Use dark colors for code blocks Copy https://machine.domain.com/webadaptor/rest/services/CountyFabric/ParcelFabricServer/divide f=json gdbVersion=admin.Version1 sessionId={ce7b2411-2cbd-4a01-bd80-ae7452a46bf0} divideParcelGuid={D6C6C24A-25B1-4563-8B1A-B88F95B753AD} divideParcelType=15 record={5D3B06C4-7851-49D6-AD28-74BED662CDE6} divideOption=ProportionalArea divideNumberOfParts=2 dividePartArea=0 divideLineBearing=89.37056 divideLeftSide=true divideDistributeRemainder=false defaultAreaUnit=109405 divideCogoLineBearing=89.37056 divideAssociatedLines=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
:
{
"exceededTransferLimit: <true | false>,
"moment": <datetime>,
"serviceEdits": [{ // only if transfer limit is not exceeded
"editedFeatures": {
"spatialReference": {}
"updates": [
[{ "attributes": {}
"geometry": {}
}]]
"adds":[
{ "attributes": {}
"geometry": {}
]}]
"success": <true | false>,
"error": { // only if success is false
"extendedCode": <HRESULT>,
"message": <error message>,
"details": [<detail>]
}
The following response is returned when async
is true
:
{
"statusUrl": <url>
}