Geometry functions

The following functions allow you to create, compare, measure, and analyze geometries. The spatial reference of all geometries either input or created by any of these functions must match the spatial reference of the profile's context, which controls the execution of the expression.

Angle

This function has 2 signatures:

• Since v1.7 - Angle(pointA, pointB) -> Number
• Since v1.7 - Angle(pointA, pointB, pointC) -> Number

Angle(pointA, pointB) -> Number

Since version 1.7

Function bundle: Geometry

Returns the arithmetic angle of a line between two points in degrees (0 - 360). The angle is measured in a counter-clockwise direction relative to east. For example, an angle of 90 degrees points due north.

Only the x-y plane is considered for the measurement. Any z-coordinates are ignored. Point features can be used instead of any or both Point geometries. If the points are identical, then an angle of 0 degrees is returned.

Parameters

• pointA: Point | Feature - The first Point or Feature used to calculate the angle.
• pointB: Point | Feature - The second Point or Feature used to calculate the angle.

Return value: Number

Example

Returns the angle from a Point to a Feature, in degrees

1
2
var pointA = Point({ "x":976259, "y":8066511, "spatialReference": { "wkid": 3857 } });
Angle(pointA, $feature)

Angle(pointA, pointB, pointC) -> Number

Since version 1.7

Function bundle: Geometry

Returns the arithmetic angle of a line between three points in degrees (0 - 360). The angle is measured around pointB in a counter-clockwise direction, from pointA to pointC.

Only the x-y plane is considered for the measurement. Any z-coordinates are ignored. Point features can be used instead of either or all Point geometries. If the points are identical, then an angle of 0 or 180 degrees is returned (depending internal arithmetic).

Parameters

• pointA: Point | Feature - The first Point or Feature used to calculate the angle.
• pointB: Point | Feature - The second Point or Feature used to calculate the angle.
• pointC: Point | Feature - The third Point or Feature used to calculate the angle.

Return value: Number

Example

Returns the angle between two points around the feature, in degrees

1
2
3
var pointA = Point({ "x":976259, "y":8066511, "spatialReference": { "wkid": 3857 } });
var pointC = Point({ "x":308654, "y":9005421, "spatialReference": { "wkid": 3857 } });
Angle(pointA, $feature, pointC)

Area

Area(polygon, unit?) -> Number

Since version 1.7

Function bundle: Geometry

Returns the area of the input geometry or Feature in the given units. This is a planar measurement using Cartesian mathematics.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• polygon: Polygon | Feature | Array<Point> - The Polygon or Feature for which to calculate the planar area.
• unit (Optional): Text | Number - Measurement unit of the return value. This may be one of the possible values below, or one of the numeric codes listed in the additional resources section below.
  Possible values: acres | square-feet | hectares | square-kilometers | square-miles | square-nautical-miles | square-meters | square-yards

Return value: Number

Additional resources

• AreaGeodetic()
• Available numeric codes for unit parameter
• More available numeric codes for unit parameter

Example

Returns the area of the feature in square meters

1
Area($feature, 'square-meters')

AreaGeodetic

AreaGeodetic(polygon, unit?) -> Number

Since version 1.7

Function bundle: Geometry

Returns the geodetic area of the input geometry or Feature in the given units. This is more reliable measurement of area than Area() because it takes into account the Earth's curvature. Support is limited to geometries with a Web Mercator (wkid 3857) or a WGS 84 (wkid 4326) spatial reference.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• polygon: Polygon | Feature | Array<Point> - The Polygon or Feature for which to calculate the geodetic area.
• unit (Optional): Text | Number - Measurement unit of the return value. This may be one of the possible values below, or one of the numeric codes listed in the additional resources section below.
  Possible values: acres | square-feet | hectares | square-kilometers | square-miles | square-nautical-miles | square-meters | square-yards

Return value: Number

Additional resources

• Area()
• Available numeric codes for unit parameter
• More available numeric codes for unit parameter

Example

Returns the geodetic area of the feature in square meters

1
AreaGeodetic($feature, 'square-meters')

Bearing

This function has 2 signatures:

• Since v1.7 - Bearing(pointA, pointB) -> Number
• Since v1.7 - Bearing(pointA, pointB, pointC) -> Number

Bearing(pointA, pointB) -> Number

Since version 1.7

Function bundle: Geometry

Returns the geographic angle of a line between two points in degrees (0 - 360). The bearing is measured in a clockwise direction relative to north. For example, a bearing of 225 degrees represents a southwest orientation.

Only the x-y plane is considered for the measurement. Any z-coordinates are ignored. Point features can be used instead of either or both Point geometries. If the points are identical, then an angle of 0 is returned.

Parameters

• pointA: Point | Feature - The first point used to calculate the bearing.
• pointB: Point | Feature - The second point used to calculate the bearing.

Return value: Number

Example

Returns the bearing from a point to the feature, in degrees

1
2
var pointA = Point({ "x":976259, "y":8066511, "spatialReference": { "wkid": 3857 } });
Bearing(pointA,$feature)

Bearing(pointA, pointB, pointC) -> Number

Since version 1.7

Function bundle: Geometry

Returns the geographic angle of a line between three points in degrees (0 - 360). The bearing is measured around pointB in a clockwise direction, from pointA to pointC.

Only the x-y plane is considered for the measurement. Any z-coordinates are ignored. Point features can be used instead of any or all Point geometries. If the points are identical, then an angle of 0 or 180 degrees is returned (depending internal arithmetic).

Parameters

• pointA: Point | Feature - The first point used to calculate the bearing.
• pointB: Point | Feature - The second point used to calculate the bearing.
• pointC: Point | Feature - The third point used to calculate the bearing.

Return value: Number

Example

Returns the bearing between two points around the feature, in degrees

1
2
3
var pointA = Point({ "x":976259, "y":8066511, "spatialReference": { "wkid": 3857 } });
var pointC = Point({ "x":308654, "y":9005421, "spatialReference": { "wkid": 3857 } });
Bearing(pointA,$feature,pointC)

Buffer

Buffer(inputGeometry, distance, unit?) -> Polygon

Since version 1.3

Function bundle: Geometry

Returns the planar (or Euclidean) buffer at a specified distance around the input geometry. This is a planar measurement using Cartesian mathematics.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature - The geometry to buffer.
• distance: Number - The distance to buffer from the geometry.
• unit (Optional): Text | Number - Measurement unit of the buffer distance. This may be one of the possible values below, or one of the numeric codes listed in the additional resources section below. For the visualization, labeling, and popup profiles, the default unit is the map's spatial reference. In other profiles, like field calculation, the default is based on the spatial reference of the data.
  Possible values: feet | kilometers | miles | nautical-miles | meters | yards

Return value: Polygon

Additional resources

• BufferGeodetic()
• Available numeric codes for unit parameter
• More available numeric codes for unit parameter

Example

Returns a polygon representing a 1/2-mile buffer around the input geometry

1
Buffer($feature, 0.5, 'miles')

BufferGeodetic

BufferGeodetic(inputGeometry, distance, unit?) -> Polygon

Since version 1.3

Function bundle: Geometry

Returns the geodetic buffer at a specified distance around the input geometry. This is a geodetic measurement, which calculates distances on an ellipsoid. Support is limited to geometries with a Web Mercator (wkid 3857) or a WGS 84 (wkid 4326) spatial reference.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature - The geometry to buffer.
• distance: Number - The distance to buffer from the geometry.
• unit (Optional): Text | Number - Measurement unit of the buffer distance. This may be one of the possible values below, or one of the numeric codes listed in the additional resources section below. For the visualization, labeling, and popup profiles, the default unit is the map's spatial reference. In other profiles, like field calculation, the default is based on the spatial reference of the data.
  Possible values: feet | kilometers | miles | nautical-miles | meters | yards

Return value: Polygon

Additional resources

• Buffer()
• Available numeric codes for unit parameter
• More available numeric codes for unit parameter

Example

Returns a polygon representing a 1/2-mile buffer around the input geometry

1
BufferGeodetic($feature, 0.5, 'miles')

Centroid

Centroid(polygon) -> Point

Since version 1.7

Function bundle: Geometry

Returns the centroid of the input geometry.

Parameter

• polygon: Polygon | Feature | Array<Point> - The polygon or array of points composing a polygon.

Return value: Point

Examples

Returns the centroid of the given polygon

1
Centroid($feature)

Returns the centroid of the given polygon ring

1
2
var ringPoints = Geometry($feature).rings[0];
Centroid(ringPoints);

Clip

Clip(inputGeometry, envelope) -> Geometry

Since version 1.3

Function bundle: Geometry

Calculates the clipped geometry from a target geometry by an envelope.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature - The geometry to be clipped.
• envelope: Extent - The envelope used to clip the geometry.

Return value: Geometry

Example

Returns the area of the clipped geometry

1
2
var envelope = Extent({ ... });
Area(Clip($feature, envelope), 'square-miles');

Contains

Contains(containerGeometry, insideGeometry) -> Boolean

Since version 1.7

Function bundle: Geometry

Indicates if one geometry contains another geometry. In the graphic below, the red highlight indicates the scenarios where the function will return true.

Be aware that using $feature as input to this function will yield results only as precise as the view's scale resolution. Therefore values returned from expressions using this function may change after zooming between scales.

Parameters

• containerGeometry: Geometry | Feature - The geometry that is tested for the 'contains' relationship to insideGeometry. Think of this geometry as the potential 'container' of the insideGeometry.
• insideGeometry: Geometry | Feature - The geometry that is tested for the 'within' relationship to the containerGeometry.

Return value: Boolean

Example

Returns true if the feature is contained within the given polygon

1
2
var container = Polygon({ ... });
Contains(containerGeometry, $feature);

ConvertDirection

ConvertDirection(input, inputSpec, outputSpec) -> Array<Number | Text> | Number | Text

Since version 1.13

Function bundle: Geometry

Angles can have several interpretations and can be represented as a number, a text, or a well formed array. This function takes one input representation and converts it to another.

The input value is described by a dictionary that specified the type of angle and the type of direction. Examples:

If the angleType and directionType are not appropriate for the input, then the conversion will fail.

The desired output value is as well described by a dictionary that specidies output type, angle type, direction type, and an optional format for text ouput.

If the output type is value:

• an array will be returned for angle type dms or for direction type quadrant
• a number will be returned for all the other cases

If the output type is text, then default padding and delimeters will be used unless the optionalformat property is provided.
format controls order, spacing, padding, and delimeters in the output text.
Strings of format specifier characters before a decimal point indicate minimum padding (e.g. DDD -> 000).
Strings of format characters after a decimal point indicate precision (e.g. D.DD -> 0.00).

Supported format characters:

For dms formatting, if the s is not used then m will round to the nearest minute. Similarly, if m is not used then d will round.

Parameters

• input: Array<Number | Text> | Number | Text - A raw representation of the bearing. The type of input and the values of the inputSpec dictate how the input is parsed.

• inputSpec: Dictionary - Contains information about how to interpret input.

  • angleType: Text - Describes the input angle unit. Supported Values: DEGREES, DMS, RADIANS, GONS, GRADIANS
  • directionType: Text - Describes the input bearing's meridian and direction. Supported Values: NORTH, SOUTH, POLAR, QUADRANT

• outputSpec: Dictionary - Contains information about how to format the output.

  • outputType: Text - Controls output type. Supported Values: value, text
  • angleType: Text - Describes the output angle unit. Supported Values: DEGREES, DMS, RADIANS, GONS, GRADIANS
  • directionType: Text - Describes the output bearing's meridian and direction. Supported Values: NORTH, SOUTH, POLAR, QUADRANT
  • format (Optional): Text - Controls text formatting. Only applicable if outputType is text.

Return value: Array<Number | Text> | Number | Text

Examples

Examples where the outputType is value.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
ConvertDirection( 30, {directionType:'North', angleType: 'Degrees'}, {directionType:'Quadrant', angleType: 'DMS', outputType: 'value'})
// returns ['N', 30, 0, 0, 'E']

ConvertDirection( 25.99, {directionType:'North', angleType : 'Gradians'}, {directionType:'North', outputType: 'value', angleType : 'Gradians'})
// returns 25.99

ConvertDirection( 1, {directionType:'North', angleType: 'DEGREES'}, {directionType: 'Quadrant', angleType: 'Degrees', outputType: 'value'})
// returns ['N',1,'E']

ConvertDirection( 0.9, {directionType: 'North', angleType: 'degrees'}, {directionType:'North', angleType: 'gradians', outputType: 'value'})
// returns 1.0

ConvertDirection( 180.0, {directionType:'North', angleType: 'degrees'}, {directionType:'North', angleType: 'radians', outputType : 'value'})
// returns PI

Examples where outputType is text.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
ConvertDirection( 25.34, {directionType: 'North', angleType: 'DEGREES'}, {directionType:'North', outputType: 'text', format: 'DDDD.D'})
// returns '0025.3'

ConvertDirection( 25.34, {directionType: 'North', angleType: 'DEGREES'}, {directionType:'North', outputType: 'text', format: 'R'})
// returns '0'

ConvertDirection( 25.34, {directionType: 'North', angleType: 'DEGREES'}, {directionType:'North', outputType: 'text', format: '[DD.DD]'})
// returns 'DD.DD'

ConvertDirection( 25.34, {directionType:'North', angleType: 'DEGREES'}, {directionType:'quadrant', outputType: 'text', format: 'P B'})
// returns 'North East'

ConvertDirection( [001,01,59.99], {directionType:'North', angleType: 'DMS'}, {directionType:'North', angleType: 'DMS', outputType: 'text', format: 'dddA mm[B] ssC'})
// returns '001A 02B 00C'

ConvexHull

ConvexHull(inputGeometry) -> Geometry

Since version 1.19

Function bundle: Geometry

Calculates the convex hull of a geometry. A convex hull is the smallest convex polygon that encloses a geometry. The hull is typically a polygon but can also be a polyline or a point in degenerate cases.

Be aware that using $feature as input to this function will yield results only as precise as the view's scale resolution. Therefore values returned from expressions using this function may change after zooming between scales.

Parameter

• inputGeometry: Geometry | Feature - The point, line, or polygon geometry to be analyzed.

Return value: Geometry

Examples

Returns the number of vertices in the convex hull geometry of the current feature's geometry

1
Count(ConvexHull(Geometry($feature)).Rings[0])

Returns the convex hull of a geometry which has a concave region (which the convex hull will ignore)

1
2
3
4
5
6
var pacman_like_shape = Polygon({
       "rings": [[[1, 2], [2, 0], [1, -2], [-1, -2], [-2, -1], [-1, -1.5], [0, -1.5], [-2, 1], [-1, 2]]],
       "spatialReference": { "wkid": 3857 }
});
return ConvexHull(pacman_like_shape).rings[0];
// Returns the geometry [[1,2],[2,0],[1,-2],[-1,-2],[-2,-1],[-2,1],[-1,2],[1,2]]

Crosses

Crosses(geometry1, geometry2) -> Boolean

Since version 1.3

Function bundle: Geometry

Indicates if one geometry crosses another geometry. In the graphic below, the red highlight indicates the scenarios where the function will return true.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• geometry1: Geometry | Feature - The geometry to cross.
• geometry2: Geometry | Feature - The geometry being crossed.

Return value: Boolean

Example

Returns true if the feature crosses the given polygon

1
2
var geom2 = Polygon({ ... });
Crosses($feature, geom2);

Cut

Cut(polylineOrPolygon, cutter) -> Array<Geometry>

Since version 1.3

Function bundle: Geometry

Splits the input Polyline or Polygon where it crosses a cutting Polyline. For Polylines, all resulting left cuts are grouped together in the first Geometry. Right cuts and coincident cuts are grouped in the second Geometry. Each undefined cut, along with any uncut parts, are output as separate Polylines.

For Polygons, all resulting left cuts are grouped in the first Polygon, all right cuts are grouped in the second Polygon, and each undefined cut, along with any left-over parts after cutting, are output as a separate Polygon. If no cuts are returned then the array will be empty. An undefined cut will only be produced if a left cut or right cut was produced and there was a part left over after cutting, or a cut is bounded to the left and right of the cutter.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• polylineOrPolygon: Polyline | Polygon | Feature - The geometry to cut.
• cutter: Polyline | Feature - The Polyline used to cut the geometry.

Return value: Array<Geometry>

Example

Cuts the feature's geometry with the given polyline

1
2
var cutter = Polyline({ ... });
Cut($feature, cutter));

DefaultValue

This function has 2 signatures:

• Since v1.26 - DefaultValue(container, key, defaultValue) -> Any
• Since v1.0 - DefaultValue(container, keys, defaultValue) -> Any

DefaultValue(container, key, defaultValue) -> Any

Since version 1.26

Function bundle: Core

Returns a specified default value if a key in a geometry does not exist or the value at the specified key is null or an empty text value.

Parameters

• container: Geometry - The input geometry to check.
• key: Text - The key to check.
• defaultValue: Any - This value is returned if the key does not exist or the value at the specified key is null or an empty text value.

Return value: Any
Returns the value at the specified key if defined. Otherwise, returns the value specified in defaultValue.

Examples

Point that has a z-value

1
2
3
DefaultValue(Geometry($feature), "z", 1000)
// Geometry($feature).hasZ is true
// returns the value of Geometry($feature).z

Point that does not have a z-value

1
2
3
DefaultValue(Geometry($feature), "z", 1000)
// Geometry($feature).hasZ is false
// returns 1000

DefaultValue(container, keys, defaultValue) -> Any

Since version 1.0

Function bundle: Core

Returns a specified default value if at least one of the keys in a geometry's nested properties does not exist or the value at the specified key is null or an empty text value.

Parameters

• container: Geometry - The input geometry to check.
• keys: Array<Number | Text> - An array of the keys or indexes to check in each level of the container's structure.
• defaultValue: Any - This value is returned if at least one of the keys or indices does not exist or the value at the specified key is null or an empty text value.

Return value: Any
Returns the value at the specified key or index if defined. Otherwise, returns the value specified in defaultValue.

Examples

Ring, coordinate, and x value all exist and have a value

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// polygon with one ring
var shape = Polygon({
  rings: [[
    Point({ x: -97.06138, y: 32.837, z: 100, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06133, y: 32.836, z: 50, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06124, y: 32.834, z: 20, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06127, y: 32.832, z: 0, hasZ: true, spatialReference: { wkid: 102100 } })
  ]],
  hasZ: true,
  spatialReference: { wkid: 102100 }
});

return DefaultValue(shape, ["rings",0,0,"z"], 1000)
// returns 100

Ring does not exist

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// polygon with one ring
var shape = Polygon({
  rings: [[
    Point({ x: -97.06138, y: 32.837, z: 100, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06133, y: 32.836, z: 50, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06124, y: 32.834, z: 20, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06127, y: 32.832, z: 0, hasZ: true, spatialReference: { wkid: 102100 } })
  ]],
  hasZ: true,
  spatialReference: { wkid: 102100 }
});

return DefaultValue(shape, ["rings",2,0,"z"], 1000)
// returns 1000

Ring and coordinate exist, but m-value does not exist

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// polygon with one ring
var shape = Polygon({
  rings: [[
    Point({ x: -97.06138, y: 32.837, z: 100, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06133, y: 32.836, z: 50, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06124, y: 32.834, z: 20, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06127, y: 32.832, z: 0, hasZ: true, spatialReference: { wkid: 102100 } })
  ]],
  hasZ: true,
  spatialReference: { wkid: 102100 }
});

return DefaultValue(shape, ["rings",0,0,"m"], 100)
// returns 100

Densify

Densify(inputGeometry, maxSegmentLength, unit?) -> Geometry

Since version 1.11

Function bundle: Geometry

Densifies geometries by inserting vertices to create segments no longer than the specified interval.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature - The input geometry to be densified.
• maxSegmentLength: Number - The maximum segment length allowed. Must be a positive value.
• unit (Optional): Text | Number - Measurement unit for maxSegmentLength. Defaults to the units of the input geometry. This may be one of the possible values below, or one of the numeric codes listed in the additional resources section below. For the visualization, labeling, and popup profiles, the default unit is the map's spatial reference. In other profiles, like field calculation, the default is based on the spatial reference of the data.
  Possible values: feet | kilometers | miles | nautical-miles | meters | yards

Return value: Geometry

Additional resources

• DensifyGeodetic()
• Available numeric codes for unit parameter
• More available numeric codes for unit parameter

Example

Returns the densified geometry with a maximum segment length of 10 m

1
2
var maxLength = 10;
Densify($feature, maxLength, 'meters');

DensifyGeodetic

DensifyGeodetic(inputGeometry, maxSegmentLength, unit?) -> Geometry

Since version 1.11

Function bundle: Geometry

Creates a geodesic between each of the input geometry's vertices and densifies the output geometry with additional vertices to create segments no longer than the specified interval.

Be aware that using $feature as input to this function will yield results only as precise as the view's scale resolution. Therefore values returned from expressions using this function may change after zooming between scales.

Parameters

• inputGeometry: Geometry | Feature - The input geometry to be densified.
• maxSegmentLength: Number - The maximum segment length allowed. Must be a positive value.
• unit (Optional): Text | Number - Measurement unit for maxSegmentLength. Defaults to the units of the input geometry. This may be one of the possible values below, or one of the numeric codes listed in the additional resources section below. For the visualization, labeling, and popup profiles, the default unit is the map's spatial reference. In other profiles, like field calculation, the default is based on the spatial reference of the data.
  Possible values: feet | kilometers | miles | nautical-miles | meters | yards

Return value: Geometry

Additional resources

• Densify()
• Available numeric codes for unit parameter
• More available numeric codes for unit parameter

Example

Returns the densified geometry with a maximum segment length of 10000

1
DensifyGeodetic($feature, 10000, 'meters');

Difference

Difference(inputGeometry, subtractor) -> Geometry

Since version 1.3

Function bundle: Geometry

Performs the topological difference operation for the two geometries. The resultant geometry comes from inputGeometry, not the subtractor. The dimension of subtractor has to be equal to or greater than that of inputGeometry.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature - The input geometry from which to subtract.
• subtractor: Geometry | Feature - The geometry to subtract from geometry.

Return value: Geometry

Example

Subtracts the given polygon area from the feature.

1
2
var subtractor = Polygon({ ... });
Difference($feature, subtractor);

Disjoint

Disjoint(geometry1, geometry2) -> Boolean

Since version 1.3

Function bundle: Geometry

Indicates if one geometry is disjoint (doesn't intersect in any way) with another geometry. In the table below, the red highlight indicates that the function would return true with the specified geometries.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• geometry1: Geometry | Feature - The base geometry that is tested for the 'disjoint' relationship to geometry2.
• geometry2: Geometry | Feature - The comparison geometry that is tested for the 'disjoint' relationship to geometry1.

Return value: Boolean

Example

Returns true if the geometries don't intersect

1
2
var geom2 = Polygon({ ... });
Disjoint($feature, geom2);

Distance

Distance(geometry1, geometry2, unit?) -> Number

Since version 1.7

Function bundle: Geometry

Returns the planar distance between two geometries in the given units. This is a planar measurement using Cartesian mathematics.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• geometry1: Geometry | Feature | Array<Point> - The geometry used to measure the distance from geometry2.
• geometry2: Geometry | Feature | Array<Point> - The geometry used to measure the distance from geometry1.
• unit (Optional): Text | Number - Measurement unit of the return value. This may be one of the possible values below, or one of the numeric codes listed in the additional resources section below. For the visualization, labeling, and popup profiles, the default unit is the map's spatial reference. In other profiles, like field calculation, the default is based on the spatial reference of the data.
  Possible values: feet | kilometers | miles | nautical-miles | meters | yards

Return value: Number

Additional resources

• DistanceGeodetic()
• Available numeric codes for unit parameter
• More available numeric codes for unit parameter

Example

Returns the distance between two geometries in meters

1
2
var geom2 = Point({ ... });
Distance($feature, geom2, 'meters')

DistanceGeodetic

DistanceGeodetic(point1, point2, unit?) -> Number

Since version 1.8

Function bundle: Geometry

Calculates the shortest distance between two points along a great circle. Applies only to points with a Geographic Coordinate System (GCS) or the Web Mercator spatial reference. If the input points have a Projected Coordinate System (other than Web Mercator), you should use the Distance() function.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• point1: Point | Feature - The point used to measure the distance from point2. This point must have a GCS or Web Mercator spatial reference.
• point2: Point | Feature - The point used to measure the distance from point1. This point must have a GCS or Web Mercator spatial reference.
• unit (Optional): Text | Number - Measurement unit of the return value. This may be one of the possible values below, or one of the numeric codes listed in the additional resources section below. For the visualization, labeling, and popup profiles, the default unit is the map's spatial reference. In other profiles, like field calculation, the default is based on the spatial reference of the data.
  Possible values: feet | kilometers | miles | nautical-miles | meters | yards

Return value: Number

Additional resources

• Distance()
• Available numeric codes for unit parameter
• More available numeric codes for unit parameter

Example

Returns the distance from a bus in a stream layer to the central station in kilometers

1
2
var unionStation = Point({"x": -118.15, "y": 33.80, "spatialReference": { "wkid": 3857 }});
distanceGeodetic($feature, unionStation, 'kilometers');

DistanceToCoordinate

DistanceToCoordinate(inputLine, inputDistance) -> Dictionary

Since version 1.26

Function bundle: Geometry

Returns a coordinate along an input line based on a given distance. All parts of the line are considered when attempting to find a coordinate at the given distance. The distance does not include gaps between paths (or parts) of the line. If the distance is not found along the input line, then the result will be null.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputLine: Polyline | Array<Point> | Feature - The line or path from which to find a coordinate. When using a Feature as input, the feature's geometry must be a polyline.
• inputDistance: Number - The distance used to find the coordinate along inputLine from the start of the line. All parts of the line are considered when attempting to find a coordinate at the given distance. The distance does not include gaps between paths (or parts) of the line.

Return value: Dictionary
Returns a dictionary with the following properties. If the distance is not found along the input line, then the result will be null.

• coordinate: Point - The coordinates of a point along inputLine based on the given distance value.
• partId: Number - In the case of a polyline input, the index of the path to which the coordinate belongs.
• segmentId: Number - The index (relative to the path) of the line segment to which the coordinate belongs. If coordinate represents a vertex of the input line, then segmentId will return the index of the previous vertex. If coordinate is the first vertex of inputLine, then the value of segmentId will be 0.

Example

Returns the coordinate of the input polyline based on the given distance value

1
2
3
var result = DistanceToCoordinate($feature, 1038);

return result.coordinate;

EnvelopeIntersects

EnvelopeIntersects(geometry1, geometry2) -> Boolean

Since version 1.11

Function bundle: Geometry

Indicates if the envelope (or extent) of one geometry intersects the envelope of another geometry. In the graphic below, the red highlight indicates the scenarios where the function will return true.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• geometry1: Geometry | Feature - The geometry that is tested for the intersects relationship to the other geometry.
• geometry2: Geometry | Feature - The geometry being intersected.

Return value: Boolean

Example

Returns true if the geometries intersect

1
2
var geom2 = Polygon({ ... });
EnvelopeIntersects($feature, geom2);

Equals

Equals(geometry1, geometry2) -> Boolean

Since version 1.3

Function bundle: Geometry

Indicates if two geometries are equal, or geographically equivalent given the spatial reference and tolerance of the data. The two input geometries don't have to be clones to be considered equal.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. Geometry($feature)) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• geometry1: Geometry - The first input geometry.
• geometry2: Geometry - The second input geometry.

Return value: Boolean

Example

Returns true if the geometries are equal

1
2
var geom2 = Point({ ... });
Equals(Geometry($feature), geom2);

Extent

This function has 3 signatures:

• Since v1.0 - Extent(geometryDefinition) -> Extent
• Since v1.0 - Extent(inputGeometry) -> Extent
• Since v1.0 - Extent(jsonDefinition) -> Extent

Extent(geometryDefinition) -> Extent

Since version 1.0

Function bundle: Geometry

Constructs an Extent object from a dictionary.

Parameter

• geometryDefinition: Dictionary - The properties from which to construct the Extent geometry object.

  • xMax: Number - The upper bound, or largest possible x-coordinate of the geometry.

  • xMin: Number - The lower bound, or smallest possible x-coordinate of the geometry.

  • yMax: Number - The upper bound, or largest possible y-coordinate of the geometry.

  • yMin: Number - The lower bound, or smallest possible y-coordinate of the geometry.

  • mMax: Number - The upper bound, or largest possible m-value of the geometry. If setting this value, then you must set hasM to true.

  • mMin: Number - The lower bound, or smallest possible m-value of the geometry. If setting this value, then you must set hasM to true.

  • zMax: Number - The upper bound, or largest possible z-value of the geometry. If setting this value, then you must set hasZ to true.

  • zMin: Number - The lower bound, or smallest possible z-value of the geometry. If setting this value, then you must set hasZ to true.

  • hasM: Boolean - Indicates if the geometry has m-values.

  • hasZ: Boolean - Indicates if the geometry has z-values.

  • spatialReference: Dictionary - The spatial reference of the geometry.

    • wkid: Number - The Well-known ID of the geographic or projected coordinate system that defines the reference for which to draw the geometry.

Return value: Extent

Example

Creates an Extent object

1
2
3
4
5
6
7
8
9
Extent({
  xMax: -95.34,
  xMin: -97.06138,
  yMax: 32.837,
  yMin: 12.003,
  hasM: false,
  hasZ: false,
  spatialReference: { wkid: 3857 }
});

Extent(inputGeometry) -> Extent

Since version 1.0

Function bundle: Geometry

Returns the extent of an input Feature, Polygon, Point, Polyline or Multipoint.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameter

• inputGeometry: Geometry | Feature - The Feature or Geometry from which to get an extent.

Return value: Extent

Example

Returns the extent of a feature

1
Extent($feature);

Extent(jsonDefinition) -> Extent

Since version 1.0

Function bundle: Geometry

Constructs an Extent object from serialized JSON text. The JSON schema must follow the ArcGIS REST API JSON specification for Envelope objects.

Parameter

• jsonDefinition: Text - The JSON text from which to construct the extent object.

Return value: Extent

Additional resources

• ArcGIS REST API JSON specification for Envelope objects

Example

Creates an Extent object from JSON

1
2
var extentJSON = '{"xmin": -109.55, "ymin": 25.76, "xmax": -86.39, "ymax": 49.94, "spatialReference": { "wkid": 3857 }}';
Extent(extentJSON);

Generalize

Generalize(inputGeometry, maxDeviation, removeDegenerateParts?, maxDeviationUnit?) -> Geometry

Since version 1.11

Function bundle: Geometry

Reduces the number of vertices in the input geometry based on a given deviation value. Point and Multipoint geometries are left unchanged. Envelopes are converted to Polygons and then generalized.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature - The input geometry to be generalized.
• maxDeviation: Number - The maximum allowed deviation from the generalized geometry to the original geometry.
• removeDegenerateParts (Optional): Boolean - When true the degenerate parts of the geometry will be removed from the output (may be undesired for drawing).
• maxDeviationUnit (Optional): Text | Number - Measurement unit for maxDeviation. Defaults to the units of the input geometry.
  Possible values: feet | kilometers | miles | nautical-miles | meters | yards

Return value: Geometry

Example

Returns a generalized version of the input geometry

1
2
// Removes vertices so segments are no more than 100 meters from the original geometry
Generalize($feature, 100, true, 'meters')

Geometry

Geometry(inputFeature) -> Geometry

Since version 1.0

Function bundle: Geometry

Constructs a Geometry object from serialized JSON text or a dictionary. The JSON schema must follow the ArcGIS REST API JSON specification for Geometry objects. This function may also return the Geometry of an input feature.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameter

• inputFeature: Feature | Dictionary | Text - The Feature or JSON from which to construct the geometry object. Starting at version 1.25, the input JSON text or dictionary definitions for Polygons or Polylines may contain curve objects when executed in ArcGIS Pro and ArcGIS Maps SDKs for Native Apps.

Return value: Geometry

Additional resources

• ArcGIS REST API JSON specification for Geometry objects

Examples

Returns the geometry of the feature

1
Geometry($feature)

Constructs a point geometry. This can be done with any geometry type.

1
2
var pointJSON = {"x": -118.15, "y": 33.80, "spatialReference": { "wkid": 3857 } };
Geometry(pointJSON);

HasValue

This function has 2 signatures:

• Since v1.26 - HasValue(inputGeometry, key) -> Boolean
• Since v1.26 - HasValue(inputGeometry, keys) -> Boolean

HasValue(inputGeometry, key) -> Boolean

Since version 1.26

Function bundle: Core

Indicates whether a geometry has a value at a given key or index.

Parameters

• inputGeometry: Geometry - The geometry to check.
• key: Text - The key or property name to check.

Return value: Boolean

Examples

Point that has a z value

1
2
3
4
if( TypeOf(Geometry($feature)) == "Point"){
  return HasValue(Geometry($feature), "z")
  // returns true
}

Polygon with key that does not exist

1
2
3
4
if( TypeOf(Geometry($feature)) == "Polygon"){
  return HasValue(Geometry($feature), "verticalCoordinateSystem")
  // returns false
}

HasValue(inputGeometry, keys) -> Boolean

Since version 1.26

Function bundle: Core

Checks whether a property or index nested several levels deep in a geometry has a value. This allows you to drill into a nested structure in one step rather than check values at each level. Returns true if the keys and indexes at each level of the structure exist and include a non-null value.

Parameters

• inputGeometry: Geometry - The dictionary or feature to check.
• keys: Array<Number | Text> - An array of the keys or indexes to check in each level of the structure.

Return value: Boolean

Examples

Ring, coordinate, and x value all exist and have a value

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// polygon with one ring
var shape = Polygon({
  rings: [[
    Point({ x: -97.06138, y: 32.837, z: 100, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06133, y: 32.836, z: 50, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06124, y: 32.834, z: 20, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06127, y: 32.832, z: 0, hasZ: true, spatialReference: { wkid: 102100 } })
  ]],
  hasZ: true,
  spatialReference: { wkid: 102100 }
});

if(HasValue(shape, ["rings",0,0,"x"])){
  // if() evaluates to true, thus executing the return
  return shape.rings[0][0].x;
  // returns -97.06138
}

Ring does not exist

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// polygon with one ring
var shape = Polygon({
  rings: [[
    Point({ x: -97.06138, y: 32.837, z: 100, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06133, y: 32.836, z: 50, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06124, y: 32.834, z: 20, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06127, y: 32.832, z: 0, hasZ: true, spatialReference: { wkid: 102100 } })
  ]],
  hasZ: true,
  spatialReference: { wkid: 102100 }
});

if(HasValue(shape, ["rings",2,0,"x"])){
  // if() evaluates to false, thus not executing the return
  return shape.rings[2][0].x;
  // polygon only has one ring; there is not a third ring
}

Ring and coordinate exist, but m value does not exist

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
// polygon with one ring
var shape = Polygon({
  rings: [[
    Point({ x: -97.06138, y: 32.837, z: 100, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06133, y: 32.836, z: 50, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06124, y: 32.834, z: 20, hasZ: true, spatialReference: { wkid: 102100 } }),
    Point({ x: -97.06127, y: 32.832, z: 0, hasZ: true, spatialReference: { wkid: 102100 } })
  ]],
  hasZ: true,
  spatialReference: { wkid: 102100 }
});

if(HasValue(shape, ["rings",0,3,"m"])){
  // if() evaluates to false, thus not executing the return
  return shape.rings[0][3].m;
  // there is a coordinate at this location, but it does not have an m value
}

Intersection

Intersection(geometry1, geometry2) -> Geometry

Since version 1.3

Function bundle: Geometry

Constructs the set-theoretic intersection between two geometries and returns a new geometry.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• geometry1: Geometry | Feature - The geometry to intersect with geometry2.
• geometry2: Geometry | Feature - The geometry to intersect with geometry1.

Return value: Geometry

Example

Returns the area common to both polygons

1
2
var geom2 = Polygon({ ... });
Area(Intersection($feature, geom2), 'square-miles');

Intersects

Intersects(geometry1, geometry2) -> Boolean

Since version 1.3

Function bundle: Geometry

Indicates if one geometry intersects another geometry. In the graphic below, the red highlight indicates the scenarios where the function will return true.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• geometry1: Geometry | Feature - The geometry that is tested for the intersects relationship to geometry2.
• geometry2: Geometry | Feature - The geometry being intersected.

Return value: Boolean

Example

Returns true if the geometries intersect

1
2
var geom2 = Polygon({ ... });
Intersects($feature, geom2);

IsSelfIntersecting

IsSelfIntersecting(inputGeometry) -> Boolean

Since version 1.8

Function bundle: Geometry

Indicates whether the input geometry has rings, paths, or points that intersect or cross other parts of the geometry. For example, a single polyline feature whose paths intersect each other or a polygon with rings that self intersect would return true.

Parameter

• inputGeometry: Geometry | Feature - The polygon, polyline, or multipoint geometry to test for the self intersection.

Return value: Boolean

Example

Returns true if the polyline's paths intersect each other

1
2
var polyline = Polyline({ ... });
IsSelfIntersecting(polyline);

IsSimple

IsSimple(inputGeometry) -> Boolean

Since version 1.11

Function bundle: Geometry

Indicates if the given geometry is topologically simple.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameter

• inputGeometry: Geometry | Feature - The input geometry.

Return value: Boolean

Example

Returns true if the geometry is topologically simple

1
IsSimple($feature);

Length

Length(inputGeometry, unit?) -> Number

Since version 1.7

Function bundle: Geometry

Returns the length of the input geometry or Feature in the given units. This is a planar measurement using Cartesian mathematics.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature | Array<Point> - The geometry or geometries for which to calculate the planar length.
• unit (Optional): Text | Number - Measurement unit of the return value. This may be one of the possible values below, or one of the numeric codes listed in the additional resources section below. For the visualization, labeling, and popup profiles, the default unit is the map's spatial reference. In other profiles, like field calculation, the default is based on the spatial reference of the data.
  Possible values: feet | kilometers | miles | nautical-miles | meters | yards

Return value: Number

Additional resources

• LengthGeodetic()
• Length3d()
• Available numeric codes for unit parameter
• More available numeric codes for unit parameter

Example

Returns the planar length of the feature in kilometers

1
Length($feature, 'kilometers')

Length3D

Length3D(inputGeometry, unit?) -> Number

Since version 1.14

Function bundle: Geometry

Profiles: Attribute Rules | Popups | Field Calculation | Form Calculation | Tasks

Returns the planar (i.e. Cartesian) length of the input geometry or Feature taking height or Z information into account. The geometry provided to this function must be assigned a projected coordinate system. If the spatial reference does not provide a value for Z units, then the result will be returned in meters. Keep in mind that not all clients (such as the 3.x series of the ArcGIS API for JavaScript) support requesting Z values even when the data contains Z information.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature | Array<Point> - The geometry or Feature for which to calculate the planar length in 3D space.
• unit (Optional): Text | Number - Measurement unit of the return value. This may be one of the possible values below, or one of the numeric codes listed in the additional resources section below. For the visualization, labeling, and popup profiles, the default unit is the map's spatial reference. In other profiles, like field calculation, the default is based on the spatial reference of the data.
  Possible values: feet | kilometers | miles | nautical-miles | meters | yards

Return value: Number

Additional resources

• LengthGeodetic()
• Length()
• Available numeric codes for unit parameter
• More available numeric codes for unit parameter

Examples

Returns the 3D planar length of the feature in the unit of the spatial reference of the context executing the expression.

1
Length3D($feature)

Returns the 3D planar length of the feature in feet.

1
Length3D($feature, 'feet')

LengthGeodetic

LengthGeodetic(inputGeometry, unit?) -> Number

Since version 1.7

Function bundle: Geometry

Returns the geodetic length of the input geometry or Feature in the given units. This is more reliable measurement of length than Length() because it takes into account the Earth's curvature. Support is limited to geometries with a Web Mercator (wkid 3857) or a WGS 84 (wkid 4326) spatial reference.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature | Array<Point> - The geometry for which to calculate the geodetic length.
• unit (Optional): Text | Number - Measurement unit of the return value. This may be one of the possible values below, or one of the numeric codes listed in the additional resources section below. For the visualization, labeling, and popup profiles, the default unit is the map's spatial reference. In other profiles, like field calculation, the default is based on the spatial reference of the data.
  Possible values: feet | kilometers | miles | nautical-miles | meters | yards

Return value: Number

Additional resources

• Length()
• Length3d()
• Available numeric codes for unit parameter
• More available numeric codes for unit parameter

Example

Returns the geodetic length of the feature in kilometers

1
LengthGeodetic($feature, 'kilometers')

MeasureToCoordinate

MeasureToCoordinate(inputLine, inputMeasure) -> Dictionary

Since version 1.26

Function bundle: Geometry

Returns the first coordinate along an input line based on a given measure, or m-value. If the measure is not found along the input line, then the result will be null. All parts of the line are considered when attempting to find a coordinate at the given measure. The measure does not include gaps between paths (or parts) of the line.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputLine: Polyline | Array<Point> | Feature - The line or path from which to find a coordinate. The input line must have hasM equal to true. If hasM is false, then null will be returned. When using a Feature as input, the feature's geometry must be a polyline.
• inputMeasure: Number - The measure, or m-value, from which to find a coordinate along inputLine from the start of the line. All parts of the line are considered when attempting to find a coordinate at the given measure. The measure does not include gaps between paths (or parts) of the line.

Return value: Dictionary
Returns a dictionary with the following properties. If the measure is not found along the input line, then the result will be null.

• coordinate: Point - The first coordinate of a point along inputLine based on the given measure value.
• distanceAlong: Number - The planar distance from the start of the inputLine measured along the line to the coordinate. In polylines where paths do not connect, the distanceAlong value does not include the distance of the gaps between the starting and ending vertices of the paths.
• partId: Number - In the case of a polyline input, the index of the path to which the coordinate belongs.
• segmentId: Number - The index (relative to the path) of the line segment to which the coordinate belongs. If coordinate represents a vertex of the input line, then segmentId will return the index of the previous vertex. If coordinate is the first vertex of inputLine, then the value of segmentId will be 0.

Example

Returns the coordinate of the input polyline based on the given measure value

1
2
3
var result = MeasureToCoordinate(Geometry($feature), 110);

return result.coordinate;

MultiPartToSinglePart

MultiPartToSinglePart(inputGeometry) -> Array<Geometry>

Since version 1.3

Function bundle: Geometry

Converts a multi-part geometry into separate geometries.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameter

• inputGeometry: Geometry | Feature - The multi-part geometry to break into single parts.

Return value: Array<Geometry>

Example

Returns an array of single-part geometries from a multi-part geometry

1
var allParts = MultiPartToSinglePart($feature)

Multipoint

This function has 3 signatures:

• Since v1.0 - Multipoint(geometryDefinition) -> Multipoint
• Since v1.0 - Multipoint(geometryDefinition) -> Multipoint
• Since vundefined - Multipoint(jsonDefinition) -> Multipoint

Multipoint(geometryDefinition) -> Multipoint

Since version 1.0

Function bundle: Geometry

Constructs a Multipoint object from a dictionary using only an array of values as coordinates.

Parameter

• geometryDefinition: Dictionary - The properties from which to construct the Multipoint geometry object.

  • points: Array<Any> - An array of coordinates representing point locations.

    • singlePoint: Array<Number> - An array of numbers representing a single point or coordinate. The first item in the array represents the x-coordinate. The second element represents the y-coordinate. The third element represents the m-coordinate if hasM is true and hasZ is false. Otherwise, the third element represents the z-coordinate. If hasZ and hasM are both true, then the third element represents the z-coordinate, and the fourth element represents the m-coordinate.

  • hasM: Boolean - Indicates if the geometry has m-values.

  • hasZ: Boolean - Indicates if the geometry has z-values.

  • spatialReference: Dictionary - The spatial reference of the geometry.

    • wkid: Number - The Well-known ID of the geographic or projected coordinate system that defines the reference for which to draw the geometry.

Return value: Multipoint

Examples

Creates a Multipoint with only x, y coordinates

1
2
3
4
5
6
7
8
9
10
Multipoint({
  points: [
    [-97.06138,32.837],
    [-97.06133,32.836],
    [-97.06124,32.834],
    [-97.06127,32.832],
    [-97.06138,32.837]
  ],
  spatialReference: { wkid: 3857 }
});

Creates a Multipoint with m values

1
2
3
4
5
6
7
8
9
10
11
Multipoint({
  hasM: true,
  points: [
    [-97.06138,32.837,0],
    [-97.06133,32.836,15],
    [-97.06124,32.834,30],
    [-97.06127,32.832,50],
    [-97.06138,32.837,0]
  ],
  spatialReference: { wkid: 3857 }
});

Creates a Multipoint with z values

1
2
3
4
5
6
7
8
9
10
11
Multipoint({
  hasZ: true,
  points: [
    [-97.06138,32.837,1000],
    [-97.06133,32.836,1500],
    [-97.06124,32.834,1000],
    [-97.06127,32.832,500],
    [-97.06138,32.837,1000]
  ],
  spatialReference: { wkid: 3857 }
});

Creates a Multipoint with z and m values

1
2
3
4
5
6
7
8
9
10
11
12
Multipoint({
  hasM: true,
  hasZ: true,
  points: [
    [-97.06138,32.837,1000,0],
    [-97.06133,32.836,1500,15],
    [-97.06124,32.834,1000,30],
    [-97.06127,32.832,500,50],
    [-97.06138,32.837,1000,0]
  ],
  spatialReference: { wkid: 3857 }
});

Multipoint(geometryDefinition) -> Multipoint

Since version 1.0

Function bundle: Geometry

Constructs a Multipoint object from a dictionary using an array of Point objects.

Parameter

• geometryDefinition: Dictionary - The properties from which to construct the Multipoint geometry object.

  • points: Array<Point> - An array of point objects.

  • hasM: Boolean - Indicates if the geometry has m-values.

  • hasZ: Boolean - Indicates if the geometry has z-values.

  • spatialReference: Dictionary - The spatial reference of the geometry.

    • wkid: Number - The Well-known ID of the geographic or projected coordinate system that defines the reference for which to draw the geometry.

Return value: Multipoint

Example

Creates a Multipoint with only x, y coordinates

1
2
3
4
5
6
7
8
9
10
Multipoint({
  points: [
    Point({ x: -97.06138, y: 32.837, spatialReference: { wkid: 3857 } }),
    Point({ x: -97.06133, y: 32.836, spatialReference: { wkid: 3857 } }),
    Point({ x: -97.06124, y: 32.834, spatialReference: { wkid: 3857 } }),
    Point({ x: -97.06127, y: 32.832, spatialReference: { wkid: 3857 } }),
    Point({ x: -97.06138, y: 32.837, spatialReference: { wkid: 3857 } })
  ],
  spatialReference: { wkid: 3857 }
});

Multipoint(jsonDefinition) -> Multipoint

Function bundle: Geometry

Constructs a Multipoint object from serialized JSON text. The JSON schema must follow the ArcGIS REST API JSON specification for Multipoint objects.

Parameter

• jsonDefinition: Text - The JSON from which to construct the multipoint geometry object.

Return value: Multipoint

Additional resources

• ArcGIS REST API JSON specification for Multipoint objects

Example

1
2
3
// Creates a Multipoint object
var multipointJSON = '{"points": [[-97.06138,32.837],[-97.06133,32.836],[-97.06124,32.834],[-97.06127,32.832]],"spatialReference" : { "wkid": 3857 }}';
Multipoint(multipointJSON);

NearestCoordinate

NearestCoordinate(inputGeometry, searchPoint) -> Dictionary

Since version 1.23

Function bundle: Geometry

Returns the nearest coordinate (not vertex) of the input geometry to the search point. The returned dictionary also includes the shortest planar distance from the search point to the nearest coordinate. If the search point intersects the input geometry, then the search point is returned as the result with a distance of zero.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature - The geometry from which to get the nearest coordinate.
• searchPoint: Point | Feature - The point from which to find the nearest coordinate of the inputGeometry.

Return value: Dictionary
Returns a dictionary with the following properties.

• coordinate: Point - The closest coordinate from the inputGeometry to the searchPoint.
• distance: Number - The planar distance from the closest coordinate to the searchPoint. This represents the shortest distance between the inputGeometry and the searchPoint.
• sideOfLine: Text - The spatial relationship between the searchPoint and the segment of the inputGeometry leading up to the nearest coordinate. Possible values:

left - The searchPoint is on the left side of the inputGeometry.

right - The searchPoint is on the right side of the inputGeometry.

straddle - The searchPoint straddles or is on top of the inputGeometry.

Example

Returns the nearest coordinate from the input polygon along with the distance to that coordinate

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
var buildings = FeatureSetByPortalItem(
  Portal('https://www.arcgis.com'),
  '7b1fb95ab77f40bf8aa09c8b59045449',
  0,
  ['*'],
  true
);

var nearestBuilding = First(Intersects(buildings, BufferGeodetic($feature, 100, "feet")));

var result = NearestCoordinate(nearestBuilding, $feature);

return result.distance;

// or

return result.coordinate;

NearestVertex

NearestVertex(inputGeometry, searchPoint) -> Dictionary

Since version 1.23

Function bundle: Geometry

Returns the nearest vertex of the input geometry to the search point. The returned dictionary includes the planar distance from the search point to the nearest vertex.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature - The geometry from which to get the nearest vertex.
• searchPoint: Point | Feature - The point from which to find the nearest vertex of the inputGeometry.

Return value: Dictionary
Returns a dictionary with the following properties.

• coordinate: Point - The point location representing the nearest vertex from the inputGeometry to the searchPoint.
• distance: Number - The planar distance from the input geometry's closest vertex to the searchPoint.
• sideOfLine: Text - The spatial relationship between the searchPoint and the segment of the inputGeometry leading up to the nearest vertex. Possible values:

left - The searchPoint is on the left side of the inputGeometry.

right - The searchPoint is on the right side of the inputGeometry.

straddle - The searchPoint straddles or is on top of the inputGeometry.

Example

Returns the nearest vertex from the input polygon along with the distance to that vertex

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
var buildings = FeatureSetByPortalItem(
  Portal('https://www.arcgis.com'),
  '7b1fb95ab77f40bf8aa09c8b59045449',
  0,
  ['*'],
  true
);

var nearestBuilding = First(Intersects(buildings, BufferGeodetic($feature, 100, "feet")));

var result = NearestVertex(nearestBuilding, $feature);

return result.distance;

// or

return result.coordinate;

Offset

Offset(inputGeometry, offsetDistance, offsetUnit?, joinType?, bevelRatio?, flattenError?) -> Geometry

Since version 1.11

Function bundle: Geometry

Creates a geometry that is a constant planar distance from an input geometry. It is similar to buffering, but produces a one-sided result.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputGeometry: Geometry | Feature - The geometry to offset. Point geometries are not supported.
• offsetDistance: Number - The planar distance to offset from the input geometry. If offsetDistance > 0, then the offset geometry is constructed to the right of the input geometry, if offsetDistance = 0, then there is no change in the geometries, otherwise it is constructed to the left. The direction of the paths or rings of the input geometry determines which side of the geometry is considered right, and which side is considered left. For a simple polygon, the orientation of outer rings is clockwise and for inner rings it is counter clockwise. So the right side of a simple polygon is always its inside.
• offsetUnit (Optional): Text | Number - Measurement unit for offsetDistance. Defaults to the units of the input geometry.
  Possible values: feet | kilometers | miles | nautical-miles | meters | yards
• joinType (Optional): Text - The join type. Possible values are round, bevel, miter, or square.
• bevelRatio (Optional): Number - Applicable when joinType = 'miter'; bevelRatio is multiplied by the offset distance and the result determines how far a mitered offset intersection can be located before it is beveled.
• flattenError (Optional): Number - Applicable when joinType = 'round'; flattenError determines the maximum distance of the resulting segments compared to the true circular arc. The algorithm never produces more than around 180 vertices for each round join.

Return value: Geometry

Example

Returns the offset geometry

1
Offset($feature, 10, 'meters', 'square');

Overlaps

Overlaps(geometry1, geometry2) -> Boolean

Since version 1.3

Function bundle: Geometry

Indicates if one geometry overlaps another geometry. In the graphic below, the red highlight indicates the scenarios where the function will return true.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• geometry1: Geometry | Feature - The base geometry that is tested for the 'overlaps' relationship with geometry2.
• geometry2: Geometry | Feature - The comparison geometry that is tested for the 'overlaps' relationship with geometry1.

Return value: Boolean

Example

Returns true if the geometries overlap

1
2
var geom2 = Polygon({ ... });
Overlaps($feature, geom2);

Point

This function has 2 signatures:

• Since v1.0 - Point(geometryDefinition) -> Point
• Since v1.0 - Point(jsonDefinition) -> Point

Point(geometryDefinition) -> Point

Since version 1.0

Function bundle: Geometry

Constructs a Point object from a dictionary.

Parameter

• geometryDefinition: Dictionary - The properties from which to construct the Point geometry object.

  • x: Number - The x-coordinate (longitude) of the point location.

  • y: Number - The y-coordinate (latitude) of the point location.

  • m: Number - The m-value (measure) of the point location. If providing an m-value, then you must set hasM to true.

  • z: Number - The z-value (elevation or height) of the point location. If providing a z-value, then you must set hasZ to true.

  • hasM: Boolean - Indicates if the geometry has m-values.

  • hasZ: Boolean - Indicates if the geometry has z-values.

  • spatialReference: Dictionary - The spatial reference of the geometry.

    • wkid: Number - The Well-known ID of the geographic or projected coordinate system that defines the reference for which to draw the geometry.

Return value: Point

Examples

Creates a Point with only x, y coordinates

1
2
3
4
5
Point({
  x: -97.06138,
  y: 32.837,
  spatialReference: { wkid: 3857 }
});

Creates a Point with m values

1
2
3
4
5
6
7
Point({
  hasM: true,
  x: -97.06138,
  y: 32.837,
  m: 15,
  spatialReference: { wkid: 3857 }
});

Creates a Point with z values

1
2
3
4
5
6
7
Point({
  hasZ: true,
  x: -97.06138,
  y: 32.837,
  z: 1500,
  spatialReference: { wkid: 3857 }
});

Creates a Point with z and m values

1
2
3
4
5
6
7
8
9
Point({
  hasM: true,
  hasZ: true,
  x: -97.06138,
  y: 32.837,
  z: 1500,
  m: 15,
  spatialReference: { wkid: 3857 }
});

Point(jsonDefinition) -> Point

Since version 1.0

Function bundle: Geometry

Constructs a Point object from serialized JSON text. The JSON schema must follow the ArcGIS REST API JSON specification for Point objects.

Parameter

• jsonDefinition: Text - The JSON from which to construct the point geometry object.

Return value: Point

Additional resources

• ArcGIS REST API JSON specification for Point objects

Example

1
2
3
// Creates a Point object
var pointJSON = '{ "x": -118.15, "y": 33.80, "spatialReference": { "wkid": 3857 }}';
Point(pointJSON)

PointToCoordinate

PointToCoordinate(inputLine, searchPoint) -> Dictionary

Since version 1.26

Function bundle: Geometry

Returns the nearest coordinate and distance to that coordinate of the search point to the input line.

Feature geometries in the visualization and labeling profiles are generalized according to the view's scale resolution to improve drawing performance. Therefore, using a feature's geometry (i.e. $feature) as input to any geometry function in these contexts will return different results at each scale level. Other profiles, such as popup, provide the full resolution geometry.

Parameters

• inputLine: Polyline | Array<Point> | Feature - The line or path from which to get the nearest coordinate. When using a Feature as input, the feature's geometry must be a polyline.
• searchPoint: Point - The point from which to find the nearest coordinate of the inputLine.

Return value: Dictionary
Returns a dictionary with the following properties.

• coordinate: Point - The point coordinate representing the nearest coordinate along the inputLine to the searchPoint. If hasZ is false in searchPoint, then the search is performed in x/y coordinates and the z-value is interpolated.
• distance: Number - The planar distance from the searchPoint to the coordinate.
• distanceAlong: Number - The planar distance from the start of the inputLine measured along the line to the coordinate. In polylines where paths do not connect, the distanceAlong value does not include the distance of the gaps between the starting and ending vertices of the paths.
• partId: Number - In the case of a polyline input, the index of the path to which the coordinate belongs.
• segmentId: Number - The index (relative to the path) of the line segment to which the coordinate belongs. If coordinate represents a vertex of the input line, then segmentId will return the index of the previous vertex. If coordinate is the first vertex of inputLine, then the value of segmentId will be 0.

Example

Returns the distance to the nearest coordinate along the input polyline based on the clicked location to open a popup

1
2
3
4
5
6
7
var result;

if (TypeOf($userInput) == "Point"){
  result = PointToCoordinate(Geometry($feature), $userInput);
}

return result.distanceAlong;

Polygon

This function has 3 signatures:

• Since v1.0 - Polygon(geometryDefinition) -> Polygon
• Since v1.0 - Polygon(geometryDefinition) -> Polygon
• Since v1.0 - Polygon(jsonDefinition) -> Polygon

Polygon(geometryDefinition) -> Polygon

Since version 1.0

Function bundle: Geometry

Constructs a Polygon object from a dictionary using only an array of values as coordinates.

Parameter

• geometryDefinition: Dictionary - The properties from which to construct the Polygon geometry object.

  • rings: Array<Any> - An array of rings (or shapes) where each ring is an array of vertices.

    • ring: Array<Any> - An array of vertices in a ring. All rings should be closed, meaning the first vertex of each ring should always be the same as the last vertex. Vertices should be defined in clockwise order. Rings with vertices defined in counter-clockwise order will result in polygon holes.

      • vertex: Array<Number> - An array of numbers representing a single vertex or coordinate in a ring. The first item in the array represents the x-coordinate. The second element represents the y-coordinate. The third element represents the m-coordinate if hasM is true and hasZ is false. Otherwise, the third element represents the z-coordinate. If hasZ and hasM are both true, then the third element represents the z-coordinate, and the fourth element represents the m-coordinate.

  • curveRings: Array<Any> - Since version 1.25 in ArcGIS Pro and ArcGIS Maps SDKs for Native Apps. An array of rings (or shapes) that may contain curves.

    • ring: Array<Any> - An array of vertices or curve objects in a ring. All rings should be closed, meaning the first vertex of each ring should always be the same as the last vertex. Vertices should be defined in clockwise order. Rings with vertices defined in counter-clockwise order will result in polygon holes. Each item in the array can be either a vertex or a curve object.

      • vertex: Array<Number> - An array of numbers representing a single vertex or coordinate in a ring. The first item in the array represents the x-coordinate. The second element represents the y-coordinate. The third element represents the m-coordinate if hasM is true and hasZ is false. Otherwise, the third element represents the z-coordinate. If hasZ and hasM are both true, then the third element represents the z-coordinate, and the fourth element represents the m-coordinate.

      • curve: Dictionary - A curve object that represents a segment of a ring. The curve object has the following properties:

        • a: Array<Any> - Defines an elliptic or circular arc. Circular arcs have four elements in the array; elliptic arcs must have 7 elements.
        • b: Array<Any> - Represents a cubic Bézier curve. This is defined by an array of three arrays representing an end point and two control points.
        • c: Array<Any> - The c property represents an open circular arc. This is defined as an array of two double-precision values representing the x and y coordinates of the center of the circle.

  • hasM: Boolean - Indicates if the geometry has m-values.

  • hasZ: Boolean - Indicates if the geometry has z-values.

  • spatialReference: Dictionary - The spatial reference of the geometry.

    • wkid: Number - The Well-known ID of the geographic or projected coordinate system that defines the reference for which to draw the geometry.

Return value: Polygon

Additional resources

• Curve objects

Examples

Creates a Polygon with only x, y coordinates

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// Creates a Polygon with 2 rings
Polygon({
  rings: [
    [
      [-97.06138,32.837],
      [-97.06133,32.836],
      [-97.06124,32.834],
      [-97.06127,32.832],
      [-97.06138,32.837]
    ],
    [
      [-97.06326,32.759],
      [-97.06298,32.755],
      [-97.06326,32.759]
    ]
  ],
  spatialReference: { wkid: 3857 }
});

Creates a Polygon with m values

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// Creates a Polygon with 1 ring
Polygon({
  hasM: true,
  rings: [
    [
      [-97.06138,32.837,0],
      [-97.06133,32.836,15],
      [-97.06124,32.834,30],
      [-97.06127,32.832,50],
      [-97.06138,32.837,0]
    ]
  ],
  spatialReference: { wkid: 3857 }
});

Creates a Polygon with z values

1
2
3
4
5
6
7
8
9
10
11
12
13
14
// Creates a Polygon with 1 ring
Polygon({
  hasZ: true,
  rings: [
    [
      [-97.06138,32.837,1000],
      [-97.06133,32.836,1500],
      [-97.06124,32.834,1000],
      [-97.06127,32.832,500],
      [-97.06138,32.837,1000]
    ]
  ],
  spatialReference: { wkid: 3857 }
});

Creates a Polygon with z and m values

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
// Creates a Polygon with 1 ring
Polygon({
  hasM: true,
  hasZ: true,
  rings: [
    [
      [-97.06138,32.837,1000,0],
      [-97.06133,32.836,1500,15],
      [-97.06124,32.834,1000,30],
      [-97.06127,32.832,500,50],
      [-97.06138,32.837,1000,0]
    ]
  ],
  spatialReference: { wkid: 3857 }
});

Polygon(geometryDefinition) -> Polygon

Since version 1.0

Function bundle: Geometry

Constructs a Polygon object from a dictionary using an array of Points as coordinates.

Parameter

• geometryDefinition: Dictionary - The properties from which to construct the Polygon geometry object.

  • rings: Array<Any> - An array of rings (or shapes) where each ring is an array of point objects.

    • ring: Array<Point> - An array of points representing a ring. All rings should be closed, meaning the first point of each ring should always be the same as the last point in the ring. Points should be defined in clockwise order. Rings with vertices defined in counter-clockwise order will result in polygon holes.

  • curveRings: Array<Any> - Since version 1.25 in ArcGIS Pro and ArcGIS Maps SDKs for Native Apps. An array of rings (or shapes) that may contain curves.

    • ring: Array<Any> - An array of vertices or curve objects in a ring. All rings should be closed, meaning the first vertex of each ring should always be the same as the last vertex. Vertices should be defined in clockwise order. Rings with vertices defined in counter-clockwise order will result in polygon holes. Each item in the array can be either a vertex or a curve object.

      • vertex: Point - An point representing a single vertex or coordinate in a ring.

      • curve: Dictionary - A curve object that represents a segment of a ring. The curve object has the following properties:

        • a: Array<Any> - Defines an elliptic or circular arc. Circular arcs have four elements in the array; elliptic arcs must have 7 elements.
        • b: Array<Any> - Represents a cubic Bézier curve. This is defined by an array of three arrays representing an end point and two control points.
        • c: Array<Any> - The c property represents an open circular arc. This is defined as an array of two double-precision values representing the x and y coordinates of the center of the circle.

  • hasM: Boolean - Indicates if the geometry has m-values.

  • hasZ: Boolean - Indicates if the geometry has z-values.

  • spatialReference: Dictionary - The spatial reference of the geometry.

    • wkid: Number - The Well-known ID of the geographic or projected coordinate system that defines the reference for which to draw the geometry.

Return value: Polygon

Additional resources

• Curve objects

Example

Creates a Polygon with only x, y coordinates

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
// Creates a Polygon with 2 rings
Polygon({
  rings: [
    [
      Point({ x: -97.06138, y: 32.837, spatialReference: { wkid: 3857 } }),
      Point({ x: -97.06133, y: 32.836, spatialReference: { wkid: 3857 } }),
      Point({ x: -97.06124, y: 32.834, spatialReference: { wkid: 3857 } }),
      Point({ x: -97.06127, y: 32.832, spatialReference: { wkid: 3857 } }),
      Point({ x: -97.06138, y: 32.837, spatialReference: { wkid: 3857 } })
    ],
    [
      Point({ x: -97.06326, y: 32.759, spatialReference: { wkid: 3857 } }),
      Point({ x: -97.06298, y: 32.755, spatialReference: { wkid: 3857 } }),
      Point({ x: -97.06326, y: 32.759, spatialReference: { wkid: 3857 } })
    ]
  ],
  spatialReference: { wkid: 3857 }
});

Polygon(jsonDefinition) -> Polygon

Since version 1.0

Function bundle: Geometry

Constructs a Polygon object from serialized JSON text. The JSON schema must follow the ArcGIS REST API JSON specification for Polygon objects. JSON text may contain curve objects in ArcGIS Pro and ArcGIS Maps SDKs for Native Apps starting at version 1.25.

Parameter

• jsonDefinition: Text - The JSON from which to construct the polygon geometry object.

Return value: Polygon

Additional resources

• ArcGIS REST API JSON specification for Polygon objects

Example

1
2
3
// Creates a Polygon object
var polygonJSON = '{"rings": [[[-97.06138,32.837],[-97.06133,32.836],[-97.06124,32.834],[-97.06127,32.832], [-97.06138,32.837]],[[-97.06326,32.759],[-97.06298,32.755],[-97.06153,32.749], [-97.06326,32.759]]],"spatialReference": { "wkid": 3857 }}';
Polygon(polygonJSON);

Polyline

This function has 3 signatures:

• Since v1.0 - Polyline(geometryDefinition) -> Polyline
• Since v1.0 - Polyline(geometryDefinition) -> Polyline
• Since v1.0 - Polyline(jsonDefinition) -> Polyline

Polyline(geometryDefinition) -> Polyline

Since version 1.0

Function bundle: Geometry

Constructs a Polyline object from a dictionary using only an array of values as coordinates.

Parameter

• geometryDefinition: Dictionary - The properties from which to construct the polyline geometry object.

  • paths: Array<Any> - An array of paths (or line segments) where each path is an array of vertices.

    • path: Array<Any> - An array of vertices in a line segment, or path.

      • vertex: Array<Number> - An array of numbers representing a single vertex or coordinate in a line segment. The first item in the array represents the x-coordinate. The second element represents the y-coordinate. The third element represents the m-coordinate if hasM is true and hasZ is false. Otherwise, the third element represents the z-coordinate. If hasZ and hasM are both true, then the third element represents the z-coordinate, and the fourth element represents the m-coordinate.

  • curvePaths: Array<Any> - Since version 1.25 in ArcGIS Pro and ArcGIS Maps SDKs for Native Apps. An array of paths (or line segments) that may contain curves.

    • path: Array<Any> - An array of vertices or curve objects in a path.

      • vertex: Array<Number> - An array of numbers representing a single vertex or coordinate in a line segment. The first item in the array represents the x-coordinate. The second element represents the y-coordinate. The third element represents the m-coordinate if hasM is true and hasZ is false. Otherwise, the third element represents the z-coordinate. If hasZ and hasM are both true, then the third element represents the z-coordinate, and the fourth element represents the m-coordinate.

      • curve: Dictionary - A curve object that represents a segment of a path. The curve object has the following properties:

        • a: Array<Any> - Defines an elliptic or circular arc. Circular arcs have four elements in the array; elliptic arcs must have 7 elements.
        • b: Array<Any> - Represents a cubic Bézier curve. This is defined by an array of three arrays representing an end point and two control points.
        • c: Array<Any> - The c property represents an open circular arc. This is defined as an array of two double-precision values representing the x and y coordinates of the center of the circle.

  • hasM: Boolean - Indicates if the geometry has m-values.

  • hasZ: Boolean - Indicates if the geometry has z-values.

  • spatialReference: Dictionary - The spatial reference of the geometry.

    • wkid: Number - The Well-known ID of the geographic or projected coordinate system that defines the reference for which to draw the geometry.

Return value: Polyline

Additional resources

• Curve objects

Examples

Creates a polyline with only x, y coordinates

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
// Creates a Polyline with 2 paths
Polyline({
  paths: [
    [
      [-97.06138,32.837],
      [-97.06133,32.836],
      [-97.06124,32.834],
      [-97.06127,32.832]
    ],
    [
      [-97.06326,32.759],
      [-97.06298,32.755]
    ]
  ],
  spatialReference: { wkid: 3857 }
});

Creates a polyline with m values

1
2
3
4
5
6
7
8
9
10
11
12
13
// Creates a Polyline with 1 path
Polyline({
  hasM: true,
  paths: [
    [
      [-97.06138,32.837,0],
      [-97.06133,32.836,15],
      [-97.06124,32.834,30],
      [-97.06127,32.832,50]
    ]
  ],
  spatialReference: { wkid: 3857 }
});

Creates a polyline with z values

1
2
3
4
5
6
7
8
9
10
11
12
13
// Creates a Polyline with 1 path
Polyline({
  hasZ: true,
  paths: [
    [
      [-97.06138,32.837,1000],
      [-97.06133,32.836,1500],
      [-97.06124,32.834,1000],
      [-97.06127,32.832,500]
    ]
  ],
  spatialReference: { wkid: 3857 }
});