Update samples to use GeometryEngine static extension methods (#1178)

Author: williambohrmann3

src/MAUI/Maui.Samples/Samples/Analysis/LineOfSightGeoElement/LineOfSightGeoElement.xaml.cs

@@ -176,7 +176,7 @@ private void AnimationTimer_Elapsed(object sender, EventArgs e)
             _taxiGraphic.Geometry = intermediatePoint;
 
             // Update the taxi rotation.
-            GeodeticDistanceResult distance = GeometryEngine.DistanceGeodetic(starting, ending, LinearUnits.Meters, AngularUnits.Degrees, GeodeticCurveType.Geodesic);
+            GeodeticDistanceResult distance = starting.DistanceGeodetic(ending, LinearUnits.Meters, AngularUnits.Degrees, GeodeticCurveType.Geodesic);
             ((ModelSceneSymbol)_taxiGraphic.Symbol).Heading = distance.Azimuth1;
         }
 

src/MAUI/Maui.Samples/Samples/Analysis/ViewshedGeoElement/ViewshedGeoElement.xaml.cs

@@ -149,8 +149,8 @@ private void AnimateTank()
 
             // Get current location and distance from the destination.
             MapPoint location = (MapPoint)_tank.Geometry;
-            GeodeticDistanceResult distance = GeometryEngine.DistanceGeodetic(
-                location, _tankEndPoint, _metersUnit, _degreesUnit, GeodeticCurveType.Geodesic);
+            GeodeticDistanceResult distance = location.DistanceGeodetic(_tankEndPoint, _metersUnit, _degreesUnit, 
+                GeodeticCurveType.Geodesic);
 
             // Move the tank a short distance.
             location = GeometryEngine.MoveGeodetic(new List<MapPoint>() { location }, 1.0, _metersUnit, distance.Azimuth1, _degreesUnit,

src/MAUI/Maui.Samples/Samples/Data/AddFeatures/AddFeatures.xaml.cs

@@ -74,7 +74,7 @@ private async void MapView_Tapped(object sender, Esri.ArcGISRuntime.Maui.GeoView
                 ArcGISFeature feature = (ArcGISFeature)_damageFeatureTable.CreateFeature();
 
                 // Get the normalized geometry for the tapped location and use it as the feature's geometry.
-                MapPoint tappedPoint = (MapPoint)GeometryEngine.NormalizeCentralMeridian(e.Location);
+                MapPoint tappedPoint = (MapPoint)e.Location.NormalizeCentralMeridian();
                 feature.Geometry = tappedPoint;
 
                 // Set feature attributes.

src/MAUI/Maui.Samples/Samples/Data/AddFeaturesWithContingentValues/AddFeaturesWithContingentValues.xaml.cs

@@ -129,7 +129,7 @@ private async Task QueryAndBufferFeatures()
                 foreach (Feature feature in results.ToList())
                 {
                     double bufferDistance = Convert.ToDouble(feature.GetAttributeValue("BufferSize"));
-                    Geometry buffer = GeometryEngine.Buffer(feature.Geometry, bufferDistance);
+                    Geometry buffer = feature.Geometry.Buffer(bufferDistance);
                     MyMapView.GraphicsOverlays[0].Graphics.Add(new Graphic(buffer));
                 }
             }
@@ -147,7 +147,7 @@ private async Task CreateNewEmptyFeature(Esri.ArcGISRuntime.Maui.GeoViewInputEve
                 _newFeature = (ArcGISFeature)_geodatabaseFeatureTable.CreateFeature();
 
                 // Get the normalized geometry for the tapped location and use it as the feature's geometry.
-                MapPoint tappedPoint = (MapPoint)GeometryEngine.NormalizeCentralMeridian(e.Location);
+                MapPoint tappedPoint = (MapPoint)e.Location.NormalizeCentralMeridian();
                 _newFeature.Geometry = tappedPoint;
 
                 // Add the feature to the table.

src/MAUI/Maui.Samples/Samples/Data/EditFeatureLinkedAnnotation/EditFeatureLinkedAnnotation.xaml.cs

@@ -72,7 +72,7 @@ private void MyMapView_GeoViewTapped(object sender, Esri.ArcGISRuntime.Maui.GeoV
             else
             {
                 // Project the user selected point.
-                MapPoint projPoint = GeometryEngine.Project(e.Location, _selectedFeature.Geometry.SpatialReference) as MapPoint;
+                MapPoint projPoint = e.Location.Project(_selectedFeature.Geometry.SpatialReference) as MapPoint;
 
                 // Update the geometry of the selected feature.
                 _ = UpdateGeometry(projPoint);
@@ -122,7 +122,7 @@ private async Task UpdateGeometry(MapPoint point)
             if (_selectedFeature.Geometry is Polyline line)
             {
                 // Get the nearest point on the selected line.
-                ProximityResult nearestVertex = GeometryEngine.NearestVertex(line, point);
+                ProximityResult nearestVertex = line.NearestVertex(point);
 
                 // Create a new polyline.
                 PolylineBuilder polylineBuilder = new PolylineBuilder(line);
@@ -132,7 +132,7 @@ private async Task UpdateGeometry(MapPoint point)
                 part.SetPoint(nearestVertex.PointIndex, point);
 
                 // Update the geometry of the feature.
-                _selectedFeature.Geometry = GeometryEngine.Project(polylineBuilder.ToGeometry(), _selectedFeature.Geometry.SpatialReference);
+                _selectedFeature.Geometry = polylineBuilder.ToGeometry().Project(_selectedFeature.Geometry.SpatialReference);
                 await _selectedFeature.FeatureTable.UpdateFeatureAsync(_selectedFeature);
             }
             else if (_selectedFeature.Geometry is MapPoint)

src/MAUI/Maui.Samples/Samples/Data/UpdateGeometries/UpdateGeometries.xaml.cs

@@ -92,7 +92,7 @@ private async void MoveSelectedFeature(Esri.ArcGISRuntime.Maui.GeoViewInputEvent
                 MapPoint destinationPoint = tapEventDetails.Location;
 
                 // Normalize the point - needed when the tapped location is over the international date line.
-                destinationPoint = (MapPoint)GeometryEngine.NormalizeCentralMeridian(destinationPoint);
+                destinationPoint = (MapPoint)destinationPoint.NormalizeCentralMeridian();
 
                 // Load the feature.
                 await _selectedFeature.LoadAsync();

src/MAUI/Maui.Samples/Samples/Geometry/Buffer/Buffer.xaml.cs

@@ -95,11 +95,11 @@ private async void MyMapView_GeoViewTapped(object sender, Esri.ArcGISRuntime.Mau
                 double bufferInMeters = LinearUnits.Miles.ToMeters(bufferInMiles);
 
                 // Create a planar buffer graphic around the input location at the specified distance.
-                Geometry bufferGeometryPlanar = GeometryEngine.Buffer(userTapPoint, bufferInMeters);
+                Geometry bufferGeometryPlanar = userTapPoint.Buffer(bufferInMeters);
                 Graphic planarBufferGraphic = new Graphic(bufferGeometryPlanar);
 
                 // Create a geodesic buffer graphic using the same location and distance.
-                Geometry bufferGeometryGeodesic = GeometryEngine.BufferGeodetic(userTapPoint, bufferInMeters, LinearUnits.Meters, double.NaN, GeodeticCurveType.Geodesic);
+                Geometry bufferGeometryGeodesic = userTapPoint.BufferGeodetic(bufferInMeters, LinearUnits.Meters, double.NaN, GeodeticCurveType.Geodesic);
                 Graphic geodesicBufferGraphic = new Graphic(bufferGeometryGeodesic);
 
                 // Create a graphic for the user tap location.

src/MAUI/Maui.Samples/Samples/Geometry/Buffer/readme.md

@@ -18,8 +18,8 @@ Creating buffers is a core concept in GIS proximity analysis that allows you to
 ## How it works
 
 1. The `MapPoint` for a tap on the display is captured.
-2. The static method `GeometryEngine.Buffer` is called to create a planar buffer polygon from the map location and distance.
-3. Another static method, `GeometryEngine.BufferGeodetic` is called to create a geodesic buffer polygon using the same inputs.
+2. The static extension method `GeometryEngine.Buffer` is called to create a planar buffer polygon from the map location and distance.
+3. Another static extension method, `GeometryEngine.BufferGeodetic` is called to create a geodesic buffer polygon using the same inputs.
 4. The polygon results (and tap location) are displayed in the map view with different symbols in order to highlight the difference between the buffer techniques due to the spatial reference used in the planar calculation.
 
 ## Relevant API

src/MAUI/Maui.Samples/Samples/Geometry/BufferList/BufferList.xaml.cs

@@ -56,7 +56,7 @@ private void Initialize()
                 new MapPoint(-94.00, 31.720, SpatialReferences.Wgs84)
             };
             _spatialReferenceArea = new Polygon(spatialReferenceExtentCoords);
-            _spatialReferenceArea = GeometryEngine.Project(_spatialReferenceArea, statePlaneNorthCentralTexas) as Polygon;
+            _spatialReferenceArea = _spatialReferenceArea.Project(statePlaneNorthCentralTexas) as Polygon;
 
             // Create a map that uses the North Central Texas state plane spatial reference.
             Map bufferMap = new Map(statePlaneNorthCentralTexas);
@@ -108,7 +108,7 @@ private void MyMapView_GeoViewTapped(object sender, GeoViewInputEventArgs e)
                 MapPoint tapMapPoint = e.Location;
 
                 // Check if the point coordinates are within the spatial reference envelope.
-                bool withinValidExent = GeometryEngine.Contains(_spatialReferenceArea, tapMapPoint);
+                bool withinValidExent = _spatialReferenceArea.Contains(tapMapPoint);
 
                 // If the input point is not within the valid extent for the spatial reference, warn the user and return.
                 if (!withinValidExent)

src/MAUI/Maui.Samples/Samples/Geometry/BufferList/readme.md

@@ -14,7 +14,7 @@ Click/tap on the map to add points. Tap the "Create Buffer(s)" button to draw bu
 
 ## How it works
 
-1. Use `GeometryEngine.Buffer(points, distances, union)` to create a `Polygon`. The parameter `points` are the points to buffer around, `distances` are the buffer distances for each point (in meters) and `union` is a boolean for whether the results should be unioned.
+1. Use `points.Buffer(distances, union)` to create a `Polygon`. The parameter `points` are the points to buffer around, `distances` are the buffer distances for each point (in meters) and `union` is a boolean for whether the results should be unioned.
 2. Add the resulting polygons (if not unioned) or single polygon (if unioned) to the map's `GraphicsOverlay` as a `Graphic`.
 
 ## Relevant API

src/MAUI/Maui.Samples/Samples/Geometry/ClipGeometry/ClipGeometry.xaml.cs

@@ -151,7 +151,7 @@ private void ClipGraphics()
                 // Perform the clip operation. The first parameter of the clip operation will always be the Colorado graphic.
                 // The second parameter of the clip operation will be one of the 3 different clip geometries (_outsideGraphic,
                 // _containedGraphic, or _intersectingGraphic).
-                Geometry myGeometry = GeometryEngine.Clip(_coloradoGraphic.Geometry, (Envelope)graphic.Geometry);
+                Geometry myGeometry = _coloradoGraphic.Geometry.Clip((Envelope)graphic.Geometry);
 
                 // Only work on returned geometries that are not null.
                 if (myGeometry != null)

src/MAUI/Maui.Samples/Samples/Geometry/ClipGeometry/readme.md

@@ -14,7 +14,7 @@ Tap the "Clip" button to clip the blue graphic with the red dashed envelopes.
 
 ## How it works
 
-1. Use the static method `GeometryEngine.Clip()` to generate a clipped `Geometry`, passing in an existing `Geometry` and an `Envelope` as parameters.  The existing geometry will be clipped where it intersects an envelope.
+1. Use the static extension method `GeometryEngine.Clip()` to generate a clipped `Geometry`, passing in an existing `Geometry` and an `Envelope` as parameters.  The existing geometry will be clipped where it intersects an envelope.
 2. Create a new `Graphic` from the clipped geometry and add it to a `GraphicsOverlay` on the `MapView`.
 
 ## Relevant API

src/MAUI/Maui.Samples/Samples/Geometry/ConvexHull/ConvexHull.xaml.cs

@@ -64,7 +64,7 @@ private void MyMapView_GeoViewTapped(object sender, GeoViewInputEventArgs e)
             try
             {
                 // Normalize the tapped point.
-                var centralizedPoint = (MapPoint)GeometryEngine.NormalizeCentralMeridian(e.Location);
+                var centralizedPoint = (MapPoint)e.Location.NormalizeCentralMeridian();
 
                 // Add the map point to the list that will be used by the GeometryEngine.ConvexHull operation.
                 _inputPointCollection.Add(centralizedPoint);
@@ -104,7 +104,7 @@ private void ConvexHullButton_Clicked(object sender, EventArgs e)
                 Multipoint inputMultipoint = new Multipoint(_inputPointCollection);
 
                 // Get the returned result from the convex hull operation.
-                Geometry convexHullGeometry = GeometryEngine.ConvexHull(inputMultipoint);
+                Geometry convexHullGeometry = inputMultipoint.ConvexHull();
 
                 // Create a simple line symbol for the outline of the convex hull graphic(s).
                 SimpleLineSymbol convexHullSimpleLineSymbol = new SimpleLineSymbol(SimpleLineSymbolStyle.Solid, Color.Blue, 4);

src/MAUI/Maui.Samples/Samples/Geometry/ConvexHull/readme.md

@@ -15,7 +15,7 @@ Tap on the map to add points. Tap the "Create Convex Hull" button to generate th
 ## How it works
 
 1. Create an input geometry such as a `Multipoint` object.
-2. Use `GeometryEngine.ConvexHull(inputGeometry)` to create a new `Geometry` object representing the convex hull of the input points. The returned geometry will either be a `Point`, `Polyline`, or `Polygon` based on the number of input points.
+2. Use `inputGeometry.ConvexHull()` to create a new `Geometry` object representing the convex hull of the input points. The returned geometry will either be a `Point`, `Polyline`, or `Polygon` based on the number of input points.
 
 ## Relevant API
 

src/MAUI/Maui.Samples/Samples/Geometry/ConvexHullList/readme.md

@@ -16,7 +16,7 @@ Tap the 'Create Convex Hull' button to create convex hull(s) from the polygon gr
 
 1. Create an `Map` and display it in a `MapView`.
 2. Create two input polygon graphics and add them to a `GraphicsOverlay`.
-3. Call `GeometryEngine.ConvexHull(inputGeometries, boolean)`, specifying a list of geometries for which to generate the convex hull. Set the boolean parameter to `true` to generate a convex hull for the union of the geometries. Set it to `false` to create a convex hull for each individual geometry.
+3. Call `inputGeometries.ConvexHull(boolean)`, specifying a list of geometries for which to generate the convex hull. Set the boolean parameter to `true` to generate a convex hull for the union of the geometries. Set it to `false` to create a convex hull for each individual geometry.
 4. Loop through the returned geometries and add them as graphics for display on the map.
 
 ## Relevant API

src/MAUI/Maui.Samples/Samples/Geometry/CutGeometry/CutGeometry.xaml.cs

@@ -98,7 +98,7 @@ private void CutButton_Clicked(object sender, EventArgs e)
         private void Cut()
         {
             // Cut the polygon geometry with the polyline, expect two geometries.
-            Geometry[] cutGeometries = GeometryEngine.Cut(_lakeSuperiorPolygonGraphic.Geometry, (Polyline)_countryBorderPolylineGraphic.Geometry);
+            Geometry[] cutGeometries = _lakeSuperiorPolygonGraphic.Geometry.Cut((Polyline)_countryBorderPolylineGraphic.Geometry);
 
             // Create a simple line symbol for the outline of the Canada side of Lake Superior.
             SimpleLineSymbol canadaSideSimpleLineSymbol = new SimpleLineSymbol(SimpleLineSymbolStyle.Null, System.Drawing.Color.Blue, 0);

src/MAUI/Maui.Samples/Samples/Geometry/CutGeometry/readme.md

@@ -14,7 +14,7 @@ Tap the "Cut" button to cut the polygon with the polyline and see the resulting
 
 ## How it works
 
-1. Pass the geometry and polyline to `GeometryEngine.Cut` to cut the geometry along the polyline.
+1. Pass the polyline to the static extension method `GeometryEngine.Cut()` to cut the geometry along the polyline.
 2. Loop through the returned list of part geometries. Some of these geometries may be multi-part.
 
 ## Relevant API

src/MAUI/Maui.Samples/Samples/Geometry/DensifyAndGeneralize/DensifyAndGeneralize.xaml.cs

@@ -95,7 +95,7 @@ private void UpdateGeometry(string operation, double segmentLength, double devia
                 // Reset the other slider.
                 SegmentLengthSlider.Value = 100;
 
-                polyline = (Polyline)GeometryEngine.Generalize(polyline, deviation, true);
+                polyline = (Polyline)polyline.Generalize(deviation, true);
 
                 // Update the result label.
                 ResultLabel.Text = $"Generalize- deviation: {deviation:f}";
@@ -105,7 +105,7 @@ private void UpdateGeometry(string operation, double segmentLength, double devia
                 // Reset the other slider.
                 DeviationSlider.Value = 1;
 
-                polyline = (Polyline)GeometryEngine.Densify(polyline, segmentLength);
+                polyline = (Polyline)polyline.Densify(segmentLength);
 
                 // Update the result label.
                 ResultLabel.Text = $"Densify- segment length: {segmentLength:f}";

src/MAUI/Maui.Samples/Samples/Geometry/DensifyAndGeneralize/readme.md

@@ -16,8 +16,8 @@ Use the sliders to control the parameters of the densify and generalize methods.
 
 ## How it works
 
-1. Use the static method `GeometryEngine.Densify(polyline, maxSegmentLength)` to densify the polyline object. The resulting polyline object will have more points along the line, so that there are no points greater than `maxSegmentLength` from the next point.
-2. Use the static method `GeometryEngine.Generalize(polyline, maxDeviation, true)` to generalize the polyline object. The resulting polyline object will have points shifted from the original line to simplify the shape. None of these points can deviate farther from the original line than `maxDeviation`. The last parameter, `removeDegenerateParts`, will clean up extraneous parts of a multipart geometry. This will have no effect in this sample as the polyline does not contain extraneous parts.
+1. Use the static extension method `polyline.Densify(maxSegmentLength)` to densify the polyline object. The resulting polyline object will have more points along the line, so that there are no points greater than `maxSegmentLength` from the next point.
+2. Use the static extension method `polyline.Generalize(maxDeviation, true)` to generalize the polyline object. The resulting polyline object will have points shifted from the original line to simplify the shape. None of these points can deviate farther from the original line than `maxDeviation`. The last parameter, `removeDegenerateParts`, will clean up extraneous parts of a multipart geometry. This will have no effect in this sample as the polyline does not contain extraneous parts.
 3. Note that `maxSegmentLength` and `maxDeviation` are in the units of the geometry's coordinate system. In this example, a cartesian coordinate system is used and at a small enough scale that geodesic distances are not required.
 
 ## Relevant API

src/MAUI/Maui.Samples/Samples/Geometry/GeodesicOperations/GeodesicOperations.xaml.cs

@@ -75,7 +75,7 @@ private void Initialize()
         private void MyMapViewOnGeoViewTapped(object sender, Esri.ArcGISRuntime.Maui.GeoViewInputEventArgs geoViewInputEventArgs)
         {
             // Get the tapped point, projected to WGS84.
-            MapPoint destination = (MapPoint)GeometryEngine.Project(geoViewInputEventArgs.Location, SpatialReferences.Wgs84);
+            MapPoint destination = (MapPoint)geoViewInputEventArgs.Location.Project(SpatialReferences.Wgs84);
 
             // Update the destination graphic.
             _endLocationGraphic.Geometry = destination;
@@ -91,13 +91,13 @@ private void MyMapViewOnGeoViewTapped(object sender, Esri.ArcGISRuntime.Maui.Geo
             Polyline routeLine = new Polyline(polylinePoints);
 
             // Densify the polyline to show the geodesic curve.
-            Geometry pathGeometry = GeometryEngine.DensifyGeodetic(routeLine, 1, LinearUnits.Kilometers, GeodeticCurveType.Geodesic);
+            Geometry pathGeometry = routeLine.DensifyGeodetic(1, LinearUnits.Kilometers, GeodeticCurveType.Geodesic);
 
             // Apply the curved line to the path graphic.
             _pathGraphic.Geometry = pathGeometry;
 
             // Calculate and show the distance.
-            double distance = GeometryEngine.LengthGeodetic(pathGeometry, LinearUnits.Kilometers, GeodeticCurveType.Geodesic);
+            double distance = pathGeometry.LengthGeodetic(LinearUnits.Kilometers, GeodeticCurveType.Geodesic);
             ResultsLabel.Text = $"{(int)distance} kilometers";
         }
     }

src/MAUI/Maui.Samples/Samples/Geometry/GeodesicOperations/readme.md

@@ -17,8 +17,8 @@ Tap anywhere on the map. A line graphic will display the geodesic line between t
 1. A `Point` is created in New York City and displayed as a `Graphic`.
 2. When a tap occurs on the `MapView`, a new `Point` is obtained from the mouse click. This `Point` is added as a `Graphic`.
 3. A `Polyline` is created with the two `Point` objects.
-4. `GeometryEngine.DensifyGeodetic` is executed by passing in the `Polyline` object, and the returned `Geometry` is added as a `Graphic`.
-5. `GeometryEngine.LengthGeodetic` is executed by passing in the two `Point` objects, and the returned number is displayed on the screen.
+4. `GeometryEngine.DensifyGeodetic` is called from the `Polyline` object, and the returned `Geometry` is stored as `pathGeometry`.
+5. `GeometryEngine.LengthGeodetic` is called from `pathGeometry`, and the returned number is displayed on the screen.
 
 ## Relevant API