Skip To Content

Divide

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

ParameterDetails
gdbVersion

(Required)

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

Syntax

gdbVersion=<version>
sessionId

(Required)

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 sessionId value is not provided. 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.

Syntax

sessionId=<guid>
divideParcelGuid

(Required)

The unique identifier (GUID) of the parcel being divided.

Syntax

divideParcelGuid=<guid>
divideParcelType

(Required)

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

Syntax

divideParcelType=<layer id>
record

(Required)

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

Syntax

record=<guid>
divideOption

(Required)

The type of division to be performed.

Syntax

divideOption=<string>

Values: ProportionalArea | EqualArea| EqualWidth

divideNumberOfParts

(Required)

The number of parts into which the parcel will be divided.

Syntax

divideNumberOfParts=<long>
dividePartArea

(Required)

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)

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

Syntax

divideLineBearing=<double>
divideLeftSide

(Required)

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 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)

Specifies whether the remainder area will be distributed or merged 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)

The 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)

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

This parameter is optional.

Syntax

divideCogoLineBearing=<double>
async

Specifies whether the request will be processed asynchronously. If true, the request is processed as an asynchronous job and a URL is returned that points to a location displaying the status of the job. The default is false. This parameter is optional.

Values: true | false

Syntax

async=true|false
f

Specifies the output format of the response. 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 parameter value 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
    async=false
  4. If edits are complete, stop the edit session.
  5. 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>
}

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
}