Lengths

polylines

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

Syntax

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

Example

1
2
3
4
5
6
7
8
9
10
11
12
13
[
  {
    "paths": [
      [[-117,34],[-116,34],[-117,33]],
      [[-115,44],[-114,43],[-115,43]]
    ]
  },
  {
    "paths": [
      [[32.49,17.83],[31.96,17.59],[30.87,17.01],[30.11,16.86]]
    ]
  }
]

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 polylines were directly embedded in the request.

URL-based syntax

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

URL-based example

1
polylines={"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 polylines. For a list of valid WKID values, see Using spatial references.

lengthUnit

Specifies the unit in which the lengths of the polylines are calculated. If calculationType is planar, lengthUnit can be an integer representing the well-known id (WKID) of any esriSRUnitType constant. If calculationType is planar and 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 Constants.

geodesic

If polylines are in a geographic coordinate system, geodesic must be set to true to calculate the ellipsoidal shortest-path distance between each pair of the vertices in the polylines. If lengthUnit is not specified, the output is returned in meters.

calculationType

Defines the length calculation for the geometry. The type can be one of the following values:

• planar — Planar measurements use 2D Euclidean distance to calculate length. Use this type only if the length needs to be calculated in the given spatial reference. Otherwise, use preserveShape.
• geodesic — Use this type to calculate a length using only the vertices of the polygon and define the lines between the vertices as geodesic segments independent of the actual shape of the polyline. A geodesic segment is the shortest path between two points on an earth ellipsoid.
• preserveShape — This type calculates the 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