Application: gvSIG desktop » gvSIG projections

    /**

     * Calculates the distance between 2 points on the surface of the Earth.

     * 

     * The distances are calculated based on the characteristics of CRSDefinition,

     * using geodetic distances when possible. Geodetic distances offer highly

     * accurate measurements and are based on the exact shape of the ellipsoid.

     * 

     * If this CRSDefinition is projected, then the geodetic calculations are done

     * using its base (geographic) CRS. If this CRSDefinition is not geodetic nor

     * projected, then Euclidean distances are calculated.

     * 

     * The provided points are considered to be 2D points

     * (additional dimensions are ignored).

     * 

     * @param point1

     * @param point2

     * @param the unit in which the distance should be measure

     * 

     * @return The distance between point1 and point2 measured in the units

     * provided by the unit parameter.

     */

    double getDistance(double[] point1, double[] point2, Unit<Length> unit);

    /**

     * Calculates the distance between 2 points on the surface of the Earth.

     *  

     * If this CRS is projected and useBaseCRS is <code>false</code>, then

     * the Euclidean distance is calculated. If the CRS is projected and

     * <code>useBaseCRS</code> is <code>true<code>, then the

     * geodetic distance is calculated, using its base (geographic) CRS.

     * 

     * If the CRS is geodetic, then the geodetic distance is calculated.

     * If the CRS is not projected nor geometric, then the Euclidean distance

     * is calculated.

     * 

     * Geodetic distances offer highly accurate measurements and are based on

     * the exact shape of the ellipsoid.

     * 

     * The provided points are considered to be 2D points

     * (additional dimensions are ignored).

     * 

     * @param point1

     * @param point2

     * @param the unit in which the distance should be measure

     * 

     * @return The distance between point1 and point2 measured in the units

     * provided by the unit parameter.

     */

    double getDistance(double[] point1, double[] point2, boolean useBaseCRS, Unit<Length> unit);