Geometry Objects

This document discusses the JSON geometry and spatial reference objects as returned by the REST API. The REST API supports 4 geometry types - points, polylines, polygons and envelopes.

The spatial reference can be specified using a well-known ID (`wkid`

) or
well-known text (`wkt`

).
Note that pre-10 only `wkid`

was supported.

** wkid based syntax**:

For a list of valid WKID values, see Projected coordinate Systems and Geographic coordinate Systems.

{"wkid" : <wkid>}

{"wkid" : 4326}

** wkt based syntax**:

{"wkt" : "<wkt>"}

{"wkt" : "GEOGCS[\"GCS_WGS_1984\",DATUM[\"D_WGS_1984\",SPHEROID[\"WGS_1984\",6378137,298.257223563]],PRIMEM[\"Greenwich\",0],UNIT[\"Degree\",0.017453292519943295]]"}

A point contains `x`

and `y`

fields along with a
`spatialReference`

field.

{

"x" : <x>, "y" : <y>, "spatialReference" : {<spatialReference>}

}

{

"x" : -118.15, "y" : 33.80, "spatialReference" : {"wkid" : 4326}

}

A polyline contains an array of `paths`

and a
`spatialReference`

. Each path is represented as an array of
points. And each point in the path is represented as a 2-element array. The
0-index is the x-coordinate and the 1-index is the y-coordinate.

{

"paths" : [

[ [<x11>, <y11>], [<x12>, <y12>] ],

[ [<x21>, <y21>], [<x22>, <y22>] ]

],

"spatialReference" : {<spatialReference>}

}

{

"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" : 4326}

}

A polygon contains an array of `rings`

and a
`spatialReference`

. Each ring is represented as an array of
points. The first point of each ring is always the same as the last point.
And each point in the ring is represented as a 2-element array. The 0-index
is the x-coordinate and the 1-index is the y-coordinate.

{

"rings" : [

[ [<x11>, <y11>], [<x12>, <y12>], ..., [<x11>, <y11>] ],

[ [<x21>, <y21>], [<x22>, <y22>], ..., [<x21>, <y21>] ]

],

"spatialReference" : {<spatialReference>}

}

{

"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" : 4326}

}

A multipoint contains an array of `points`

and a
`spatialReference`

. Each point is represented as a 2-element
array. The 0-index is the x-coordinate and the 1-index is the
y-coordinate.

{

"points" : [ [<x1>, <y1>], [<x2>, <y2>] ],

"spatialReference" : {<spatialReference>}

}

{

"points" : [ [-97.06138,32.837], [-97.06133,32.836], [-97.06124,32.834], [-97.06127,32.832] ],

"spatialReference" : {"wkid" : 4326}

}

`xmin`

, `ymin`

, `xmax`

, and
`ymax`

, along with a `spatialReference`

.
{

"xmin" : <xmin>, "ymin" : <ymin>, "xmax" : <xmax>, "ymax" : <ymax>,

"spatialReference" : {<spatialReference>}

}

{

"xmin" : -109.55, "ymin" : 25.76, "xmax" : -86.39, "ymax" : 49.94,

"spatialReference" : {"wkid" : 4326}

}