- URL:
- https://<root>/Utilities/Geometry/GeometryServer/trimExtend
- Methods:
GET
- Version Introduced:
- 10.0
Description
The trim
operation is performed on a geometry service resource. This operation trims or extends each polyline specified in the input array, using the user-specified 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.
You can provide arguments to the trim
operation as query parameters defined in the following parameters table.
Request parameters
Parameter | Details |
---|---|
| Specifies an array of polylines to be trimmed or extended. The spatial reference of the polylines is specified by Syntax
Example:
|
| Specifies a polyline that is used as a guide for trimming or extending input Syntax
Example
|
| Specifies the well-known ID of the spatial reference or a spatial reference JSON object for the input |
| Sets a flag that is used along with the
|
| The response format. The default format is Values: |
Example usage
The following is a sample request URL for trim
that demonstrates how two input polyline segments can be trimmed or extended:
https://sampleserver6.arcgisonline.com/arcgis/rest/services/Utilities/Geometry/GeometryServer/trimExtend?sr=2229&polylines=[{"paths":[[[6805512,1843725],[6805496,1844963]]]},{"paths":[[[6805532,1842246],[6805523,1842901]]]}]&trimExtendTo={"paths":[[[6804206,1843554],[6805395,1843570],[6805514,1843607],[6805740,1843619]]]}&extendHow=1&f=html
JSON Response syntax
{
"geometryType": "<esriGeometryPolyline>",
"geometries": [<geometry1>, <geometry2>, ..., <polylineN>]
}
JSON Response example
{
"geometryType": "esriGeometryPolyline",
"geometries": [
{
"paths": [
[
[
6805513.5270143142,
1843606.8529860612
],
[
6805496.0001066327,
1844962.9999830574
]
]
]
},
{
"paths": [
[
[
6805532.0000346303,
1842245.9998396486
],
[
6805513.3022866584,
1843606.7831129492
]
]
]
}
]
}