arcgis.geometry module¶
The arcgis.geometry module defines useful geometry types for working with geographic information and GIS functionality. It provides functions which use geometric types as input and output as well as functions for easily converting geometries between different representations.
Several functions accept geometries represented as dictionaries and the geometry objects in this module behave like them as well as support the ‘.’ (dot) notation providing attribute access.
Example:
>>> pt = Point({"x" : 118.15, "y" : 33.80, "spatialReference" : {"wkid" : 4326}})
>>> print (pt.is_valid)
True
>>> print (pt.type) # POINT
'POINT'
>>> print (pt)
'{"x" : 118.15, "y" : 33.80, "spatialReference" : {"wkid" : 4326}}'
>>> print (pt.x, pt.y)
(118.15,33.80)
Example Polyline:
>>> line = {
"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}
}
>>> polyline = Polyline(line)
>>> print(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" : 4326}}'
>>> print(polyline.is_valid)
True
Example of invalid geometry:
>>> line = {
"paths" : [[[97.06138],[97.06133,32.836],[97.06124,32.834],[97.06127,32.832]],
[[97.06326,32.759],[97.06298,32.755]]],
"spatialReference" : {"wkid" : 4326}
}
>>> polyline = Polyline(line)
>>> print(polyline)
'''{"paths" : [[[97.06138],[97.06133,32.836],[97.06124,32.834],[97.06127,32.832]],
[[97.06326,32.759],[97.06298,32.755]]],"spatialReference" : {"wkid" : 4326}}'''
>>>print(polyline.is_valid)
False
The same pattern can be used repeated for Polygon, MultiPoint and SpatialReference.
You can create a Geometry even when you don’t know the exact type. The Geometry constructor is able to figure out the geometry type and returns the correct type as the example below demonstrates:
>>> geom = Geometry({
"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}
})
>>> print (geom.type) # Polygon
'Polygon'
>>> print(isinstance(geom, Polygon)
True
Point¶

class
arcgis.geometry.
Point
(iterable=None, **kwargs)¶ A point contains x and y fields along with a spatialReference field. A point can also contain m and z fields. A point is empty when its x field is present and has the value null or the string “NaN”. An empty point has no location in space.

coordinates
()¶ returns the coordinates as a np.array

svg
(scale_factor=1, fill_color=None)¶ Returns SVG circle element for the Point geometry.
 scale_factorfloat
Multiplication factor for the SVG circle diameter. Default is 1.
 fill_colorstr, optional
Hex string for fill color. Default is to use “#66cc99” if geometry is valid, and “#ff3333” if invalid.

property
type
¶

MultiPoint¶

class
arcgis.geometry.
MultiPoint
(iterable=None, **kwargs)¶ A multipoint contains an array of points, along with a spatialReference field. A multipoint can also have booleanvalued hasZ and hasM fields. These fields control the interpretation of elements of the points array. Omitting an hasZ or hasM field is equivalent to setting it to false. Each element of the points array is itself an array of two, three, or four numbers. It will have two elements for 2D points, two or three elements for 2D points with Ms, three elements for 3D points, and three or four elements for 3D points with Ms. In all cases, the x coordinate is at index 0 of a point’s array, and the y coordinate is at index 1. For 2D points with Ms, the m coordinate, if present, is at index 2. For 3D points, the Z coordinate is required and is at index 2. For 3D points with Ms, the Z coordinate is at index 2, and the M coordinate, if present, is at index 3. An empty multipoint has a points field with no elements. Empty points are ignored.

coordinates
()¶ returns the coordinates as a np.array

svg
(scale_factor=1.0, fill_color=None)¶ Returns a group of SVG circle elements for the MultiPoint geometry.
 scale_factorfloat
Multiplication factor for the SVG circle diameters. Default is 1.
 fill_colorstr, optional
Hex string for fill color. Default is to use “#66cc99” if geometry is valid, and “#ff3333” if invalid.

property
type
¶

Polyline¶

class
arcgis.geometry.
Polyline
(iterable=None, **kwargs)¶ A polyline contains an array of paths or curvePaths and a spatialReference. For polylines with curvePaths, see the sections on JSON curve object and Polyline with curve. Each path is represented as an array of points, and each point in the path is represented as an array of numbers. A polyline can also have booleanvalued hasM and hasZ fields. See the description of multipoints for details on how the point arrays are interpreted. An empty polyline is represented with an empty array for the paths field. Nulls and/or NaNs embedded in an otherwise defined coordinate stream for polylines/polygons is a syntax error.

coordinates
()¶ returns the coordinates as a np.array

svg
(scale_factor=1, stroke_color=None)¶ Returns SVG polyline element for the LineString geometry.
 scale_factorfloat
Multiplication factor for the SVG strokewidth. Default is 1.
 stroke_colorstr, optional
Hex string for stroke color. Default is to use “#66cc99” if geometry is valid, and “#ff3333” if invalid.

property
type
¶

Polygon¶

class
arcgis.geometry.
Polygon
(iterable=None, **kwargs)¶ A polygon contains an array of rings or curveRings and a spatialReference. For polygons with curveRings, see the sections on JSON curve object and Polygon with curve. Each ring is represented as an array of points. The first point of each ring is always the same as the last point. Each point in the ring is represented as an array of numbers. A polygon can also have booleanvalued hasM and hasZ fields.
An empty polygon is represented with an empty array for the rings field. Nulls and/or NaNs embedded in an otherwise defined coordinate stream for polylines/polygons is a syntax error. Polygons should be topologically simple. Exterior rings are oriented clockwise, while holes are oriented counterclockwise. Rings can touch at a vertex or selftouch at a vertex, but there should be no other intersections. Polygons returned by services are topologically simple. When drawing a polygon, use the evenodd fill rule. The evenodd fill rule will guarantee that the polygon will draw correctly even if the ring orientation is not as described above.

coordinates
()¶ returns the coordinates as a np.array

svg
(scale_factor=1, fill_color=None)¶

property
type
¶

Envelope¶

class
arcgis.geometry.
Envelope
(iterable=None, **kwargs)¶ An envelope is a rectangle defined by a range of values for each coordinate and attribute. It also has a spatialReference field. The fields for the z and m ranges are optional. An empty envelope has no in space and is defined by the presence of an xmin field a null value or a “NaN” string.

coordinates
()¶ returns the coordinates as a np.array

property
geohash
¶ A geohash string of the extent is returned.

property
geohash_covers
¶ Returns a list of up to the four longest geohash strings that fit within the extent.

property
geohash_neighbors
¶ A list of the geohash neighbor strings for the extent is returned.

property
height
¶ The extent height value.

property
polygon
¶ returns the envelope as a Polygon geometry

svg
(scale_factor=1, fill_color=None)¶

property
type
¶

property
width
¶ The extent width value.

SpatialReference¶

class
arcgis.geometry.
SpatialReference
(iterable=None, **kwargs)¶ A spatial reference can be defined using a wellknown ID (wkid) or wellknown text (wkt). The default tolerance and resolution values for the associated coordinate system are used. The xy and z tolerance values are 1 mm or the equivalent in the unit of the coordinate system. If the coordinate system uses feet, the tolerance is 0.00328083333 ft. The resolution values are 10x smaller or 1/10 the tolerance values. Thus, 0.0001 m or 0.0003280833333 ft. For geographic coordinate systems using degrees, the equivalent of a mm at the equator is used. The wellknown ID (WKID) for a given spatial reference can occasionally change. For example, the WGS 1984 Web Mercator (Auxiliary Sphere) projection was originally assigned WKID 102100, but was later changed to 3857. To ensure backward compatibility with older spatial data servers, the JSON wkid property will always be the value that was originally assigned to an SR when it was created. An additional property, latestWkid, identifies the current WKID value (as of a given software release) associated with the same spatial reference. A spatial reference can optionally include a definition for a vertical coordinate system (VCS), which is used to interpret the zvalues of a geometry. A VCS defines units of measure, the location of z = 0, and whether the positive vertical direction is up or down. When a vertical coordinate system is specified with a WKID, the same caveat as mentioned above applies. There are two VCS WKID properties: vcsWkid and latestVcsWkid. A VCS WKT can also be embedded in the string value of the wkt property. In other words, the WKT syntax can be used to define an SR with both horizontal and vertical components in one string. If either part of an SR is custom, the entire SR will be serialized with only the wkt property. Starting at 10.3, Image Service supports image coordinate systems.

property
as_arcpy
¶ returns the class as an arcpy SpatialReference object

svg
(scale_factor=1, fill_color=None)¶ represents the SVG of the object

property
type
¶

property
Geometry¶

class
arcgis.geometry.
Geometry
(iterable=None, **kwargs)¶ The base class for all geometries.
You can create a Geometry even when you don’t know the exact type. The Geometry constructor is able to figure out the geometry type and returns the correct type as the example below demonstrates:
geom = Geometry({ "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} }) print (geom.type) # POLYGON print (isinstance(geom, Polygon) # True

property
JSON
¶ Returns an Esri JSON representation of the geometry as a string.
 Returns
string

property
WKB
¶ Returns the wellknown binary (WKB) representation for OGC geometry. It provides a portable representation of a geometry value as a contiguous stream of bytes.
 Returns
bytes

property
WKT
¶ Returns the wellknown text (WKT) representation for OGC geometry. It provides a portable representation of a geometry value as a text string. Any true curves in the geometry will be densified into approximate curves in the WKT string.
 Returns
string

angle_distance_to
(second_geometry, method='GEODESIC')¶ Returns a tuple of angle and distance to another point using a measurement type. If ArcPy is not installed, none is returned.
Requires ArcPy
Argument
Description
second_geometry
Required Geometry. A arcgis.Geometry object.
method
Optional String. PLANAR measurements reflect the projection of geographic data onto the 2D surface (in other words, they will not take into account the curvature of the earth). GEODESIC, GREAT_ELLIPTIC, LOXODROME, and PRESERVE_SHAPE measurement types may be chosen as an alternative, if desired.
 Returns
a tuple of angle and distance to another point using a measurement type.

property
area
¶ The area of a polygon feature. None for all other feature types. The area is in the units of the spatial reference.
>>> geom = Geometry({ "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} }) >>> geom.area 1.869999999973911e06
 Returns
float

property
as_arcpy
¶ Returns the Geometry as an ArcPy Geometry.
If ArcPy is not installed, none is returned.
Requires ArcPy
 Returns
arcpy.Geometry

property
as_shapely
¶ returns a shapely geometry object

boundary
()¶ Constructs the boundary of the geometry.
 Returns
arcgis.geometry.Polyline

buffer
(distance)¶ Constructs a polygon at a specified distance from the geometry.
Requires ArcPy
Argument
Description
distance
Required float. The buffer distance. The buffer distance is in the same units as the geometry that is being buffered. A negative distance can only be specified against a polygon geometry.
 Returns
arcgis.geometry.Polygon

property
centroid
¶ Returns the center of the geometry
Requires ArcPy or Shapely
>>> geom = Geometry({ "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} }) >>> geom.centroid (97.06258999999994, 32.754333333000034)
 Returns
tuple(x,y)

clip
(envelope)¶ Constructs the intersection of the geometry and the specified extent. If ArcPy is not installed, none is returned.
Requires ArcPy
Argument
Description
envelope
required tuple. The tuple must have (XMin, YMin, XMax, YMax) each value represents the lower left bound and upper right bound of the extent.
 Returns
output geometry clipped to extent

contains
(second_geometry, relation=None)¶ Indicates if the base geometry contains the comparison geometry.
Requires ArcPy/Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
relation
Optional string. The spatial relationship type.
BOUNDARY  Relationship has no restrictions for interiors or boundaries.
CLEMENTINI  Interiors of geometries must intersect. Specifying CLEMENTINI is equivalent to specifying None. This is the default.
PROPER  Boundaries of geometries must not intersect.
 Returns
boolean

convex_hull
()¶ Constructs the geometry that is the minimal bounding polygon such that all outer angles are convex.

crosses
(second_geometry)¶ Indicates if the two geometries intersect in a geometry of a lesser shape type.
Requires ArcPy/Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
 Returns
boolean

cut
(cutter)¶ Splits this geometry into a part left of the cutting polyline, and a part right of it.
Requires ArcPy
Argument
Description
cutter
Required Polyline. The cuttin polyline geometry
 Returns
a list of two geometries

densify
(method, distance, deviation)¶ Creates a new geometry with added vertices
Requires ArcPy
Argument
Description
method
Required String. The type of densification, DISTANCE, ANGLE, or GEODESIC
distance
Required float. The maximum distance between vertices. The actual distance between vertices will usually be less than the maximum distance as new vertices will be evenly distributed along the original segment. If using a type of DISTANCE or ANGLE, the distance is measured in the units of the geometry’s spatial reference. If using a type of GEODESIC, the distance is measured in meters.
deviation
Required float. Densify uses straight lines to approximate curves. You use deviation to control the accuracy of this approximation. The deviation is the maximum distance between the new segment and the original curve. The smaller its value, the more segments will be required to approximate the curve.
 Returns
arcgis.geometry.Geometry

difference
(second_geometry)¶ Constructs the geometry that is composed only of the region unique to the base geometry but not part of the other geometry. The following illustration shows the results when the red polygon is the source geometry.
Requires ArcPy/Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
 Returns
arcgis.geometry.Geometry

disjoint
(second_geometry)¶ Indicates if the base and comparison geometries share no points in common.
Requires ArcPy/Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
 Returns
boolean

distance_to
(second_geometry)¶ Returns the minimum distance between two geometries. If the geometries intersect, the minimum distance is 0. Both geometries must have the same projection.
Requires ArcPy/Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
 Returns
float

property
envelope
¶ Returns the geoextent as an Envelope object

equals
(second_geometry)¶ Indicates if the base and comparison geometries are of the same shape type and define the same set of points in the plane. This is a 2D comparison only; M and Z values are ignored.
Requires ArcPy or Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
 Returns
boolean

property
extent
¶ The extent of the geometry as a tuple containing xmin, ymin, xmax, ymax
Requires ArcPy or Shapely
>>> geom = Geometry({ "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} }) >>> geom.extent (97.06326, 32.749, 97.06124, 32.837)
 Returns
tuple

property
first_point
¶ The first coordinate point of the geometry.
>>> geom = Geometry({ "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} }) >>> geom.first_point {'x': 97.06138, 'y': 32.837, 'spatialReference': {'wkid': 4326, 'latestWkid': 4326}}
 Returns
arcgis.gis.Geometry

classmethod
from_shapely
(shapely_geometry, spatial_reference=None)¶ Creates a Python API Geometry object from a Shapely geometry object.
 Returns
arcgis.geometry.Geometry
# Usage Example: importing shapely geometry object and setting spatial reference to WGS84 Geometry.from_shapely( shapely_geometry=shapely_geometry_object, spatial_reference={'wkid': 4326} )

generalize
(max_offset)¶ Creates a new simplified geometry using a specified maximum offset tolerance.
Requires ArcPy or Shapely
Argument
Description
max_offset
Required float. The maximum offset tolerance.
 Returns
arcgis.geometry.Geometry

property
geoextent
¶ Returns the current feature’s extent
>>> g = Geometry({...}) >>> g.geoextent (1,2,3,4)
 Returns
tuple

property
geometry_type
¶ The geometry type: polygon, polyline, point, multipoint
>>> geom = Geometry({ "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} }) >>> geom.geometry_type 'polygon'
 Returns
string

get_area
(method, units=None)¶ Returns the area of the feature using a measurement type.
Requires ArcPy or Shapely
Argument
Description
method
Required String. LANAR measurements reflect the projection of geographic data onto the 2D surface (in other words, they will not take into account the curvature of the earth). GEODESIC, GREAT_ELLIPTIC, LOXODROME, and PRESERVE_SHAPE measurement types may be chosen as an alternative, if desired.
units
Optional String. Areal unit of measure keywords: ACRES  ARES  HECTARES  SQUARECENTIMETERS  SQUAREDECIMETERS  SQUAREINCHES  SQUAREFEET  SQUAREKILOMETERS  SQUAREMETERS  SQUAREMILES  SQUAREMILLIMETERS  SQUAREYARDS
 Returns
float

get_length
(method, units)¶ Returns the length of the feature using a measurement type.
Requires ArcPy or Shapely
Argument
Description
method
Required String. PLANAR measurements reflect the projection of geographic data onto the 2D surface (in other words, they will not take into account the curvature of the earth). GEODESIC, GREAT_ELLIPTIC, LOXODROME, and PRESERVE_SHAPE measurement types may be chosen as an alternative, if desired.
units
Required String. Linear unit of measure keywords: CENTIMETERS  DECIMETERS  FEET  INCHES  KILOMETERS  METERS  MILES  MILLIMETERS  NAUTICALMILES  YARDS
 Returns
float

get_part
(index=None)¶ Returns an array of point objects for a particular part of geometry or an array containing a number of arrays, one for each part.
Requires ArcPy
Argument
Description
index
Required Integer. The index position of the geometry.
 Returns
arcgis.geometry.Geometry

property
has_m
¶ Determines if the geometry has a M value.
 Returns
Boolean

property
has_z
¶ Determines if the geometry has a Z value.
 Returns
Boolean

property
hull_rectangle
¶ A spacedelimited string of the coordinate pairs of the convex hull rectangle.
Requires ArcPy or Shapely
>>> geom = Geometry({ "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} }) >>> geom.hull_rectangle '97.06153 32.749 97.0632940971127 32.7490060186843 97.0629938635673 32.8370055061228 97.0612297664546 32.8369994874385'
 Returns
string

intersect
(second_geometry, dimension=1)¶ Constructs a geometry that is the geometric intersection of the two input geometries. Different dimension values can be used to create different shape types. The intersection of two geometries of the same shape type is a geometry containing only the regions of overlap between the original geometries.
Requires ArcPy or Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
dimension
Required Integer. The topological dimension (shape type) of the resulting geometry.
1 A zerodimensional geometry (point or multipoint).
2 A onedimensional geometry (polyline).
4 A twodimensional geometry (polygon).
 Returns
boolean

property
is_empty
¶ boolean value that determines if the geometry is empty or not

property
is_multipart
¶ True, if the number of parts for this geometry is more than one.
Requires ArcPy or Shapely
>>> geom = Geometry({ "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} }) >>> geom.is_multipart True
 Returns
boolean

property
label_point
¶ The point at which the label is located. The label_point is always located within or on a feature.
Requires ArcPy or Shapely
>>> geom = Geometry({ "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} }) >>> geom.label_point {'x': 97.06258999999994, 'y': 32.754333333000034, 'spatialReference': {'wkid': 4326, 'latestWkid': 4326}}
 Returns
arcgis.geometry.Point

property
last_point
¶ The last coordinate of the feature.
>>> geom = Geometry({ "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} }) >>> geom.last_point {'x': 97.06326, 'y': 32.759, 'spatialReference': {'wkid': 4326, 'latestWkid': 4326}}
 Returns
arcgis.geometry.Point

property
length
¶ The length of the linear feature. Zero for point and multipoint feature types. The length units is the same as the spatial reference.
Requires ArcPy or Shapely
>>> geom = Geometry({ "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} }) >>> geom.length 0.03033576008004027
 Returns
float

property
length3D
¶ The 3D length of the linear feature. Zero for point and multipoint feature types. The length units is the same as the spatial reference.
Requires ArcPy or Shapely
>>> geom = Geometry({ "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} }) >>> geom.length3D 0.03033576008004027
 Returns
float

measure_on_line
(second_geometry, as_percentage=False)¶ Returns a measure from the start point of this line to the in_point.
Requires ArcPy
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
as_percentage
Optional Boolean. If False, the measure will be returned as a distance; if True, the measure will be returned as a percentage.
 Returns
float

overlaps
(second_geometry)¶ Indicates if the intersection of the two geometries has the same shape type as one of the input geometries and is not equivalent to either of the input geometries.
Requires ArcPy or Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
 Returns
boolean

property
part_count
¶ The number of geometry parts for the feature.
>>> geom = Geometry({ "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} }) >>> geom.part_count 1
 Returns
integer

property
point_count
¶ The total number of points for the feature.
>>> geom = Geometry({ "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} }) >>> geom.point_count 9
 Returns
Integer

point_from_angle_and_distance
(angle, distance, method='GEODESCIC')¶ Returns a point at a given angle and distance in degrees and meters using the specified measurement type.
Requires ArcPy
Argument
Description
angle
Required Float. The angle in degrees to the returned point.
distance
Required Float. The distance in meters to the returned point.
method
Optional String. PLANAR measurements reflect the projection of geographic data onto the 2D surface (in other words, they will not take into account the curvature of the earth). GEODESIC, GREAT_ELLIPTIC, LOXODROME, and PRESERVE_SHAPE measurement types may be chosen as an alternative, if desired.
 Returns
arcgis.geometry.Geometry

position_along_line
(value, use_percentage=False)¶ Returns a point on a line at a specified distance from the beginning of the line.
Requires ArcPy or Shapely
Argument
Description
value
Required Float. The distance along the line.
use_percentage
Optional Boolean. The distance may be specified as a fixed unit of measure or a ratio of the length of the line. If True, value is used as a percentage; if False, value is used as a distance. For percentages, the value should be expressed as a double from 0.0 (0%) to 1.0 (100%).
 Returns
arcgis.gis.Geometry

project_as
(spatial_reference, transformation_name=None)¶ Projects a geometry and optionally applies a geotransformation.
Requires ArcPy or pyproj>=1.9 and PROJ.4
Argument
Description
spatial_reference
Required SpatialReference. The new spatial reference. This can be a SpatialReference object or the coordinate system name.
transformation_name
Required String. The geotransformation name.
 Parameter:
 spatial_reference
The new spatial reference. This can be a
SpatialReference object or the coordinate system name.
 transformation_name
The geotransformation name.

query_point_and_distance
(second_geometry, use_percentage=False)¶ Finds the point on the polyline nearest to the in_point and the distance between those points. Also returns information about the side of the line the in_point is on as well as the distance along the line where the nearest point occurs.
Requires ArcPy
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
as_percentage
Optional boolean  if False, the measure will be returned as distance, True, measure will be a percentage
 Returns
tuple

rotate
(theta, inplace=False)¶ Rotates a geometry counterclockwise by a given angle.
Argument
Description
theta
Required Float. The rotation angle.
inplace
Optional Boolean. If True, the value is updated in the object, False creates a new object
 Returns
Geometry

scale
(x_scale=1, y_scale=1, inplace=False)¶ Scales in either the x,y or both directions
Argument
Description
x_scale
Optional Float. The xscale factor.
y_scale
Optional Float. The yscale factor.
inplace
Optional Boolean. If True, the value is updated in the object, False creates a new object
 Returns
Geometry

segment_along_line
(start_measure, end_measure, use_percentage=False)¶ Returns a Polyline between start and end measures. Similar to Polyline.positionAlongLine but will return a polyline segment between two points on the polyline instead of a single point.
Requires ArcPy
Argument
Description
start_measure
Required Float. The starting distance from the beginning of the line.
end_measure
Required Float. The ending distance from the beginning of the line.
use_percentage
Optional Boolean. The start and end measures may be specified as fixed units or as a ratio. If True, start_measure and end_measure are used as a percentage; if False, start_measure and end_measure are used as a distance. For percentages, the measures should be expressed as a double from 0.0 (0 percent) to 1.0 (100 percent).

skew
(x_angle=0, y_angle=0, inplace=False)¶ Create a skew transform along one or both axes.
Argument
Description
x_angle
optional Float. Angle to skew in the x coordinate
y_angle
Optional Float. Angle to skew in the y coordinate
inplace
Optional Boolean. If True, the value is updated in the object, False creates a new object
 Returns
Geometry

snap_to_line
(second_geometry)¶ Returns a new point based on in_point snapped to this geometry.
Requires ArcPy
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
 Returns
arcgis.gis.Geometry

property
spatial_reference
¶ The spatial reference of the geometry.
>>> geom = Geometry({ "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} }) >>> geom.spatial_reference <SpatialReference Class>
 Returns
arcgis.geometery.SpatialReference

symmetric_difference
(second_geometry)¶ Constructs the geometry that is the union of two geometries minus the instersection of those geometries.
The two input geometries must be the same shape type.
Requires ArcPy or Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
 Returns
arcgis.gis.Geometry

touches
(second_geometry)¶ Indicates if the boundaries of the geometries intersect.
Requires ArcPy or Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
 Returns
boolean

translate
(x_offset=0, y_offset=0, inplace=False)¶ moves a geometry in a given x and y distance
Argument
Description
x_offset
Optional Float. Translation x offset
y_offset
Optional Float. Translation y offset
inplace
Optional Boolean. If False, updates the existing Geometry,else it creates a new Geometry object
 Returns
Geometry

property
true_centroid
¶ The center of gravity for a feature.
Requires ArcPy or Shapely
>>> geom = Geometry({ "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} }) >>> geom.true_centroid {'x': 97.06272135472369, 'y': 32.746201426025, 'spatialReference': {'wkid': 4326, 'latestWkid': 4326}}
 Returns
arcgis.geometry.Point

union
(second_geometry)¶ Constructs the geometry that is the settheoretic union of the input geometries.
Requires ArcPy or Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
 Returns
arcgis.gis.Geometry

within
(second_geometry, relation=None)¶ Indicates if the base geometry is within the comparison geometry.
Requires ArcPy or Shapely
Argument
Description
second_geometry
Required arcgis.geometry.Geometry. A second geometry
relation
Optional String. The spatial relationship type.
BOUNDARY  Relationship has no restrictions for interiors or boundaries.
CLEMENTINI  Interiors of geometries must intersect. Specifying CLEMENTINI is equivalent to specifying None. This is the default.
PROPER  Boundaries of geometries must not intersect.
 Returns
boolean

property
areas_and_lengths¶

arcgis.geometry.
areas_and_lengths
(polygons, length_unit, area_unit, calculation_type, spatial_ref=4326, gis=None)¶ The areas_and_lengths function calculates areas and perimeter lengths for each polygon specified in the input array.
 Inputs:
 polygons  The array of polygons whose areas and lengths are
to be computed.
 length_unit  The length unit in which the perimeters of
polygons will be calculated. If calculation_type is planar, then length_unit can be any esriUnits constant. If lengthUnit is not specified, the units are derived from spatial_ref. If calculationType is not planar, then lengthUnit must be a linear esriUnits constant, such as esriSRUnit_Meter or esriSRUnit_SurveyMile. If length_unit is not specified, the units are meters. For a list of valid units, see esriSRUnitType Constants and esriSRUnit2Type Constant.
 area_unit  The area unit in which areas of polygons will be
calculated. If calculation_type is planar, then area_unit can be any esriUnits constant. If area_unit is not specified, the units are derived from spatial_ref. If calculation_type is not planar, then area_unit must be a linear esriUnits constant such as esriSRUnit_Meter or esriSRUnit_SurveyMile. If area_unit is not specified, then the units are meters. For a list of valid units, see esriSRUnitType Constants and esriSRUnit2Type constant. The list of valid esriAreaUnits constants include, esriSquareInches  esriSquareFeet  esriSquareYards  esriAcres  esriSquareMiles  esriSquareMillimeters  esriSquareCentimeters  esriSquareDecimeters  esriSquareMeters  esriAres  esriHectares  esriSquareKilometers.
 calculation_type  The type defined for the area and length
calculation of the input geometries. The type can be one of the following values: planar  Planar measurements use 2D
Euclidean distance to calculate area and length. Th should only be used if the area or length needs to be calculated in the given spatial reference. Otherwise, use preserveShape.
 geodesic  Use this type if you want to
calculate an area or length using only the vertices of the polygon and define the lines between the points as geodesic segments independent of the actual shape of the polygon. A geodesic segment is the shortest path between two points on an ellipsoid.
 preserveShape  This type calculates the
area or length of the geometry on the surface of the Earth ellipsoid. The shape of the geometry in its coordinate system is preserved.
 Output:
JSON as dictionary
auto_complete¶

arcgis.geometry.
auto_complete
(polygons=None, polylines=None, spatial_ref=None, gis=None)¶ The auto_complete function simplifies the process of constructing new polygons that are adjacent to other polygons. It constructs polygons that fill in the gaps between existing polygons and a set of polylines.
 Inputs:
 polygons 
array of Polygon objects
 polylines 
list of Polyline objects
 spatial_ref 
spatial reference of the input geometries WKID
buffer¶

arcgis.geometry.
buffer
(geometries, in_sr, distances, unit, out_sr=None, buffer_sr=None, union_results=None, geodesic=None, gis=None)¶ The buffer function is performed on a geometry service resource The result of this function is buffered polygons at the specified distances for the input geometry array. Options are available to union buffers and to use geodesic distance.
Inputs:
 geometries 
The array of geometries to be buffered.
 in_sr 
The wellknown ID of the spatial reference or a spatial reference JSON object for the input geometries.
 distances 
The distances that each of the input geometries is buffered.
 unit  The units for calculating each buffer distance. If unit
is not specified, the units are derived from bufferSR. If bufferSR is not specified, the units are derived from in_sr.
 out_sr  The wellknown ID of the spatial reference or a
spatial reference JSON object for the input geometries.
 buffer_sr  The wellknown ID of the spatial reference or a
spatial reference JSON object for the input geometries.
 union_results  If true, all geometries buffered at a given
distance are unioned into a single (gis,possibly multipart) polygon, and the unioned geometry is placed in the output array. The default is false
 geodesic  Set geodesic to true to buffer the input geometries
using geodesic distance. Geodesic distance is the shortest path between two points along the ellipsoid of the earth. If geodesic is set to false, the 2D Euclidean distance is used to buffer the input geometries. The default value depends on the geometry type, unit and bufferSR.
convex_hull¶

arcgis.geometry.
convex_hull
(geometries, spatial_ref=None, gis=None)¶ The convex_hull function is performed on a geometry service resource. It returns the convex hull of the input geometry. The input geometry can be a point, multipoint, polyline, or polygon. The convex hull is typically a polygon but can also be a polyline or point in degenerate cases.
 Inputs:
geometries  The geometries whose convex hull is to be created. spatial_ref  The wellknown ID or a spatial reference JSON object for
the output geometry.
cut¶

arcgis.geometry.
cut
(cutter, target, spatial_ref=None, gis=None)¶ The cut function is performed on a geometry service resource. This function splits the target polyline or polygon where it’s crossed by the cutter polyline. At 10.1 and later, this function calls simplify on the input cutter and target geometries.
 Inputs:
 cutter  The polyline that will be used to divide the target
into pieces where it crosses the target.The spatial reference of the polylines is specified by spatial_ref. The structure of the polyline is the same as the structure of the JSON polyline objects returned by the ArcGIS REST API.
 target  The array of polylines/polygons to be cut. The
structure of the geometry is the same as the structure of the JSON geometry objects returned by the ArcGIS REST API. The spatial reference of the target geometry array is specified by spatial_ref.
 spatial_ref  The wellknown ID or a spatial reference JSON object for
the output geometry.
densify¶

arcgis.geometry.
densify
(geometries, spatial_ref, max_segment_length, length_unit, geodesic=False, gis=None)¶ The densify function is performed using the GIS’s geometry engine. This function densifies geometries by plotting points between existing vertices.
 Inputs:
 geometries  The array of geometries to be densified. The
structure of each geometry in the array is the same as the structure of the JSON geometry objects returned by the ArcGIS REST API.
 spatial_ref  The wellknown ID or a spatial reference JSON object for
the input polylines. For a list of valid WKID values, see Projected coordinate systems and Geographic coordinate systems.
 max_segment_length  All segments longer than maxSegmentLength are
replaced with sequences of lines no longer than max_segment_length.
 length_unit  The length unit of max_segment_length. If geodesic is
set to false, then the units are derived from spatial_ref, and length_unit is ignored. If geodesic is set to true, then length_unit must be a linear unit. In a case where length_unit is not specified and spatial_ref is a PCS, the units are derived from spatial_ref. In a case where length_unit is not specified and spatial_ref is a GCS, then the units are meters.
 geodesic  If geodesic is set to true, then geodesic distance is
used to calculate max_segment_length. Geodesic distance is the shortest path between two points along the ellipsoid of the earth. If geodesic is set to false, then 2D Euclidean distance is used to calculate max_segment_length. The default is false.
difference¶

arcgis.geometry.
difference
(geometries, spatial_ref, geometry, gis=None)¶ The difference function is performed on a geometry service resource. This function constructs the settheoretic difference between each element of an array of geometries and another geometry the socalled difference geometry. In other words, let B be the difference geometry. For each geometry, A, in the input geometry array, it constructs AB.
 Inputs:
 geometries  An array of points, multipoints, polylines or
polygons. The structure of each geometry in the array is the same as the structure of the JSON geometry objects returned by the ArcGIS REST API.
 geometry  A single geometry of any type and of a dimension equal
to or greater than the elements of geometries. The structure of geometry is the same as the structure of the JSON geometry objects returned by the ArcGIS REST API. The use of simple syntax is not supported.
 spatial_ref  The wellknown ID of the spatial reference or a spatial
reference JSON object for the input geometries.
distance¶

arcgis.geometry.
distance
(spatial_ref, geometry1, geometry2, distance_unit='', geodesic=False, gis=None)¶ The distance function is performed on a geometry service resource. It reports the 2D Euclidean or geodesic distance between the two geometries.
 Inputs:
 spatial_ref  The wellknown ID or a spatial reference JSON object for
input geometries.
 geometry1  The geometry from which the distance is to be
measured. The structure of the geometry is same as the structure of the JSON geometry objects returned by the ArcGIS REST API.
 geometry2  The geometry from which the distance is to be
measured. The structure of the geometry is same as the structure of the JSON geometry objects returned by the ArcGIS REST API.
 distanceUnit  specifies the units for measuring distance between
the geometry1 and geometry2 geometries.
 geodesic  If geodesic is set to true, then the geodesic distance
between the geometry1 and geometry2 geometries is returned. Geodesic distance is the shortest path between two points along the ellipsoid of the earth. If geodesic is set to false or not specified, the planar distance is returned. The default value is false.
find_transformation¶

arcgis.geometry.
find_transformation
(in_sr, out_sr, extent_of_interest=None, num_of_results=1, gis=None)¶ The find_transformations function is performed on a geometry service resource. This function returns a list of applicable geographic transformations you should use when projecting geometries from the input spatial reference to the output spatial reference. The transformations are in JSON format and are returned in order of most applicable to least applicable. Recall that a geographic transformation is not needed when the input and output spatial references have the same underlying geographic coordinate systems. In this case, findTransformations returns an empty list. Every returned geographic transformation is a forward transformation meaning that it can be used asis to project from the input spatial reference to the output spatial reference. In the case where a predefined transformation needs to be applied in the reverse direction, it is returned as a forward composite transformation containing one transformation and a transformForward element with a value of false.
 Inputs:
 in_sr  The wellknown ID (gis,WKID) of the spatial reference or a
spatial reference JSON object for the input geometries
 out_sr  The wellknown ID (gis,WKID) of the spatial reference or a
spatial reference JSON object for the input geometries
 extent_of_interest  The bounding box of the area of interest
specified as a JSON envelope. If provided, the extent of interest is used to return the most applicable geographic transformations for the area. If a spatial reference is not included in the JSON envelope, the in_sr is used for the envelope.
 num_of_results  The number of geographic transformations to
return. The default value is 1. If num_of_results has a value of 1, all applicable transformations are returned.
from_geo_coordinate_string¶

arcgis.geometry.
from_geo_coordinate_string
(spatial_ref, strings, conversion_type, conversion_mode=None, gis=None)¶ The from_geo_coordinate_string function is performed on a geometry service resource. The function converts an array of wellknown strings into xycoordinates based on the conversion type and spatial reference supplied by the user. An optional conversion mode parameter is available for some conversion types.
 Inputs:
 spatial_ref  The wellknown ID of the spatial reference or a spatial
reference json object.
 strings  An array of strings formatted as specified by
conversion_type. Syntax: [<string1>,…,<stringN>] Example: [“01N AA 66021 00000”,”11S NT 00000 62155”,
“31U BT 94071 65288”]
 conversion_type  The conversion type of the input strings.
 Valid conversion types are:
MGRS  Military Grid Reference System USNG  United States National Grid UTM  Universal Transverse Mercator GeoRef  World Geographic Reference System GARS  Global Area Reference System DMS  Degree Minute Second DDM  Degree Decimal Minute DD  Decimal Degree
 conversion_mode  Conversion options for MGRS, UTM and GARS
conversion types. Conversion options for MGRS and UTM conversion types. Valid conversion modes for MGRS are:
 mgrsDefault  Default. Uses the spheroid from the given spatial
reference.
 mgrsNewStyle  Treats all spheroids as new, like WGS 1984. The
180 degree longitude falls into Zone 60.
 mgrsOldStyle  Treats all spheroids as old, like Bessel 1841.
The 180 degree longitude falls into Zone 60.
 mgrsNewWith180InZone01  Same as mgrsNewStyle except the 180
degree longitude falls into Zone 01.
 mgrsOldWith180InZone01  Same as mgrsOldStyle except the 180
degree longitude falls into Zone 01.
 Valid conversion modes for UTM are:
utmDefault  Default. No options. utmNorthSouth  Uses north/south latitude indicators instead of
zone numbers. Nonstandard. Default is recommended
generalize¶

arcgis.geometry.
generalize
(spatial_ref, geometries, max_deviation, deviation_unit, gis=None)¶ The generalize function is performed on a geometry service resource. The generalize function simplifies the input geometries using the DouglasPeucker algorithm with a specified maximum deviation distance. The output geometries will contain a subset of the original input vertices.
 Inputs:
 spatial_ref  The wellknown ID or a spatial reference JSON object for the
input geometries.
geometries  The array of geometries to be generalized. max_deviation  max_deviation sets the maximum allowable offset,
which will determine the degree of simplification. This value limits the distance the output geometry can differ from the input geometry.
 deviation_unit  A unit for maximum deviation. If a unit is not
specified, the units are derived from spatial_ref.
intersect¶

arcgis.geometry.
intersect
(spatial_ref, geometries, geometry, gis=None)¶ The intersect function is performed on a geometry service resource. This function constructs the settheoretic intersection between an array of geometries and another geometry. The dimension of each resultant geometry is the minimum dimension of the input geometry in the geometries array and the other geometry specified by the geometry parameter.
 Inputs:
 spatial_ref  The wellknown ID or a spatial reference JSON object for the
input geometries.
 geometries  An array of points, multipoints, polylines, or
polygons. The structure of each geometry in the array is the same as the structure of the JSON geometry objects returned by the ArcGIS REST API.
 geometry  A single geometry of any type with a dimension equal to
or greater than the elements of geometries.
label_points¶

arcgis.geometry.
label_points
(spatial_ref, polygons, gis=None)¶ The label_points function is performed on a geometry service resource. The labelPoints function calculates an interior point for each polygon specified in the input array. These interior points can be used by clients for labeling the polygons.
 Inputs:
 spatial_ref  The wellknown ID of the spatial reference or a spatial
reference JSON object for the input polygons.
 polygons  The array of polygons whose label points are to be
computed. The spatial reference of the polygons is specified by spatial_ref.
lengths¶

arcgis.geometry.
lengths
(spatial_ref, polylines, length_unit, calculation_type, gis=None)¶ The lengths function is performed on a geometry service resource. This function calculates the 2D Euclidean or geodesic lengths of each polyline specified in the input array.
 Inputs:
 spatial_ref  The wellknown ID of the spatial reference or a spatial
reference JSON object for the input polylines.
 polylines  The array of polylines whose lengths are to be
computed.
 length_unit  The unit in which lengths of polylines will be
calculated. If calculation_type is planar, then length_unit can be any esriUnits constant. If calculation_type is planar and length_unit is not specified, then the units are derived from spatial_ref. If calculation_type is not planar, then length_unit must be a linear esriUnits constant such as esriSRUnit_Meter or esriSRUnit_SurveyMile. If calculation_type is not planar and length_unit is not specified, then the units are meters.
 calculation_type  calculation_type 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. This type should only be used if the length needs to be calculated in the given spatial reference. Otherwise, use preserveShape.
 geodesic  Use this type if you want 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.
offset¶

arcgis.geometry.
offset
(geometries, offset_distance, offset_unit, offset_how='esriGeometryOffsetRounded', bevel_ratio=10, simplify_result=False, spatial_ref=None, gis=None)¶ The offset function is performed on a geometry service resource. This function constructs geometries that are offset from the given input geometries. If the offset parameter is positive, the constructed offset will be on the right side of the geometry. Left side offsets are constructed with negative parameters. Tracing the geometry from its first vertex to the last will give you a direction along the geometry. It is to the right and left perspective of this direction that the positive and negative parameters will dictate where the offset is constructed. In these terms, it is simple to infer where the offset of even horizontal geometries will be constructed.
 Inputs:
geometries  The array of geometries to be offset. offset_distance  Specifies the distance for constructing an offset
based on the input geometries. If the offset_distance parameter is positive, the constructed offset will be on the right side of the curve. Leftside offsets are constructed with negative values.
 offset_unit  A unit for offset distance. If a unit is not
specified, the units are derived from spatial_ref.
 offset_how  The offset_how parameter determines how outer corners
 between segments are handled. The three options are as follows:
 esriGeometryOffsetRounded  Rounds the corner between extended
offsets.
 esriGeometryOffsetBevelled  Squares off the corner after a
given ratio distance.
 esriGeometryOffsetMitered  Attempts to allow extended offsets
to naturally intersect, but if that intersection occurs too far from the corner, the corner is eventually bevelled off at a fixed distance.
 bevel_ratio  bevel_ratio is multiplied by the offset distance, and
the result determines how far a mitered offset intersection can be located before it is bevelled. When mitered is specified, bevel_ratio is ignored and 10 is used internally. When bevelled is specified, 1.1 will be used if bevel_ratio is not specified. bevel_ratio is ignored for rounded offset.
 simplify_result  if simplify_result is set to true, then self
intersecting loops will be removed from the result offset geometries. The default is false.
 spatial_ref  The wellknown ID or a spatial reference JSON object for the
input geometries.
project¶

arcgis.geometry.
project
(geometries, in_sr, out_sr, transformation='', transform_forward=False, gis=None)¶ The project function is performed on a geometry service resource. This function projects an array of input geometries from the input spatial reference to the output spatial reference.
 Inputs:
geometries  The list of geometries to be projected. in_sr  The wellknown ID (gis,WKID) of the spatial reference or a
spatial reference JSON object for the input geometries.
 out_sr  The wellknown ID (gis,WKID) of the spatial reference or a
spatial reference JSON object for the input geometries.
 transformation  The WKID or a JSON object specifying the
geographic transformation (gis,also known as datum transformation) to be applied to the projected geometries. Note that a transformation is needed only if the output spatial reference contains a different geographic coordinate system than the input spatial reference.
 transform_forward  A Boolean value indicating whether or not to
transform forward. The forward or reverse direction of transformation is implied in the name of the transformation. If transformation is specified, a value for the transformForward parameter must also be specified. The default value is false.
 Example:
input_geom = [{“x”: 17568824.55, “y”: 2428377.35}, {“x”: 17568456.88, “y”: 2428431.352}] result = project(geometries = input_geom, in_sr = 3857, out_sr = 4326)
 returns:
a list of geometries in the out_sr coordinate system, for instance: [{“x”: 157.82343617279275, “y”: 21.305781607280093}, {“x”: 157.8201333369876, “y”: 21.306233559873714}]
relation¶

arcgis.geometry.
relation
(geometries1, geometries2, spatial_ref, spatial_relation='esriGeometryRelationIntersection', relation_param='', gis=None)¶ The relation function is performed on a geometry service resource. This function determines the pairs of geometries from the input geometry arrays that participate in the specified spatial relation. Both arrays are assumed to be in the spatial reference specified by spatial_ref, which is a required parameter. Geometry types cannot be mixed within an array. The relations are evaluated in 2D. In other words, z coordinates are not used.
 Inputs:
 geometries1  The first array of geometries used to compute the
relations.
geometries2 The second array of geometries used to compute the relations. spatial_ref  The wellknown ID of the spatial reference or a spatial
reference JSON object for the input geometries.
 spatial_relation  The spatial relationship to be tested between the two
input geometry arrays. Values: esriGeometryRelationCross  esriGeometryRelationDisjoint  esriGeometryRelationIn  esriGeometryRelationInteriorIntersection  esriGeometryRelationIntersection  esriGeometryRelationLineCoincidence  esriGeometryRelationLineTouch  esriGeometryRelationOverlap  esriGeometryRelationPointTouch  esriGeometryRelationTouch  esriGeometryRelationWithin  esriGeometryRelationRelation
 relation_param  The Shape Comparison Language string to be
evaluated.
reshape¶

arcgis.geometry.
reshape
(spatial_ref, target, reshaper, gis=None)¶ The reshape function is performed on a geometry service resource. It reshapes a polyline or polygon feature by constructing a polyline over the feature. The feature takes the shape of the reshaper polyline from the first place the reshaper intersects the feature to the last.
 Input:
 spatial_ref  The wellknown ID of the spatial reference or a spatial
reference JSON object for the input geometries.
target  The polyline or polygon to be reshaped. reshaper  The singlepart polyline that does the reshaping.
to_geo_coordinate_string¶

arcgis.geometry.
to_geo_coordinate_string
(spatial_ref, coordinates, conversion_type, conversion_mode='mgrsDefault', num_of_digits=None, rounding=True, add_spaces=True, gis=None)¶ The to_geo_coordinate_string function is performed on a geometry service resource. The function converts an array of xycoordinates into wellknown strings based on the conversion type and spatial reference supplied by the user. Optional parameters are available for some conversion types. Note that if an optional parameter is not applicable for a particular conversion type, but a value is supplied for that parameter, the value will be ignored.
 Inputs:
 spatial_ref  The wellknown ID of the spatial reference or a spatial
reference json object.
 coordinates  An array of xycoordinates in JSON format to be
converted. Syntax: [[x1,y2],…[xN,yN]]
 conversion_type  The conversion type of the input strings.
 Allowed Values:
MGRS  Military Grid Reference System USNG  United States National Grid UTM  Universal Transverse Mercator GeoRef  World Geographic Reference System GARS  Global Area Reference System DMS  Degree Minute Second DDM  Degree Decimal Minute DD  Decimal Degree
 conversion_mode  Conversion options for MGRS and UTM conversion
types. Valid conversion modes for MGRS are:
 mgrsDefault  Default. Uses the spheroid from the given spatial
reference.
 mgrsNewStyle  Treats all spheroids as new, like WGS 1984. The
180 degree longitude falls into Zone 60.
 mgrsOldStyle  Treats all spheroids as old, like Bessel 1841.
The 180 degree longitude falls into Zone 60.
 mgrsNewWith180InZone01  Same as mgrsNewStyle except the 180
degree longitude falls into Zone 01.
 mgrsOldWith180InZone01  Same as mgrsOldStyle except the 180
degree longitude falls into Zone 01.
 Valid conversion modes for UTM are:
utmDefault  Default. No options. utmNorthSouth  Uses north/south latitude indicators instead of
zone numbers. Nonstandard. Default is recommended.
 num_of_digits  The number of digits to output for each of the
numerical portions in the string. The default value for num_of_digits varies depending on conversion_type.
 rounding  If true, then numeric portions of the string are
rounded to the nearest whole magnitude as specified by numOfDigits. Otherwise, numeric portions of the string are truncated. The rounding parameter applies only to conversion types MGRS, USNG and GeoRef. The default value is true.
 addSpaces  If true, then spaces are added between components of
the string. The addSpaces parameter applies only to conversion types MGRS, USNG and UTM. The default value for MGRS is false, while the default value for both USNG and UTM is true.
trim_extend¶

arcgis.geometry.
trim_extend
(spatial_ref, polylines, trim_extend_to, extend_how=0, gis=None)¶ The trim_extend function is performed on a geometry service resource. This function trims or extends each polyline specified in the input array, using the userspecified guide polylines. When trimming features, the part to the left of the oriented cutting line is preserved in the output, and the other part is discarded. An empty polyline is added to the output array if the corresponding input polyline is neither cut nor extended.
 Inputs:
 spatial_ref  The wellknown ID of the spatial reference or a spatial
reference json object.
polylines  An array of polylines to be trimmed or extended. trim_extend_to  A polyline that is used as a guide for trimming or
extending input polylines.
 extend_how  A flag that is used along with the trimExtend
function. 0  By default, an extension considers both ends of a path. The
old ends remain, and new points are added to the extended ends. The new points have attributes that are extrapolated from adjacent existing segments.
 1  If an extension is performed at an end, relocate the end
point to the new position instead of leaving the old point and adding a new point at the new position.
 2  If an extension is performed at an end, do not extrapolate
the endsegment’s attributes for the new point. Instead, make its attributes the same as the current end. Incompatible with esriNoAttributes.
 4  If an extension is performed at an end, do not extrapolate
the endsegment’s attributes for the new point. Instead, make its attributes empty. Incompatible with esriKeepAttributes.
8  Do not extend the ‘from’ end of any path. 16  Do not extend the ‘to’ end of any path.
union¶

arcgis.geometry.
union
(spatial_ref, geometries, gis=None)¶ The union function is performed on a geometry service resource. This function constructs the settheoretic union of the geometries in the input array. All inputs must be of the same type.
Inputs: spatial_ref  The wellknown ID of the spatial reference or a spatial
reference json object.
geometries  The array of geometries to be unioned.