Polyline Class

Detailed Description

Polyline geometries represent the shape and location of linear features, such as a street in a road network, a contour line representing an elevation value, or a hiking trail. A polyline can be used to define geometry for features and graphics, or as input or output for tasks or geoprocessing operations, such as the output of a network trace.

A polyline can be used as the geometry of a Feature or Graphic. To obtain the geometry on these objects, use GeoElement::geometry.

A polyline is composed of a series of connected segments, where each Segment defines a continuous line between a start and an end point. You can define a new polyline from a collection of Point objects to create a series of straight LineSegment objects connecting the points you specified. You can use PolylineBuilder to build a polyline one point at a time, or to modify an existing polyline.

A polyline can have multiple parts. Each part is a series of connected segments, but the parts can be disjoint, for example, a polyline representing a street that ends, and starts again a block later. Parts can also intersect at one or more points (or vertices), for example, a polyline representing a river and its tributaries.

Polylines inherit from Multipart, which provides members for iterating the segments and points of each part in a polyline.

Polylines are based upon the parent Geometry class which is immutable, meaning you can not change its shape once it is created. If you need to modify a polyline once it has been created, use the PolylineBuilder class.

Relevant samples:

• Create and save KML file: Construct a KML document and save it as a KMZ file.
• Create geometries: Create simple geometry types.
• Cut geometry: Cut a geometry along a polyline.
• Densify and generalize: A multipart geometry can be densified by adding interpolated points at regular intervals.
• Geodesic operations: Calculate a geodesic path between two points and measure its distance.
• Spatial relationships: Determine spatial relationships between two geometries.