AutoCAD Map 3D 2009 Geospatial Platform Reference

AutoCAD Map 3D Geospatial Platform API

previous page next page
MgCoordinateSystemMeasure
GetAzimuth
GetAzimuth
GetCoordinate
GetCoordinate
GetDistance
GetDistance
GetEnvelope
virtual double MgCoordinateSystemMeasure::GetDistance ( MgCoordinate *  coord1,
MgCoordinate *  coord2 
) [pure virtual]

Computes the distance between two coordinates.

Remarks:
The x and y values in the coordinate arguments are in coordinate system units.
.NET Syntax
virtual double GetDistance(MgCoordinate coord1, MgCoordinate coord2);
Java Syntax
virtual double GetDistance(MgCoordinate coord1, MgCoordinate coord2);
PHP Syntax
virtual double GetDistance(MgCoordinate coord1, MgCoordinate coord2);

Parameters:
coord1 (MgCoordinate) An MgCoordinate object that specifies the first coordinate.
coord2 (MgCoordinate) An MgCoordinate object that specifies the second coordinate.
Returns:
Returns the distance between coord1 and coord2 as a double in meters.
Example (PHP) $coord1 is New York City, and $coord2 is Boston, Massachusetts. $distance is 361777.95418396 meters. 
 $geometryFactory = new MgGeometryFactory();
 $coord1 = $geometryFactory->CreateCoordinateXY(-74.806394, 40.714169);
 $coord2 = $geometryFactory->CreateCoordinateXY(-71.061342, 42.355892);
 $distance = $coordSysMeasure->Getdistance($coord1, $coord2);

Example (C#) 
 using OSGeo.MapGuide;
 private MgCoordinateSystemMeasure geogCSMeasure;
 private MgGeometryFactory geometryFactory;
 private MgCoordinate geogCSXYCoord;
 private MgCoordinate geogCSX1Y1Coord;
 private double geogCSX = -160.101421317;
 private double geogCSY = 22.0234263273;
 private double geogCSX1 = -159.721535121256;
 private double geogCSY1 = 24.0028259520524;
 private double geogCSDistance = 2.0;
 private double distance;
 private double tolerance = 0.001;
 private Boolean isEquivalent;

 geometryFactory = new MgGeometryFactory();
 geogCSXYCoord = geometryFactory.CreateCoordinateXY(geogCSX, geogCSY);
 geogCSX1Y1Coord = geometryFactory.CreateCoordinateXY(geogCSX1, geogCSY1);
 distance = geogCSMeasure.GetDistance(geogCSXYCoord, geogCSX1Y1Coord);
 // distance has the value of geogCSDistance
 isEquivalent = Math.Abs(distance - geogCSDistance) < tolerance;

Exceptions:
MgCoordinateSystemMeasureFailedException 

Implements MgMeasure.
previous page start next page