Areas and Lengths

polygons

Specifies the array of polygons whose areas and lengths are to be computed. The spatial reference of the polygons is specified by sr. The structure of each polygon in the array is the same as the structure of the JSON polygon objects returned by ArcGIS REST API.

JSON structures:

Syntax:

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

Example:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
[
  {
    "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]]
    ]
  }
]

For a large set of geometries, you can specify a URL to the input geometries stored in a JSON structure in a file on a public server. The expected format of the file's contents will be the same as that expected if the polygons were directly embedded in the request.

URL-based syntax

1
polygons={"url":"<URL to file>"}

URL-based example

1
polygons={"url":"https://<myserver>/<mygeometries>/<afile.txt>"}

sr

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

lengthUnit

Specifies the length unit used to calculate the perimeters of the polygons. If calculationType is planar, lengthUnit can be an integer representing any well-known ID (WKID) of an esriSRUnitType constant. If lengthUnit is not specified, the units are derived from sr. If calculationType is not planar, lengthUnit must be a WKID of a linear esriSRUnitType constant, such as esriSRUnit_Kilometer (9036) or esriSRUnit_SurveyMile (9035). It cannot be an angular unit. If lengthUnit is not specified, the units are meters. For a list of valid units, see esriSRUnitType Constants and esriSRUnit2Type Constant.

areaUnit

Specifies the area unit used to calculate the areas of the polygons. If calculationType is planar, the areaUnit can be an integer representing the well-known id (WKID) of any esriSRUnitType constant or one of the additional values shown below. If areaUnit is not specified, the units are derived from sr. If calculationType is not planar, areaUnit must be a WKID of a linear esriSRUnitType constant, such as esriSRUnit_Kilometer (9036) or esriSRUnit_SurveyMile (9035), or one of the additional values shown below. It cannot be an angular unit. If areaUnit is not specified, the units are meters. For a list of valid units, see esriSRUnitType Constants and esriSRUnit2Type Constant.

Additional Values for areaUnit : esriSquareInches | esriSquareFeet | esriSquareYards | esriAcres | esriSquareMiles | esriSquareMillimeters | esriSquareCentimeters | esriSquareDecimeters | esriSquareMeters | esriAres | esriHectares | esriSquareKilometers

Syntax

If one of the additional values for the area unit is used, put it in JSON format.

1
{"areaUnit": "<esriAreaUnits>"}

Examples

1
{"areaUnit": "esriSquareFeet"}

1
{"areaUnit": "esriHectares"}

calculationType

Specifies the type defined for the area and length calculation of the input geometries. The type can be one of the following values:

• planar — Planar measurements use 2D Euclidean distance to calculate area and length. Use this type only if the area or length needs to be calculated in the given spatial reference. Otherwise, use preserveShape .
• geodesic — Use this type to calculate an area or length using only the vertices of the polygon and define the lines between the points as geodesic segments independent of the actual shape of the polygon. A geodesic segment is the shortest path between two points on an ellipsoid.
• preserveShape — This type calculates the area or length of the geometry on the surface of the earth ellipsoid. The shape of the geometry in its coordinate system is preserved.

f

The response format. The default response format is html .

Values: html | json | pjson