- URL:
- https://<root>/<serviceName/ParcelFabricServer/transferParcel
- Methods:
POST
- Required Capability:
- ArcGIS Advanced Editing
- Version Introduced:
- 11.0
Description
The transfer
operation transfers a piece of land (single parcel) between source parcels and target parcels.
A piece of land (single parcel) can be transferred in the following supported workflows:
- A piece of land (one parcel) is transferred from a single source parcel to a single target parcel, for example, an annexation.
- A piece of land (one parcel) is transferred from multiple source parcels to a single target parcel, for example, road dedication (widening).
- A piece of land (one parcel) is transferred from a single source parcel to multiple target parcels, for example, road vacation.
- A piece of land (one parcel) is transferred to a single target parcel. There is no source parcel, for example, annexation of unincorporated land.
Learn more about transferring a parcel
Request parameters
Parameter | Details |
---|---|
(Required) | Introduced at 11.0. The name of the geodatabase version (the default is the Syntax
|
(Required) | Introduced at 11.0. The token (GUID) used to lock the version. If the calling client is editing a named version, the Syntax
|
(Required) | Introduced at 11.0. The parcel that defines the piece of land that will be transferred. Only one parcel can be specified as the transfer parcel. Syntax
|
(Optional) | Introduced at 11.0. The source parcels from which land will be transferred. These parcels will be clipped and will become smaller.
Syntax
|
(Required) | Introduced at 11.0. The target parcels to which land will be transferred. These parcels will be merged with the transfer parcel and will become larger.
Syntax
|
(Required) | Introduced at 11.0. The unique identifier (GUID) of the record being used for the transfer. Syntax
|
(Required) | Introduced at 11.0. The units in which area will be stored. The parameter value is a domain code from the Syntax
Example using square feet:
Example using square meters:
|
(Optoinal) | Introduced at 11.1. Specifies whether the request will be processed as an asynchronous job and a URL that points to a location displaying the status of the job will be returned. See the topic regarding asynchronous usage for more information. The default is Values: Syntax
|
| The response format. The default response format is Values: |
Example usage
This example shows the steps for transferring a parcel in a right-of-way dedication. In this type of transfer, a piece of land is transferred from multiple source parcels to a single target parcel.
-
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={c47be202-3682-4ab0-a730-9dd641487ba7}
-
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={c47be202-3682-4ab0-a730-9dd641487ba7}
-
Transfer one parcel of land from multiple source parcels to a single target parcel.
Request URL and parameters:
Use dark colors for code blocks Copy https://machine.domain.com/webadaptor/rest/services/CountyFabric/ParcelFabricServer/transferParcel f=json gdbVersion=admin.Version1 sessionId={c47be202-3682-4ab0-a730-9dd641487ba7} transferParcelFeature={"id":"{D664B654-D8F2-453C-966F-6FA66E1AE2E2}","layerId":"24"} sourceParcelFeatures=[{"id":"{8233045B-A337-4087-957A-4F8A4814FF09}","layerId":"15"},{"id":"{EC850938-01F4-48C6-B7DB-16EFB0B544BC}","layerId":"15"}, {"id":"{BCF8B086-B5DB-472A-89AA-6A3AF54C75BD}","layerId":"15"}] targetParcelFeatures=[{"id":"{449572F3-C2E1-405D-B642-4CFA90C10C46}","layerId":"21"}] record={89E0F2EE-9788-4008-9CD4-1F02ABDCD49F} defaultAreaUnit=109405 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
:
{
"moment": <datetime>,
"exceededTransferLimit: <true | false>,
"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>
}