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

Visual Basic (Declaration)
C#

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

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

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 = 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 Home, Pro, Enterprise (64 bit)

ArcGIS Pro version: 3.0 or higher.

Reference

GeometryEngine Class
GeometryEngine Members

Send feedback