Note: The Relation and Label Points operations were added at 9.3 SP1.
New parameters for Areas and Lengths and Lengths operations were added at 10.
Auto Complete , Convex Hull ,
Cut , Densify ,
Difference , Generalize ,
Intersect , Offset ,
Reshape , Trim / Extend and Union operations were added at 10.
Description
A geometry service contains utility methods, which 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 that geometry input and output, where required, are always packaged as an array.
Use a geometry service to:
- Buffer, project, and simplify geometry
- Calculate areas and lengths for geometry
- Determine spatial relations and label points
- Determine distances between geometries
- Compute Union, Intersection and Difference between geometries
- Auto Complete, Generalize, Reshape, Offset, Trim/Extend and compute Convex Hull's of geometries
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:
- Project - Returns an array of projected geometries.
- Simplify - Returns an array of simplified geometries.
- 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.
- Areas and lengths - Calculates areas and perimeter lengths for each polygon specified in the input array.
- Lengths - Calculates the lengths of each polyline specified in the input array.
- Relation - Determines the pairs of geometries from the input geometry arrays that participate in the specified spatial relation.
- Label Points - Calculates an interior point for each polygon specified in the input array.
- Auto Complete - Simplifies the process of constructing polygons that are adjacent to other polygons.
- 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.
- Generalize - Returns generalized (Douglas-Poiker) versions of the input geometries.
- Intersect - Constructs the set-theoretic intersection between an array of geometries and another geometry.
- Offset - Constructs the offset of the given input polyline based on an offset distance.
- Reshape - Reshapes a polyline or a part of a polygon using a reshaping line.
- Trim / Extend - Trims / Extends each polyline specified in the input array, using the user specified guide polylines.
- Union - Constructs the set-theoretic union of the input geometries.
Resource Hierarchy
Parameters
Parameter |
Details |
f |
Description: The
response format. The default response format is html.
Values:
html | json |
Example Usage
Example 1: URL for the Geometry Service on sampleserver1.
http://sampleserver1.arcgisonline.com/ArcGIS/rest/services/Geometry/GeometryServer
JSON Response Syntax
{
"serviceDescription" : "<serviceDescription>"
}
JSON Response Example
{
"serviceDescription" : "Test Geometry Service Description"
}