Convex Hull

URL:: https://<root>/Utilities/Geometry/GeometryServer/convexHull
Methods:: GET
Version Introduced:: 10.0

Description

The convexHull operation is performed on a geometry service resource. It returns the convex hull of the input geometry. The input geometry can be a point, multipoint, polyline, or polygon. 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

Parameter Details

Parameter	Details
`geometries`	Specifies the geometries whose convex hull is to be created. The structure of each geometry is the same as the structure of the JSON geometry objects returned by ArcGIS REST API. Syntax: Use dark colors for code blocksCopy `1 2 3 4 { "geometryType" : "<esriGeometryPoint \| esriGeometryMultipoint \| esriGeometryPolyline \| esriGeometryPolygon>" "geometries" : [ <geometry1>, <geometry1>, ..., <geometryN> ] }` Example: Use dark colors for code blocksCopy `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]] ] } ] }`
`sr`	Specifies the well-known ID (WKID) or a spatial reference JSON object for the output `geometry`. For a list of valid WKID values, see Using spatial references.
`f`	The response format. The default response format is `html`. Values: `html` \| `json` \| `pjson`

geometries

Specifies the geometries whose convex hull is to be created. The structure of each geometry is the same as the structure of the JSON geometry objects returned by ArcGIS REST API.

Syntax:

Use dark colors for code blocksCopy
{
  "geometryType" : "<esriGeometryPoint | esriGeometryMultipoint | esriGeometryPolyline | esriGeometryPolygon>"
  "geometries" : [ <geometry1>, <geometry1>, ..., <geometryN> ]
}

Example:

Use dark colors for code blocksCopy
{
  "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]]
      ]
    }
  ]
}

sr

Specifies the well-known ID (WKID) or a spatial reference JSON object for the output geometry. For a list of valid WKID values, see Using spatial references.

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

The following is a sample request URL for convexHull:

Use dark colors for code blocksCopy
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=pjson

JSON Response syntax

Use dark colors for code blocksCopy
{
  "geometryType" : "<esriGeometryPoint | esriGeometryMultipoint | esriGeometryPolyline | esriGeometryPolygon>"
  "geometry" : { <geometry1> }
}

JSON Response example

Use dark colors for code blocksCopy
{
  "geometryType": "esriGeometryPolygon",
  "geometry": {
    "rings": [
      [
        [
          -116,
          33
        ],
        [
          -117,
          34
        ],
        [
          -116.5,
          34.5
        ],
        [
          -116,
          33
        ]
      ]
    ]
  }
}