Geometry Service

Description

A Geometry Service contains utility methods that provide access to sophisticated and frequently used geometric operations. An ArcGIS Server web site can only expose one geometry service with the static name "Geometry".

Note:

Geometry input and output, where required, are usually packaged as an array. See the Geometry Objects topic.

Use a geometry service to do the following:

  • Buffer, project, and simplify geometry.
  • Calculate areas and lengths for geometry.
  • Determine spatial relations and label points.
  • Determine distances between geometries.
  • Apply Union, Intersection, and Difference operations between geometries.
  • Auto Complete, Generalize, Reshape, Offset, Trim/Extend, and compute Convex Hulls of geometries.
  • Convert to or from geographic coordinate strings.

The REST API Geometry Service resource is primarily a processing and algorithmic resource that supports operations related to geometries. The Geometry Service resource has the following operations:

  • Areas and Lengths—Calculates areas and perimeter lengths for each polygon specified in the input array.
  • Auto Complete—Simplifies the process of constructing polygons that are adjacent to other polygons.
  • Buffer—Returns an array of polygons at the specified distances for the input geometry. An option is available to union buffer polygons at each distance.
  • Convex Hull—Returns the convex hull of the input geometry.
  • Cut—Splits the input polyline or polygon where it crosses a cutting polyline.
  • Densify—Densifies geometries by plotting intermediate points between existing vertices.
  • Difference—Constructs the set-theoretic difference between an array of geometries and another geometry.
  • Distance—Calculates the distance between two geometries.
  • Find Transformations—Gets a list of geographic transformations.
  • From GeoCoordinateString—Converts a list of strings in a well-known format to x,y coordinates.
  • Generalize—Returns generalized (Douglas-Peucker) versions of the input geometries.
  • Intersect—Constructs the set-theoretic intersection between an array of geometries and another geometry.
  • Label Points—Calculates an interior point for each polygon specified in the input array.
  • Lengths—Calculates the length of each polyline specified in the input array.
  • Offset—Constructs the offset of the given input polyline based on an offset distance.
  • Project—Returns an array of projected geometries.
  • Relation—Determines the pairs of geometries from the input geometry arrays that participate in the specified spatial relation.
  • Reshape—Reshapes a polyline or a part of a polygon using a reshaping line.
  • Simplify—Returns an array of topologically correct geometries.
  • To GeoCoordinateString—Converts a list of coordinates into strings in a well-known format based on the specified conversion type.
  • Trim/Extend—Trims or extends each polyline specified in the input array using the user-specified guide polylines.
  • Union—Constructs the set-theoretic union of the input geometries.

Request parameters

ParameterDetails
f

Description: The response format. The default response format is html.

Values: html | json

Example usage

URL for the geometry service on sampleserver6.

http://sampleserver6.arcgisonline.com/ArcGIS/rest/services/Utilities/Geometry/GeometryServer

JSON response syntax

{"serviceDescription" : "<serviceDescription>"}

JSON response example

{"serviceDescription" : "Test Geometry Service Description"}