Geometry service

A geometry service contains utility methods which provide access to sophisticated and frequently used geometric operations. An ArcGIS Server website can only expose one Geometry service with the static name "Geometry". Note that geometry input and output, where required, is always packaged as an array.

Use a geometry service to:

WSDL syntax

http://<host name>:<port number>/<arcgis instance>/services/Geometry/GeometryServer?wsdl

Working with a geometry service

Geometry service methods typically take as input a spatial reference (SR) and an array of geometries assumed to be in that spatial SR. This allows callers to avoid duplicating the spatial reference for each geometry in the array. Note that the SR cannot be null. The geometry returned from a method call is not associated with a SR. It is the consumer's responsibility to associate the returned geometries with the correct SR.

Finding a Well-Known ID

Working with a geometry service often involves defining a spatial reference, transformation, and/or unit. The International Association of Oil & Gas Producers (OGP) maintains a set of internationally recognized numeric codes to identify standard spatial references (coordinate systems), datum transformations, and linear and angular units of measure. The codes are termed EPSG codes or "factory codes" from the European Petroleum and Survey Group which was absorbed into the OGP. Esri has also defined a set of unique numeric codes to identify the same or similar geometric entities. Other authorities and groups can define their own unique numeric codes as well. In order to accommodate multiple authorities without overlapping codes, the geometry service uses an explicitly defined range of codes for known and unknown (custom) authorities. The codes are designed to identify a commonly recognized geometric entity, thus each code is termed a "well-known id". Here are the current rules for mapping WKID ranges to default authority names used by a geometry service:

WKIDs for the EPSG and Esri authorities are available for the following entities:

Spatial Reference - Geographic Coordinate Systems

Spatial Reference - Planar (Projected) Coordinate Systems

Datum Transformations

Methods

Proxy method

Description

AutoComplete

Constructs polygons that fill in the gaps between existing polygons and a set of polylines.

Buffer

Buffers an array of geometries by each distance specified in an array of distances.

BufferGeodesic

Constructs buffer regions around points, lines and polygons using geodesic distances and directions.

ConvexHull

Constructs the convex hull of the input geometries.

Cut

Splits input polylines or polygons where they cross a cutting polyline.

Densify

Converts non-linear geometry to linear geometry by adding vertices.

DensifyGeodesic

Connects input vertices with densified approximations to geodesic paths between them.

Difference

Constructs the set-theoretic difference between each geometry in an array and a given geometry.

FindSRByWKID

Defines a spatial reference based upon its well-known identifier (WKID) and optionally a WKID for a vertical datum.

FindSRByWKT

Defines a spatial reference based upon its well-known text string (WKT) and optionally a WKT for a vertical datum.

FindUnitsByWKID

Defines a unit object based on its EPSG or Esri WKID.

FindUnitsByWKT

Defines a unit object based on its EPSG or Esri WKT.

Generalize

Applies Douglas-Peucker generalization to the input polylines and polygons.

GetAreasAndLengths

Calculates area and perimeter for each input polygon based on the current coordinate system.

GetAreasAndLengths2

Calculates area and perimeter for each input polygon based on the current coordinate system, allowing specification of output units.

GetAreasAndLengthsGeodesic

Calculates geodesic area and perimeter for each input polygon.

GetAreasAndLengthsPreserveShape

Calculates true area and perimeter for each input polygon.

GetDistance

Calculates the shortest distance between two geometries based on the current coordinate system.

GetDistanceGeodesic

Calculates the geodesic distance between two geometries.

GetLabelPoints

Calculates points for label placement inside each input polygon.

GetLengths

Calculates length for each input polyline based on the current coordinate system.

GetLengths2

Calculates length for each input polyline based on the current coordinate system, allowing specification of output units.

GetLengthsGeodesic

Calculates geodesic length of each input polyline.

GetLengthsPreserveShape

Calculates the true length of each input polyline.

Intersect

Constructs the set-theoretic intersection of each input and another geometry.

Offset

Constructs offset copies of the input polylines or polygons.

Project

Projects an array of geometries from their current spatial reference to a destination spatial reference.

Relation

Determines the pairs of geometries from the input geometry arrays that participate in the specified spatial relation.

Reshape

Reshapes a polyline or polygon using a reshaping line.

Simplify

Simplifies a polyline or polygon by removing extraneous bends while preserving essential shape.

TrimExtend

Trims or extends each input polyline to meet another polyline.

Union

Constructs the set-theoretic union of the input geometries.

11/8/2016