Skip To Content
ArcGIS Developers
Dashboard

Divide

Description

Divide 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

ParameterDetails
gdbVersion

Parameter specifying the name of the geodatabase version (the default is the DEFAULT version).

Syntax

gdbVersion=<version>
sessionId

Parameter representing the token (GUID) used to lock the version. If the calling client is editing a named version, the session ID is required. 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. If the client is editing the default version, the session ID is not required.

Syntax

sessionId=<guid>
divideParcelGuid

(Required)

Parameter for the unique identifier (GUID) of the parcel being divided.

Syntax

divideParcelGuid=<guid>
divideParcelType

(Required)

Parameter representing the parcel type (layer ID) in which the new, divided parcels will be created.

Syntax

divideParcelType=<layer id>
record

(Required)

Parameter for the unique identifier (GUID) of the record being used for the divide.

Syntax

record=<guid>
divideOption

(Required)

Parameter representing the type of division to be performed.

Syntax

divideOption=<string>

Values: ProportionalArea | EqualArea| EqualWidth

divideNumberOfParts

(Required)

Parameter representing the number parts into which the parcel will be divided.

Syntax

divideNumberOfParts=<long>
dividePartArea

(Required)

Parameter representing the area of the divided parcels. This parameter is used for the EqualArea and EqualWidth divide options. For the ProportionalArea divide option, a default value of 0 can be used.

Syntax

dividePartArea=<double>
divideLineBearing

(Required)

Parameter representing the direction (in decimal degrees) of the line used to divide the parcel.

Syntax

divideLineBearing=<double>
divideLeftSide

(Required)

Parameter indicating if 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 EqualArea and EqualWidth divide options. For the ProportionalArea divide option, a default value of true or false can be used.

Syntax

divideLeftSide=<boolean>

Values: true | false

divideDistributeRemainder

(Required)

Parameter indicating whether to distribute or merge the remainder area after the divide is performed. This parameter is used for the EqualArea and EqualWidth divide options. For the ProportionalArea divide option, a default value of false can be used.

Syntax

divideDistributeRemainder=<boolean>

Values: true | false

defaultAreaUnit

(Required)

Parameter representing units in which area will be stored. The parameter is specified as a domain code from the PF_AreaUnits parcel fabric domain.

Syntax

defaultAreaUnit=<long>

Example using square feet:

defaultAreaUnit=109405

Example using square meters:

defaultAreaUnit=109404

divideCogoLineBearing

(Optional)

Parameter representing the COGO direction (in decimal degrees) that will be stored in the COGO Direction field of the dividing lines.

Syntax

divideCogoLineBearing=<double>
f

The response format. The default response format is html.

Values: html | json

Example usage

This example shows the steps for dividing parcels by proportional area using the divide operation.

Note:
The sessionId parameters must be the same for starting the edit session, performing the edit operation, and stopping the edit session.

  1. Start a service session on the version.

    Request URL and parameters:

    https://machine.domain.com/webadaptor/rest/services/CountyFabric/VersionManagementServer/versions/E4DAED9D-C859-489B-9053-767A45F1D97C/startReading
    f=json
    sessionId={ce7b2411-2cbd-4a01-bd80-ae7452a46bf0}

  2. Start an edit session on the version.

    Request URL and parameters:

    https://machine.domain.com/webadaptor/rest/services/CountyFabric/VersionManagementServer/versions/E4DAED9D-C859-489B-9053-767A45F1D97C/startEditing
    f=json
    sessionId={ce7b2411-2cbd-4a01-bd80-ae7452a46bf0}

  3. 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.

    Request URL and parameters:

    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
  4. If edits are complete, stop the edit session.
  5. Stop and release the service session.

JSON Response syntax

{
  "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>]
}

JSON Response example

{
 "moment": 1629489124957,
 "exceededTransferLimit": false,
 "serviceEdits": [
  {
   "id": 3,
   "editedFeatures": {
    "spatialReference": {
     "wkid": 103007,
     "latestWkid": 6424,
     "xyTolerance": 0.0032808333333333331,
     "zTolerance": 0.001,
     "mTolerance": 0.001,
     "falseX": -117608900,
     "falseY": -91881400,
     "xyUnits": 3048.00609601219276,
     "falseZ": -100000,
     "zUnits": 10000,
     "falseM": -100000,
     "mUnits": 10000
    },
    "updates": [
     [
      {
       "attributes": {
        "ObjectID": 1,
        "IsRetired": 0,
        "GlobalID": "{FD88E8B1-AF87-43D3-A6E2-F0CFB2D8EB1A}",
        "created_date": 1621104819000,
        "created_user": "GIS",
        "last_edited_user": "admin",
        "last_edited_date": 1629407600000,
        "Shape__Area": 148001.9871255222,
        "Shape__Length": 1985.43763025694375
       },
       "geometry": {
        "rings": [
         [
          [
           6816492.13231380284,
           1843354.75221531093
          ],
          [
           6816492.13231380284,
           1843185.95793347061
          ],
								[...]
									]
        ]
       }
      },
      {
       "attributes": {
        "ObjectID": 1,
        "IsRetired": 0,
        "GlobalID": "{FD88E8B1-AF87-43D3-A6E2-F0CFB2D8EB1A}",
        "created_date": 1621104819000,
        "created_user": "GIS",
        "last_edited_user": "admin",
        "last_edited_date": 1629489125000,
        "Shape__Area": 148001.987122025341,
        "Shape__Length": 1985.43763025191856
       },
       "geometry": {
        "rings": [
         [
          [
           6816492.13231380284,
           1843354.75221531093
          ],
          [
           6816492.13231380284,
           1843185.95793347061
          ],
									[...]
 								]
        ]
       }
      }
     ]
    ]
   }
  },
  {
   "id": 15,
   "editedFeatures": {
    "spatialReference": {
     "wkid": 103007,
     "latestWkid": 6424,
     "xyTolerance": 0.0032808333333333331,
     "zTolerance": 0.001,
     "mTolerance": 0.001,
     "falseX": -117608900,
     "falseY": -91881400,
     "xyUnits": 3048.00609601219276,
     "falseZ": -100000,
     "zUnits": 10000,
     "falseM": -100000,
     "mUnits": 10000
    },
 "adds": [
     {
      "attributes": {
       "OBJECTID": 8408,
       "GlobalID": "{821B6CC0-7AE9-4360-9088-0D2AB8403919}",
       "Name": null,
       "CreatedByRecord": "{5D3B06C4-7851-49D6-AD28-74BED662CDE6}",
       "RetiredByRecord": null,
       "StatedArea": null,
       "StatedAreaUnit": null,
       "CalculatedArea": null,
       "MiscloseRatio": null,
       "MiscloseDistance": null,
       "IsSeed": 0,
       "created_user": "admin",
       "created_date": 1629489125000,
       "last_edited_user": "admin",
       "last_edited_date": 1629489125000,
       "VALIDATIONSTATUS": 2,
       "Shape__Area": 9093.60914044499259,
       "Shape__Length": 384.335215541276
      },
      "geometry": {
       "hasZ": true,
       "rings": [
        [
         [
          6816471.48799814284,
          1843270.2874892205,
          0
         ],
         [
          6816363.61157347262,
          1843269.10245223343,
          0
         ],
[...]
"success": true
}