Revision 805 org.gvsig.proj/branches/refactor2018/org.gvsig.proj/org.gvsig.proj.catalog/org.gvsig.proj.catalog.api/src/main/java/org/gvsig/proj/catalogue/CRSDefinition.java

View differences:

CRSDefinition.java
26 26
import java.util.List;
27 27
import java.util.Set;
28 28

  
29
import javax.measure.Unit;
30
import javax.measure.quantity.Length;
31

  
29 32
import org.gvsig.proj.catalogue.datum.Datum;
30 33
import org.gvsig.proj.catalogue.ref.Extent;
31 34

  
......
59 62
     * Gets a code that references an unambiguous definition of the coordinate reference
60 63
     * system for some authority. Examples: "EPSG:4326", "EPSG:25830".
61 64
     * 
65
     * Note that identifiers in the "USER:" namespace are an special case, as their
66
     * definition will be different for each user, so they don't reference an
67
     * unambiguous definition.
68
     * 
62 69
     * @return the identifier which was used to instantiate the object, or the
63 70
     * identifier that more closely matches the information used to instantiate
64 71
     * the object (e.g. if derived from an WKT definition)
......
72 79
     * @return the list of object identifiers, or an empty collection if there is none.
73 80
     */
74 81
    Set<String> getIdentifiers();
82
    
83
    /**
84
     * Gets the authority which defines this coordinate references system
85
     * (e.g. "EPSG", "ESRI", "USER"...).
86
     * 
87
     * If the CRS is defined by several
88
     * authorities, it returns the authority which was used to instantiate
89
     * the object, or the authority that more closely matches the information
90
     * used to instantiate the object (e.g. if derived from an WKT definition)
91
     * 
92
     * @return The authority name
93
     */
94
    String getAuthorityName();
75 95
	
76 96
    /**
77 97
     * FIXME: GeoAPI
......
216 236
     * The provided points are considered to be 2D points
217 237
     * (additional dimensions are ignored).
218 238
     * 
219
     * @return The distance between point1 and point2 in the same units as the
220
     * ellipsoid axis (for geodetic CRSs) or in the same units as defined by the
221
     * first axis dimension (for non-geodetic CRSs).
239
     * @param point1
240
     * @param point2
241
     * @param the unit in which the distance should be measure
242
     * 
243
     * @return The distance between point1 and point2 measured in the units
244
     * provided by the unit parameter.
222 245
     */
223
    double getDistance(double[] point1, double[] point2);
246
    double getDistance(double[] point1, double[] point2, Unit<Length> unit);
224 247

  
225 248
    /**
226 249
     * Calculates the distance between 2 points on the surface of the Earth.
......
240 263
     * The provided points are considered to be 2D points
241 264
     * (additional dimensions are ignored).
242 265
     * 
243
     * @return The distance between point1 and point2 in the same units as the
244
     * ellipsoid axis (for geodetic CRSs) or in the same units as defined by the
245
     * first axis dimension (for non-geodetic CRSs).
266
     * @param point1
267
     * @param point2
268
     * @param the unit in which the distance should be measure
269
     * 
270
     * @return The distance between point1 and point2 measured in the units
271
     * provided by the unit parameter.
246 272
     */
247
    double getDistance(double[] point1, double[] point2, boolean useBaseCRS);
273
    double getDistance(double[] point1, double[] point2, boolean useBaseCRS, Unit<Length> unit);
248 274
}

Also available in: Unified diff