| FRAMES | NO FRAMES | Description | Parameters | Examples | Response |
| URL | http://<geometryservice-url>/areasAndLengths |
|---|---|
| Parent Resource | Geometry Service |
The areasAndLengths operation is performed on a geometry service resource. This operation calculates areas and perimeter lengths for each polygon specified in the input array.
You can provide arguments to the areasAndLengths operation as query parameters defined in the parameters table below.
| Parameter | Details |
|---|---|
| f | Description: The response format.
The default response format is html. Values: html | json |
| polygons | Description: 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 same as the structure of the JSON polygon objects returned by the
ArcGIS REST API. Syntax and Examples: JSON Structures:Syntax:[ <polygon1>, <polygon2> ] Example: [
{
"rings" : [
[[-117,34],[-116,34],[-117,33],[-117,34]],
[[-115,44],[-114,43],[-115,43],[-115,44]]
]
},
{
"rings" : [
[[32.49,17.83],[31.96,17.59],[30.87,17.01],[30.11,16.86],[32.49,17.83]]
]
}
]
URL based: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.
Syntax: |
| sr | Description: The well-known ID of
the spatial reference or a spatial reference json object for the input polygons. For a list of valid
WKID values, see Projected coordinate Systems
and Geographic coordinate Systems. |
| lengthUnit |
Description: The length unit in which perimeters of polygons will be calculated. It can be any esriUnits constant.
If unit is not specified, the units are derived from sr. For a list of valid units, see esriSRUnitTypeconstants and esriSRUnit2Type Constants.
|
| areaUnit |
Description: The area unit in which areas of polygons will be calculated. It can be any esriAreaUnits constant.
If unit is not specified, the units are derived from sr. For a list of valid units, see esriSRUnitTypeconstants and esriSRUnit2Type Constants.
The list of valid esriAreaUnits constants include, esriSquareInches | esriSquareFeet | esriSquareYards | esriAcres | esriSquareMiles | esriSquareMillimeters | esriSquareCentimeters | esriSquareDecimeters | esriSquareMeters | esriAres | esriHectares | esriSquareKilometers. JSON Structures: (When using an esriAreaUnits enumeration value)Syntax:{
Example: {
|
Example 1: In this example, the area and length of a polygon are calculated. The length is returned in miles and the area in acres.
http://sampleserver3.arcgisonline.com/ArcGIS/rest/services/Geometry/GeometryServer/areasAndLengths?{
"areas" : [ <area1>, <area2> ],
"lengths" : [ <length1>, <length2> ]
}
{
"areas" : [ 1.0, 0.167199999999997 ],
"lengths" : [ 6.82842712474619, 5.16125300726341 ]
}