Auto Complete

Description

The autoComplete operation is performed on a geometry service resource. The autoComplete operation simplifies the process of constructing new polygons that are adjacent to other polygons. It constructs polygons that fill in the gaps between existing polygons and a set of polylines.

At 10.1 and later, this operation calls simplify on the input polygons and polylines.

You can provide arguments to the autoComplete operation as query parameters defined in the following parameters table:

Request parameters

Parameter

Details

f

Description:  (Optional) The response format. The default response format is html.
Values:   html | json

polygons

Description: The array of polygons that will provide some boundaries for the new polygons. The spatial reference of the polygons is specified by sr. The structure of the polygon in the array is the same as the structure of the JSON polygon objects returned by the ArcGIS REST API.

JSON structures:

Syntax:

[ <polygon1>, <polygon2>, ..., <polygonN> ]

Example:

[
  {
    "rings" : 
    [
      [[-117,34],[-116,34],[-117,33],[-117,34]],
      [[-115,44],[-114,43],[-115,43],[-115,44]]
    ]
  },
  {
    "rings" : 
    [
      [[32,17],[31,17],[30,17],[30,16],[32,17]]
    ]
  }
]

polylines

Description: An array of polylines that will provide the remaining boundaries for new polygons. The spatial reference of the polylines is specified by sr. The structure of polylines in the array is the same as the structure of JSON polyline objects returned by the ArcGIS REST API.

JSON structures

Syntax:

[ <polyline1>, <polyline2>, ..., <polylineN>  ]

Example:

[
  {
    "paths" : 
    [
      [[-117,34],[-116,34],[-117,33]],
      [[-115,44],[-114,43],[-115,43]]
    ]
  },
  {
    "paths" : 
    [
      [[32,17],[31,17],[30,17],[30,16]]
    ]
  }
]

sr

Description: The well-known ID or a spatial reference JSON object for the input polygons and polylines. For a list of valid WKID values, see Projected coordinate systems and Geographic coordinate systems.

Example usage

This example constructs completion lines between two parts of a multipart polygon.

http://sampleserver6.arcgisonline.com/arcgis/rest/services/Utilities/Geometry/GeometryServer/autoComplete?sr=4269&polygons=[{"rings":[[[0,0],[110,0],[110,-60],[0,-60],[0,0]],[[120,0],[180,0],[180,-60],[120,-60],[120,0]]]}]&polylines=[{"paths":[[[109,0],[121,0]],[[109,-60],[121,-60]]]}]&f=html

JSON response syntax

{
  "geometries" : [ <geometry1>, <geometry1>, ..., <geometryN> ]
}

JSON response example

{"geometries": [{
 "rings": [[
  [
   120.00000000000011,
   -59.99999999999994
  ],
  [
   110.00000000000006,
   -59.99999999999994
  ],
  [
   110.00000000000006,
   5.6843418860808015E-14
  ],
  [
   120.00000000000011,
   5.6843418860808015E-14
  ],
  [
   120.00000000000011,
   -59.99999999999994
  ]
 ]],
 "spatialReference": {
  "wkid": 4269,
  "latestWkid": 4269
 }
}]}