Statistics
| Revision:

root / org.gvsig.proj / branches / refactor2018 / org.gvsig.proj / org.gvsig.proj.lib / org.gvsig.proj.lib.api / src / main / java / org / gvsig / proj / CoordinateReferenceSystem.java @ 814

History | View | Annotate | Download (2.16 KB)

1
/* gvSIG. Desktop Geographic Information System.
2
 *
3
 * Copyright ? 2007-2012 gvSIG Association
4
 *
5
 * This program is free software; you can redistribute it and/or
6
 * modify it under the terms of the GNU General Public License
7
 * as published by the Free Software Foundation; either version 2
8
 * of the License, or (at your option) any later version.
9
 *
10
 * This program is distributed in the hope that it will be useful,
11
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13
 * GNU General Public License for more details.
14
 *
15
 * You should have received a copy of the GNU General Public License
16
 * along with this program; if not, write to the Free Software
17
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
18
 * MA  02110-1301, USA.
19
 *
20
 * For any additional information, do not hesitate to contact us
21
 * at info AT gvsig.com, or visit our website www.gvsig.com.
22
 */
23
package org.gvsig.proj;
24

    
25
import org.gvsig.proj.catalog.CRSDefinition;
26
import org.gvsig.proj.catalog.exception.CoordinateReferenceSystemNotFoundException;
27
import org.gvsig.tools.lang.Cloneable;
28

    
29
/**
30
 * Coordinate Reference System (CRS). A CRS defines how a set of coordinates relate
31
 * to real positions (on earth, on other planet or in the space). Some CRSs include
32
 * a projection, which defines a mathematical model to approximate the surface of an
33
 * area of the earth using a planar surface.
34
 * 
35
 * Note that a set of coordinates is meaningless if their CRS is not defined, as these
36
 * values can refer to different locations on the Earth depending on the CRS being used.
37
 * 
38
 * @see http://en.wikipedia.org/wiki/Coordinate_reference_system
39
 * @see http://en.wikipedia.org/wiki/Map_projection
40
 * @author gvSIG Team
41
 */
42
public interface CoordinateReferenceSystem extends Cloneable {    
43
    /**
44
     * Gets the definition of the coordinate reference system. The CRSDefinition
45
     * fully defines the CRS
46
     * 
47
     * @return
48
     * @throws UnsupportedOperationException 
49
     * @throws CoordinateReferenceSystemNotFoundException 
50
     */
51
    CRSDefinition getDefinition() throws CoordinateReferenceSystemNotFoundException, UnsupportedOperationException;
52
}