Convex Hull

Description

The convexHull operation is performed on a geometry service resource. It returns the convex hull of the input geometries. The input geometries can be points, multipoints, polylines, or polygons, but they all must be the same type. The convex hull is typically a polygon but can also be a polyline or point in degenerate cases.

You can provide arguments to the convexHull operation as query parameters defined in the following parameters table.

Request parameters

1
2
3
4
{
  "geometryType" : "<esriGeometryPoint | esriGeometryMultipoint | esriGeometryPolyline | esriGeometryPolygon>"
  "geometries" : [ <geometry1>, <geometry1>, ..., <geometryN> ]
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
  "geometryType" : "esriGeometryPolyline",
    "geometries" :
  [
    {
      "paths" :
      [
        [[-117,34],[-116,34],[-117,33]],
        [[-115,44],[-114,43],[-115,43]]
      ]
    },
    {
      "paths" :
      [
        [[32,17],[31,17],[30,17],[30,16]]
      ]
    }
  ]
}

Example usage

The following is a decoded sample request URL (the actual URL must be encoded) for convexHull:

https://sampleserver6.arcgisonline.com/ArcGIS/rest/Utilities/services/Geometry/GeometryServer/convexHull?geometries={"geometryType":"esriGeometryPoint","geometries":[{"x":-117,"y":34},{"x":-116.5,"y":34.5},{"x":-116,"y":33}]}&sr=4326&f=html

JSON Response syntax

1
2
3
4
{
  "geometryType" : "<esriGeometryPoint | esriGeometryMultipoint | esriGeometryPolyline | esriGeometryPolygon>"
  "geometry" : { <geometry1> }
}

JSON Response example

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
 "geometryType": "esriGeometryPolygon",
 "geometry": {"rings": [[
  [
   -116,
   33
  ],
  [
   -117,
   34
  ],
  [
   -116.5,
   34.5
  ],
  [
   -116,
   33
  ]
 ]]}
}