GetPointsAtM Method (GeometryEngine)

In This Topic

Gets a multipoint corresponding to the locations along the multipart where the specified M-value occurs. Coordinates/measures are interpolated when appropriate.

Syntax

C#
Visual Basic (Declaration)

public Multipoint GetPointsAtM( 
   Multipart multipart,
   double mValue,
   double offset
)

Public Function GetPointsAtM( _
   ByVal multipart As Multipart, _
   ByVal mValue As Double, _
   ByVal offset As Double _
) As Multipoint

Parameters

multipart: The multipart from which the locations will be extracted.
mValue: The M-value to locate.
offset: The lateral offset of the output points.

Return Value

Multipoint representing the locations found. If the input multipart is empty, an empty multipoint is returned.

Exceptions

Exception	Description
System.ArgumentNullException	Multipart is null or empty.
System.InvalidOperationException	This geometry is not M-Aware.
System.NotImplementedException	Spatial reference of multipartis an image coordinate system.

Example

Get a multipoint corresponding to the locations where the specified M values occur along the geometry - GetPointsAtM

string json = "{\"hasM\":true,\"paths\":[[[-3000,-2000,10],[-2000,-2000,15],[-1000,-2000,20],[0,-2000,0],[1000,-2000,20],[2000,-2000,30],[3000,-2000,10],[4000,-2000,5]]],\"spatialReference\":{\"wkid\":3857}}";
Polyline polyline = PolylineBuilderEx.FromJson(json);

Multipoint multipoint = GeometryEngine.Instance.GetPointsAtM(polyline, 10, 500);
// multiPoint.PointCount = 4
// multipoint.Points[0]  X= -3000, Y= -2500  M= 10
// multipoint.Points[1]  X= -500, Y= -2500  M= 10
// multipoint.Points[2]  X= 500, Y= -2500  M= 10
// multipoint.Points[3]  X= 3000, Y= -2500  M= 10

Requirements

Target Platforms: Windows 11, Windows 10

ArcGIS Pro version: 3 or higher.

Reference

GeometryEngine Class
GeometryEngine Members

Send feedback