ArcGIS Pro 3.8 API Reference Guide
ArcGIS.Core.Geometry Namespace / LinearUnit Class / Miles Property
Example

In This Topic
    Miles Property
    In This Topic
    Gets a linear unit representing miles (Factory code = 9093).
    Syntax
    public static LinearUnit Miles {get;}
    Public Shared ReadOnly Property Miles As LinearUnit
    Example
    Create a buffer polygon at the specified geodesic distance
    {
        // buffer a point
        MapPoint pt = MapPointBuilderEx.CreateMapPoint(1.0, 1.0, SpatialReferences.WGS84);
        Polygon outPolygon = GeometryEngine.Instance.GeodesicBuffer(pt, 5) as Polygon;
    
        double delta = SpatialReferences.WGS84.XYTolerance * 2 * Math.Sqrt(2);
        ReadOnlyPointCollection points = outPolygon.Points;
        foreach (MapPoint p in points)
        {
          double d = GeometryEngine.Instance.GeodesicDistance(pt, p);
          // d = 5 (+- delta)
        }
    
        // specify a unit for the distance
        outPolygon = GeometryEngine.Instance.GeodesicBuffer(pt, 5000, LinearUnit.Millimeters) as Polygon;
    
        // buffer of 0 distance produces an empty geometry
        Geometry g = GeometryEngine.Instance.GeodesicBuffer(pt, 0);
        // g.IsEmpty = true
    
        // buffer many points
        List<MapPoint> list =
        [
          MapPointBuilderEx.CreateMapPoint(1.0, 1.0, SpatialReferences.WGS84),
      MapPointBuilderEx.CreateMapPoint(10.0, 20.0),
      MapPointBuilderEx.CreateMapPoint(40.0, 40.0),
      MapPointBuilderEx.CreateMapPoint(60.0, 60.0),
    ];
    
        outPolygon = GeometryEngine.Instance.GeodesicBuffer(list, 10000) as Polygon;
        // outPolygon.PartCount = 4
    
        // buffer different geometry types
        List<Coordinate2D> coords =
        [
          new Coordinate2D(1, 2), new Coordinate2D(10, 20), new Coordinate2D(20, 30),
      new Coordinate2D(50, 60), new Coordinate2D(70, 80), new Coordinate2D(80, 40),
      new Coordinate2D(90, 10), new Coordinate2D(110, 15), new Coordinate2D(120, 30),
      new Coordinate2D(10, 40), new Coordinate2D(-10, 40), new Coordinate2D(-10, 50)
        ];
    
        List<Geometry> manyGeometries =
        [
          MapPointBuilderEx.CreateMapPoint(1.0, 1.0, SpatialReferences.WGS84),
      PolylineBuilderEx.CreatePolyline([coords[0], coords[1], coords[2]], SpatialReferences.WGS84),
      PolylineBuilderEx.CreatePolyline([coords[3], coords[4], coords[5]]),
      PolygonBuilderEx.CreatePolygon([coords[9], coords[10], coords[11]])
        ];
    
        outPolygon = GeometryEngine.Instance.GeodesicBuffer(manyGeometries, 20000) as Polygon;
    
        // specify unit types
        outPolygon = GeometryEngine.Instance.GeodesicBuffer(manyGeometries, 20, LinearUnit.Miles) as Polygon;
      }
    Determine geodesic length of a line
    {
      polyline = PolylineBuilderEx.CreatePolyline(
      [
          MapPointBuilderEx.CreateMapPoint(-10018754.1713946, 10018754.1713946),
      MapPointBuilderEx.CreateMapPoint(10018754.1713946, 10018754.1713946)
      ], SpatialReferences.WebMercator);
    
      var length = GeometryEngine.Instance.GeodesicLength(polyline);
      // length is approx 5243784.5551844323 in meters
    
      length = GeometryEngine.Instance.GeodesicLength(polyline, LinearUnit.Miles);
      // length is approx 3258.33666089067 in miles
    
      var polyline2 = GeometryEngine.Instance.Project(polyline, SpatialReferences.WGS84);
      length = GeometryEngine.Instance.GeodesicLength(polyline2);
      // length is approx 5243784.55518443 in meters after projecting
    }
    Calculate geodetic distance, azimuth between two points
    {
      SpatialReference sr = SpatialReferences.WGS84;
    
      MapPoint p1 = MapPointBuilderEx.CreateMapPoint(111, 55, sr);
      MapPoint p2 = MapPointBuilderEx.CreateMapPoint(95.5845, 64.2285, sr);
    
      double distance;
    
      distance = GeometryEngine.Instance.GeodeticDistanceAndAzimuth(p1, p2, GeodeticCurveType.Geodesic, out double az12, out double az21);
      // distance - 1339728.0303777338
      // az12 - 326.235780421405
      // az21 - 132.87425637913955
    
      distance = GeometryEngine.Instance.GeodeticDistanceAndAzimuth(p1, p2, GeodeticCurveType.Loxodrome, out az12, out az21);
      // distance - 1342745.9687172563
      // az12 - 319.966400332104
      // az21- 139.96640033210397
    
      distance = GeometryEngine.Instance.GeodeticDistanceAndAzimuth(p1, p2, GeodeticCurveType.GreatElliptic, out az12, out az21);
      // distance - 1339728.038837946
      // az12 - 326.22479262335418
      // az21 - 132.88558894347742
    
      MapPoint p3 = MapPointBuilderEx.CreateMapPoint(0, 0, sr);
      MapPoint p4 = MapPointBuilderEx.CreateMapPoint(1, 0, sr);
    
      distance = GeometryEngine.Instance.GeodeticDistanceAndAzimuth(p3, p4, GeodeticCurveType.Geodesic, out az12, out az21);
      // distance - 111319.49079327342
      // az12 - 90
      // az21 - 270
    
      distance = GeometryEngine.Instance.GeodeticDistanceAndAzimuth(p3, p4, GeodeticCurveType.Geodesic, LinearUnit.Miles, out az12, out az21);
      // distance - 69.1707247134693
      // az12 - 90
      // az21 - 270
    }
    Perform Geodetic Move on a set of MapPoints
    {
      SpatialReference sr = SpatialReferences.WebMercator;
      var points = new[] { MapPointBuilderEx.CreateMapPoint(0, 0, sr) };
      double distance = 10;
      double azimuth = Math.PI / 2;
      var resultPoints = GeometryEngine.Instance.GeodeticMove(points, sr, distance, LinearUnit.Meters, azimuth, GeodeticCurveType.Geodesic);
    
      // resultPoints.First().X = 10
      // resultPoints.First().Y = 0
      // resultPoints.First().SpatialReference.Wkid = sr.Wkid
    
      // Change LinearUnit to Miles
      resultPoints = GeometryEngine.Instance.GeodeticMove(points, sr, distance, LinearUnit.Miles, azimuth, GeodeticCurveType.Geodesic);
      // resultPoints.First().X = 16093.44
      // resultPoints.First().Y = 0
    
      // Change curve type
      resultPoints = GeometryEngine.Instance.GeodeticMove(points, sr, distance, LinearUnit.Miles, azimuth, GeodeticCurveType.Loxodrome);
      // resultPoints.First().X = 16093.44
      // resultPoints.First().Y = 0
    }
    Calculate length of geometry on surface of Earth's ellipsoid - ShapePreservingLength
    {
      // pt
      MapPoint pt = MapPointBuilderEx.CreateMapPoint(1.0, 3.0, SpatialReferences.WebMercator);
      double len = GeometryEngine.Instance.ShapePreservingLength(pt);          // len = 0
    
      List<MapPoint> pts =
      [
        MapPointBuilderEx.CreateMapPoint(1.0, 1.0, 3.0),
      MapPointBuilderEx.CreateMapPoint(1.0, 3.0, 3.0),
      MapPointBuilderEx.CreateMapPoint(3, 3, 3.0),
      MapPointBuilderEx.CreateMapPoint(3.0, 1.0, 3.0),
    ];
    
      // multipoint
      Multipoint mPt = MultipointBuilderEx.CreateMultipoint(pts);
      len = GeometryEngine.Instance.ShapePreservingLength(mPt);                // len = 0
    
      // polyline
      polyline = PolylineBuilderEx.CreatePolyline(pts, SpatialReferences.WGS84);
      len = GeometryEngine.Instance.ShapePreservingLength(polyline);
    
      // polygon
      polygon = PolygonBuilderEx.CreatePolygon(pts, SpatialReferences.WGS84);
      len = GeometryEngine.Instance.ShapePreservingLength(polygon);
    
      polyline = PolylineBuilderEx.CreatePolyline(
      [
        MapPointBuilderEx.CreateMapPoint( -170, 0),
      MapPointBuilderEx.CreateMapPoint( 170, 0)
      ], SpatialReferences.WGS84);
    
    
      var length_meters = GeometryEngine.Instance.ShapePreservingLength(polyline); // , LinearUnits.Meters);
      var length_miles = GeometryEngine.Instance.ShapePreservingLength(polyline, LinearUnit.Miles);
    
      // length_meters - 37848626.869713023
      // length_miles - 23518.046402579574
    }
    Requirements

    Target Platforms: Windows 11 Home, Pro, Enterprise (64 bit)

    ArcGIS Pro version: 3.0 or higher.
    See Also