- URL:https://<parcelfabricservice-url>/divide
- Required Capability:ArcGIS Advanced Editing
- Version Introduced:11.2
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
Request parameters
Parameter | Details |
---|---|
gdbVersion (Required) | The name of the geodatabase version (the default is the DEFAULT version). Syntax
|
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
|
divideParcelGuid (Required) | The unique identifier (GUID) of the parcel being divided. Syntax
|
divideParcelType (Required) | The parcel type (layer ID) in which the new, divided parcels will be created. Syntax
|
record (Required) | The unique identifier (GUID) of the record being used for the divide. Syntax
|
divideOption (Required) | The type of division to be performed. Syntax
Values: ProportionalArea | EqualArea| EqualWidth |
divideNumberOfParts (Required) | The number of parts into which the parcel will be divided. Syntax
|
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
|
divideLineBearing (Required) | The direction (in decimal degrees) of the line used to divide the parcel. Syntax
|
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
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
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
Example using square feet:
Example using square meters:
|
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
|
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
|
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.- 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 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>
}
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
}