Skip To Content
ArcGIS Developer
Dashboard

Remove Overlapping Centerlines

Description

License:

The ArcGIS Location Referencing license is required to use this resource.

This operation removes overlapping centerline sections to ensure there is one common centerline in cases where centerline geometry overlaps. Internally, it calls the Remove Overlapping Centerlines geoprocessing tool.

Request parameters

ParameterDetails
f

Optional parameter to specify the response format. The default response format is html.

Values: html | json

layerDefinition

Optional parameter to specify a list of Object IDs and a SQL WHEREclause defining the centerlines on which the operation will be performed. If this parameter is not specified, the operation will be run across the entire centerline feature class.

Syntax:


{
  "objectIds": [<objectId1>, <objectId2>, ...],
  "where": "field1 in ('<value1>', '<value2>', ...)"
}

Example:


{
  "objectIds": [1, 3, 5],
  "where": "centerlineId in ('{124EF4E1-D6D7-47CD-A993-6E036584742C}', '{7BC4E070-CD40-40B0-8F13-75C75B3A80CF}')"
}
gdbVersion

Optional parameter to specify the geodatabase version to use. If this parameter is not specified, the published map's version is used.

Syntax: gdbVersion=<version>

Example: gdbVersion="user1.version1"

sessionId

Optional parameter set by a client during long transaction editing on a branch version. The sessionId parameter value is a GUID that clients establish at the beginning and use throughout the edit session. The sessonId parameter ensures isolation during the edit session.

Syntax: sessionId=<guid>

Example: sessionId="{E81C2E2D-C6A7-40CB-BF61-FB499E53DD1D}"

returnEditMoment

Optional parameter to specify whether the response reports the time edits that were applied. If returnEditMoment=true, the server returns the time edits that were applied in the response's editMoment key. The default value is false.

Values: true|false

returnServiceEditsOption

Optional parameter that returns features edited due to the geodatabase behavior that results from applying the edits. For example, if a feature is deleted and it is the origin in a composite relationship, the destination feature is automatically deleted from the geodatabase. If returnServiceEditsOption is set to originalAndCurrentFeatures, the deleted destination feature is returned along with a reference to the deleted original feature in the response. Note that, even for deletions, the geometry and attributes of the edited feature are returned.

Results returned from applyEdits are organized layer by layer. If returnServiceEditsOption is set to originalAndCurrentFeatures, each layer can have edited features returned in an editedFeatures object.

Service-level applyEdits response structure:


[
  {
    id
    addResults
    updateResults
    deleteResults
    attachments: {
      addResults
      updateReults
      deleteResults
    }
    editMoment
    editedFeatures
    exceededTransferLimit
  },
  {
  ...
  }
]

The editedFeatures object returns full features, including the original features prior to deletion, the original and current features for updates, and the current rows for inserts that can contain implicit changes (for example, as a result of a calculation rule).

editedFeatures response structure:


{
  "editedFeatures": [
    {
      "adds": [ <feature1>, <feature2>], 	// current features
      "updates": [[<originalFeature3>, < currentFeature3>], [<originalFeature4>, < currentFeature4>]],
      "deletes": [ <feature5>, <feature6>]	// original features
    },
  ]
}

The response includes no editedFeatures values and exceededTransferLimit=true if the count of edited features to return is more than the maxRecordCount value. If clients are using this parameter to maintain a cache, they should invalidate the cache when exceededTransferLimit=true is returned. If the server encounters an error when generating the list of edits in the response, exceededTransferLimit=true is also returned.

Edited features are returned in the spatial reference of the feature service as defined by the services spatialReference object or by the spatialReference value of the layers extent object.

The default value is none, which does not include editedFeatures values.

Values: none|originalAndCurrentFeatures

Example usage

The following examples demonstrate how to remove overlapping centerlines from a selection or all of the centerline feature class.

Example 1

The following call removes overlaps from the entire centerline feature class.

https://sampleserver/server/rest/services/MyLRS/MapServer/exts/LRServer/centerlineLayers/4/removeOverlappingCenterlines?layerDefinition=&gdbVersion=SDE.test1&sessionId={91FB4126-F4D8-410E-96A2-000E8463A8A4}&returnServiceEditsOption=originalAndCurrentFeatures&returnEditMoment=true&f=json

Example 2

The following call removes overlaps from a selection set on the centerline feature class.

https://sampleserver/server/rest/services/MyLRS/MapServer/exts/LRServer/centerlineLayers/4/removeOverlappingCenterlines?layerDefinition={"objectIds":[866,867,868,869,871,2816]}&gdbVersion=SDE.test1&sessionId={91FB4126-F4D8-410E-96A2-000E8463A8A4}&returnServiceEditsOption=originalAndCurrentFeatures&returnEditMoment=true&f=json

JSON response syntax

Query this job URL to get progress updates and results of the operation.


{
  "statusURL": "<jobIdURL>"
}

JSON response example


{
  "statusURL": "https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/jobs/j3c0a00b4314349eb8e4ff6ff7ac2db5d"
}