- URL:https://<parcelfabricservice-url>/divide
- Required Capability:ArcGIS Parcel Fabric
- Version Introduced:11.0
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.
Request parameters
| Parameter | Details |
|---|---|
| gdbVersion | Parameter specifying the name of the geodatabase version (the default is the DEFAULT version). Syntax |
| 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 |
| divideParcelGuid (Required) | Parameter for the unique identifier (GUID) of the parcel being divided. Syntax |
| divideParcelType (Required) | Parameter representing the parcel type (layer ID) in which the new, divided parcels will be created. Syntax |
| record (Required) | Parameter for the unique identifier (GUID) of the record being used for the divide. Syntax |
| divideOption (Required) | Parameter representing the type of division to be performed. Syntax Values: ProportionalArea | EqualArea| EqualWidth |
| divideNumberOfParts (Required) | Parameter representing the number parts into which the parcel will be divided. Syntax |
| 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 |
| divideLineBearing (Required) | Parameter representing the direction (in decimal degrees) of the line used to divide the parcel. Syntax |
| 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 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 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 Example using square feet: Example using square meters: |
divideCogoLineBearing (Optional) | Parameter representing the COGO direction (in decimal degrees) that will be stored in the COGO Direction field of the dividing lines. Syntax |
| 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.- 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} - 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} - 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 - If edits are complete, stop the edit session.
- 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
}