Class GeodeticAuthorityFactory
- All Implemented Interfaces:
- AuthorityFactory,- Factory
- Direct Known Subclasses:
- CommonAuthorityFactory,- ConcurrentAuthorityFactory,- EPSGDataAccess,- MultiAuthoritiesFactory,- WKTDictionary
"4326".This class defines a default implementation for most methods defined in the DatumAuthorityFactory,
 CSAuthorityFactory and CRSAuthorityFactory interfaces. However, those interfaces do not appear
 in the implements clause of this class declaration. This is up to subclasses to decide which interfaces
 they declare to implement.
The default implementation for all createFoo(String) methods ultimately invokes
 createObject(String), which may be the only method that a subclass need to override.
 However, other methods may be overridden as well for better performances.
- Since:
- 0.7
Defined in the sis-referencing module
- 
Constructor SummaryConstructorsModifierConstructorDescriptionprotectedCreates a new authority factory for geodetic objects.
- 
Method SummaryModifier and TypeMethodDescriptioncreateCartesianCS(String code) Creates a 2- or 3-dimensional Cartesian coordinate system made of straight orthogonal axes.createCompoundCRS(String code) Creates a CRS describing the position of points through two or more independent coordinate reference systems.Creates an operation for transforming coordinates in the source CRS to coordinates in the target CRS.Creates an arbitrary coordinate reference system from a code.Creates an arbitrary coordinate system from a code.Creates a coordinate system axis with name, direction, unit and range of values.createCylindricalCS(String code) Creates a 3-dimensional coordinate system made of a polar coordinate system extended by a straight perpendicular axis.createDatum(String code) Creates an arbitrary datum from a code.createDerivedCRS(String code) Creates a CRS that is defined by its coordinate conversion from another CRS (not by a datum).createEllipsoid(String code) Creates a geometric figure that can be used to describe the approximate shape of the earth.createEllipsoidalCS(String code) Creates a 2- or 3-dimensional coordinate system for geodetic latitude and longitude, sometimes with ellipsoidal height.createEngineeringCRS(String code) Creates a 1-, 2- or 3-dimensional contextually local coordinate reference system.Creates a datum defining the origin of an engineering coordinate reference system.createExtent(String code) Creates information about spatial, vertical, and temporal extent (usually a domain of validity) from a code.createFromCoordinateReferenceSystemCodes(String sourceCRS, String targetCRS) Creates operations from source and target coordinate reference system codes.createGeocentricCRS(String code) Creates a 3-dimensional coordinate reference system with the origin at the approximate centre of mass of the earth.createGeodeticDatum(String code) Creates a datum defining the location and orientation of an ellipsoid that approximates the shape of the earth.createGeographicCRS(String code) Creates a 2- or 3-dimensional coordinate reference system based on an ellipsoidal approximation of the geoid.createImageCRS(String code) Creates a 2-dimensional engineering coordinate reference system applied to locations in images.createImageDatum(String code) Creates a datum defining the origin of an image coordinate reference system.abstract IdentifiedObjectcreateObject(String code) Returns an arbitrary object from a code.Creates a description of the algorithm and parameters used to perform a coordinate operation.Creates a definition of a single parameter used by an operation method.createParametricCRS(String code) Creates a 1-dimensional parametric coordinate reference system.createParametricCS(String code) Creates a 1-dimensional parametric coordinate system.Creates a datum defining the origin of a parametric coordinate reference system.createPolarCS(String code) Creates a 2-dimensional coordinate system for coordinates represented by a distance from the origin and an angle from a fixed direction.createPrimeMeridian(String code) Creates a prime meridian defining the origin from which longitude values are determined.createProjectedCRS(String code) Creates a 2-dimensional coordinate reference system used to approximate the shape of the earth on a planar surface.createSphericalCS(String code) Creates a 3-dimensional coordinate system with one distance measured from the origin and two angular coordinates.createTemporalCRS(String code) Creates a 1-dimensional coordinate reference system used for the recording of time.createTemporalDatum(String code) Creates a datum defining the origin of a temporal coordinate reference system.createTimeCS(String code) Creates a 1-dimensional coordinate system for time elapsed in the specified time units from a specified time origin.Unit<?>createUnit(String code) Creates an unit of measurement from a code.createVerticalCRS(String code) Creates a 1-dimensional coordinate reference system used for recording heights or depths.createVerticalCS(String code) Creates a 1-dimensional coordinate system for heights or depths of points.createVerticalDatum(String code) Creates a datum identifying a particular reference level surface used as a zero-height surface.abstract CitationReturns the database or specification that defines the codes recognized by this factory.Returns all namespaces recognized by this factory.getDescriptionText(String code) Returns a description of the object corresponding to a code.Creates a finder which can be used for looking up unidentified objects.Returns a string representation of this factory for debugging purpose only.protected final StringtrimNamespace(String code) Trims the namespace, if present.Methods inherited from class AbstractFactorygetVendorMethods inherited from class Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, waitMethods inherited from interface AuthorityFactorygetAuthorityCodesMethods inherited from interface FactorygetVendor
- 
Constructor Details- 
GeodeticAuthorityFactoryprotected GeodeticAuthorityFactory()Creates a new authority factory for geodetic objects.
 
- 
- 
Method Details- 
getAuthorityReturns the database or specification that defines the codes recognized by this factory. This method may returnnullif it cannot obtain this information, for example because the connection to a database is not available.Example: a factory that create coordinate reference system objects from EPSG codes could return a citation like below:
 The online resource description with a “Connection” function is a SIS extension.Citation ├─ Title ……………………………………………………… EPSG Geodetic Parameter Dataset ├─ Identifier ………………………………………… EPSG ├─ Online resource (1 of 2) │ ├─ Linkage ………………………………………… https://epsg.org/ │ └─ Function ……………………………………… Browse └─ Online resource (2 of 2) ├─ Linkage ………………………………………… jdbc:derby:/my/path/to/SIS_DATA/Databases/SpatialMetadata ├─ Description ……………………………… EPSG dataset version 9.1 on “Apache Derby Embedded JDBC Driver” version 10.14. └─ Function ……………………………………… Connection - Specified by:
- getAuthorityin interface- AuthorityFactory
- Returns:
- the organization responsible for definition of the database, or nullif unknown.
- See Also:
 
- 
getCodeSpacesReturns all namespaces recognized by this factory. Those namespaces can appear before codes in calls tocreateFoo(String)methods, for example"EPSG"in"EPSG:4326". Namespaces are case-insensitive.The namespaces are closely related to the authority. Often the namespace is the authority identifier, but not always. Examples:The default implementation infers the namespace from the authority. Subclasses can override this method, but the set should always contain the same elements during all factory lifetime.- The EPSGFactoryauthority identifier is"EPSG"and itsgetCodeSpaces()method returns a set containing"EPSG". So in this example, authority and namespace match. That namespace value means thatEPSGFactory.createFoo(String)methods accept both"EPSG:4326"(case-insensitive) and"4326"codes as argument.
- The EPSGDataAccessauthority identifier is"EPSG"but itsgetCodeSpaces()method returns an empty set. This means that despite the EPSG authority,EPSGDataAccess.createFoo(String)methods accept only codes like"4326"without"EPSG:"prefix (the reason is thatEPSGDataAccessis not expected to be used directly).
- The CommonAuthorityFactoryauthority identifiers are ISO 19128 and OGC 06-042 (the WMS specification) but itsgetCodeSpaces()method returns a set containing"CRS","AUTO"and"AUTO2". While ISO 19128 is defined as the first authority, the namespace is actually defined by OGC.
 - Returns:
- the namespaces recognized by this factory, or an empty set if none.
 
- The 
- 
getDescriptionTextReturns a description of the object corresponding to a code. The description can be used for example in a combo box in a graphical user interface.Default implementationThe default implementation invokescreateObject(String)for the given code and returns the object name. This may be costly since it involves a full object creation. Subclasses are encouraged to provide a more efficient implementation if they can.- Specified by:
- getDescriptionTextin interface- AuthorityFactory
- Parameters:
- code- value allocated by authority.
- Returns:
- a description of the object, or nullif the object corresponding to the specifiedcodehas no description.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if an error occurred while fetching the description.
 
- 
createObjectpublic abstract IdentifiedObject createObject(String code) throws NoSuchAuthorityCodeException, FactoryException Returns an arbitrary object from a code. The returned object will typically be an instance ofDatum,CoordinateSystem,CoordinateReferenceSystemorCoordinateOperation. This method may be used when the type of the object to create is unknown. But it is recommended to invoke the most specificcreateFoo(String)method when the desired type is known, both for performance reason and for avoiding ambiguity.Note for subclassesIn defaultGeodeticAuthorityFactoryimplementation, allcreateFoo(String)methods ultimately delegate to thiscreateObject(String)method and verify if the created object is of the desired type. Overriding this method is sufficient for supporting the more specificcreateFoo(String)methods, but subclasses are encouraged to override the latter for efficiency.- Specified by:
- createObjectin interface- AuthorityFactory
- Parameters:
- code- value allocated by authority.
- Returns:
- the object for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createCoordinateReferenceSystempublic CoordinateReferenceSystem createCoordinateReferenceSystem(String code) throws NoSuchAuthorityCodeException, FactoryException Creates an arbitrary coordinate reference system from a code. The returned object will typically be an instance ofGeographicCRS,ProjectedCRS,VerticalCRSorCompoundCRS. If the coordinate reference system type is known at compile time, it is recommended to invoke the most precise method instead of this one (for examplecreateGeographicCRS(String)instead ofcreateCoordinateReferenceSystem(code)if the caller know he is asking for a geographic coordinate reference system).Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. Two frequently used authorities are "CRS" and "EPSG", which include the following codes:Authority codes examples Code Type Description CRS:84 Geographic Like EPSG:4326 except for (longitude, latitude) axis order EPSG:4326 Geographic World Geodetic System 1984 EPSG:4979 Geographic 3D World Geodetic System 1984 EPSG:4978 Geocentric World Geodetic System 1984 EPSG:3395 Projected WGS 84 / World Mercator EPSG:5714 Vertical Mean Sea Level height EPSG:6349 Compound NAD83(2011) + NAVD88 height EPSG:5800 Engineering Astra Minas Grid Default implementationThe default implementation delegates tocreateObject(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate reference system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createGeographicCRSpublic GeographicCRS createGeographicCRS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 2- or 3-dimensional coordinate reference system based on an ellipsoidal approximation of the geoid. This provides an accurate representation of the geometry of geographic features for a large portion of the earth's surface.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. Two frequently used authorities are "CRS" and "EPSG", which include the following codes:Authority codes examples Code Type Description CRS:27 Geographic Like EPSG:4267 except for (longitude, latitude) axis order CRS:83 Geographic Like EPSG:4269 except for (longitude, latitude) axis order CRS:84 Geographic Like EPSG:4326 except for (longitude, latitude) axis order EPSG:4322 Geographic World Geodetic System 1972 EPSG:4985 Geographic 3D World Geodetic System 1972 EPSG:4326 Geographic World Geodetic System 1984 EPSG:4979 Geographic 3D World Geodetic System 1984 EPSG:4267 Geographic North American Datum 1927 EPSG:4269 Geographic North American Datum 1983 EPSG:4230 Geographic European Datum 1950 EPSG:4258 Geographic European Terrestrial Reference Frame 1989 EPSG:4937 Geographic 3D European Terrestrial Reference Frame 1989 Default implementationThe default implementation delegates tocreateCoordinateReferenceSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate reference system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createGeocentricCRSpublic GeocentricCRS createGeocentricCRS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 3-dimensional coordinate reference system with the origin at the approximate centre of mass of the earth. A geocentric CRS deals with the earth's curvature by taking a 3-dimensional spatial view, which obviates the need to model the earth's curvature.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description EPSG:4936 European Terrestrial Reference Frame 1989 EPSG:4978 World Geodetic System 1984 EPSG:4984 World Geodetic System 1972 Default implementationThe default implementation delegates tocreateCoordinateReferenceSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate reference system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed.
- See Also:
 
- 
createProjectedCRSpublic ProjectedCRS createProjectedCRS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 2-dimensional coordinate reference system used to approximate the shape of the earth on a planar surface. It is done in such a way that the distortion that is inherent to the approximation is carefully controlled and known. Distortion correction is commonly applied to calculated bearings and distances to produce values that are a close match to actual field values.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which contains more than 4000 codes for projected CRS. Some of them are:Authority codes examples Code Description EPSG:3034 ETRS89 / Lambert Conic Conformal Europe EPSG:3395 WGS 84 / World Mercator EPSG:6350 NAD83(2011) / Conus Albers Equal Area Default implementationThe default implementation delegates tocreateCoordinateReferenceSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate reference system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createVerticalCRSpublic VerticalCRS createVerticalCRS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 1-dimensional coordinate reference system used for recording heights or depths. Vertical CRSs make use of the direction of gravity to define the concept of height or depth, but the relationship with gravity may not be straightforward.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description EPSG:5715 Mean Sea Level depth EPSG:5714 Mean Sea Level height Default implementationThe default implementation delegates tocreateCoordinateReferenceSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate reference system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createTemporalCRSpublic TemporalCRS createTemporalCRS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 1-dimensional coordinate reference system used for the recording of time.Default implementationThe default implementation delegates tocreateCoordinateReferenceSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate reference system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createParametricCRSpublic DefaultParametricCRS createParametricCRS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 1-dimensional parametric coordinate reference system.Default implementationThe default implementation delegates tocreateCoordinateReferenceSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.Warning: in a future SIS version, the return type may be changed toorg.opengis.referencing.crs.ParametricCRS. This change is pending GeoAPI revision.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate reference system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createCompoundCRSpublic CompoundCRS createCompoundCRS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a CRS describing the position of points through two or more independent coordinate reference systems.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description EPSG:6349 NAD83(2011) + NAVD88 height EPSG:7423 ETRS89 + EVRF2007 height Default implementationThe default implementation delegates tocreateCoordinateReferenceSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate reference system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createDerivedCRSpublic DerivedCRS createDerivedCRS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a CRS that is defined by its coordinate conversion from another CRS (not by a datum).DerivedCRScannot beProjectedCRSthemselves, but may be derived from a projected CRS.Default implementationThe default implementation delegates tocreateCoordinateReferenceSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate reference system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createEngineeringCRSpublic EngineeringCRS createEngineeringCRS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 1-, 2- or 3-dimensional contextually local coordinate reference system.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description EPSG:5800 Astra Minas Grid Default implementationThe default implementation delegates tocreateCoordinateReferenceSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate reference system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createImageCRSCreates a 2-dimensional engineering coordinate reference system applied to locations in images. Image coordinate reference systems are treated as a separate sub-type because a separate user community exists for images with its own terms of reference.Default implementationThe default implementation delegates tocreateCoordinateReferenceSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate reference system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createDatumCreates an arbitrary datum from a code. The returned object will typically be an instance ofGeodeticDatum,VerticalDatumorTemporalDatum. If the datum is known at compile time, it is recommended to invoke the most precise method instead of this one.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which contains hundred of datum. Some of them are:Authority codes examples Code Type Description EPSG:6326 Geodetic World Geodetic System 1984 EPSG:6322 Geodetic World Geodetic System 1972 EPSG:1027 Vertical EGM2008 geoid EPSG:5100 Vertical Mean Sea Level EPSG:9315 Engineering Seismic bin grid datum Default implementationThe default implementation delegates tocreateObject(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the datum for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createGeodeticDatumpublic GeodeticDatum createGeodeticDatum(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a datum defining the location and orientation of an ellipsoid that approximates the shape of the earth. Geodetic datum are used together with ellipsoidal coordinate system, and also with Cartesian coordinate system centered in the ellipsoid (or sphere).Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which contains hundred of datum. Some of them are:Authority codes examples Code Description EPSG:6326 World Geodetic System 1984 EPSG:6322 World Geodetic System 1972 EPSG:6269 North American Datum 1983 EPSG:6258 European Terrestrial Reference System 1989 Default implementationThe default implementation delegates tocreateDatum(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the datum for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createVerticalDatumpublic VerticalDatum createVerticalDatum(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a datum identifying a particular reference level surface used as a zero-height surface. There are several types of vertical datums, and each may place constraints on the axis with which it is combined to create a vertical CRS.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description EPSG:5100 Mean Sea Level EPSG:1027 EGM2008 geoid EPSG:1131 Japanese Geodetic Datum 2011 (vertical) EPSG:5215 European Vertical Reference Frame 2007 Default implementationThe default implementation delegates tocreateDatum(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the datum for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createTemporalDatumpublic TemporalDatum createTemporalDatum(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a datum defining the origin of a temporal coordinate reference system.Default implementationThe default implementation delegates tocreateDatum(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the datum for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createParametricDatumpublic DefaultParametricDatum createParametricDatum(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a datum defining the origin of a parametric coordinate reference system.Default implementationThe default implementation delegates tocreateDatum(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.Warning: in a future SIS version, the return type may be changed toorg.opengis.referencing.datum.ParametricDatum. This change is pending GeoAPI revision.- Parameters:
- code- value allocated by authority.
- Returns:
- the datum for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createEngineeringDatumpublic EngineeringDatum createEngineeringDatum(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a datum defining the origin of an engineering coordinate reference system. An engineering datum is used in a region around that origin. This origin can be fixed with respect to the earth or be a defined point on a moving vehicle.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description EPSG:9315 Seismic bin grid datum EPSG:9300 Astra Minas Default implementationThe default implementation delegates tocreateDatum(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the datum for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createImageDatumpublic ImageDatum createImageDatum(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a datum defining the origin of an image coordinate reference system. An image datum is used in a local context only. For an image datum, the anchor point is usually either the centre of the image or the corner of the image.Default implementationThe default implementation delegates tocreateDatum(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the datum for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createEllipsoidCreates a geometric figure that can be used to describe the approximate shape of the earth. In mathematical terms, it is a surface formed by the rotation of an ellipse about its minor axis.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description EPSG:7030 WGS 84 EPSG:7034 Clarke 1880 EPSG:7048 GRS 1980 Authalic Sphere Default implementationThe default implementation delegates tocreateObject(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the ellipsoid for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createPrimeMeridianpublic PrimeMeridian createPrimeMeridian(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a prime meridian defining the origin from which longitude values are determined.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description EPSG:8901 Greenwich EPSG:8903 Paris EPSG:8904 Bogota EPSG:8905 Madrid EPSG:8906 Rome Default implementationThe default implementation delegates tocreateObject(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the prime meridian for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createExtentCreates information about spatial, vertical, and temporal extent (usually a domain of validity) from a code.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description EPSG:1262 World EPSG:3391 World - between 80°S and 84°N Default implementationThe default implementation delegates tocreateObject(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the extent for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createCoordinateSystempublic CoordinateSystem createCoordinateSystem(String code) throws NoSuchAuthorityCodeException, FactoryException Creates an arbitrary coordinate system from a code. The returned object will typically be an instance ofEllipsoidalCS,CartesianCS,VerticalCSorTimeCS. If the coordinate system is known at compile time, it is recommended to invoke the most precise method instead of this one.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Type Axes Orientations Unit EPSG:4496 Cartesian 2D CS easting, northing (E,N) east, north metre EPSG:6422 Ellipsoidal 2D CS latitude, longitude north, east degree EPSG:6423 Ellipsoidal 3D CS latitude, longitude, ellipsoidal height north, east, up degree, degree, metre EPSG:6404 Spherical 3D CS latitude, longitude, radius north, east, up degree, degree, metre EPSG:6499 Vertical CS height (H) up metre Default implementationThe default implementation delegates tocreateObject(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createEllipsoidalCSpublic EllipsoidalCS createEllipsoidalCS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 2- or 3-dimensional coordinate system for geodetic latitude and longitude, sometimes with ellipsoidal height.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Axes Orientations Unit EPSG:6422 latitude, longitude north, east degree EPSG:6424 longitude, latitude east, north degree EPSG:6429 longitude, latitude east, north radian EPSG:6423 latitude, longitude, ellipsoidal height north, east, up degree, degree, metre Default implementationThe default implementation delegates tocreateCoordinateSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createVerticalCSpublic VerticalCS createVerticalCS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 1-dimensional coordinate system for heights or depths of points.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Axes Orientations Unit EPSG:6498 depth (D) down metre EPSG:6499 height (H) up metre Default implementationThe default implementation delegates tocreateCoordinateSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createTimeCSCreates a 1-dimensional coordinate system for time elapsed in the specified time units from a specified time origin.Default implementationThe default implementation delegates tocreateCoordinateSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createParametricCSpublic DefaultParametricCS createParametricCS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 1-dimensional parametric coordinate system.Default implementationThe default implementation delegates tocreateCoordinateSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.Warning: in a future SIS version, the return type may be changed toorg.opengis.referencing.cs.ParametricCS. This change is pending GeoAPI revision.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createCartesianCSpublic CartesianCS createCartesianCS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 2- or 3-dimensional Cartesian coordinate system made of straight orthogonal axes. All axes shall have the same linear unit of measure.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Axes Orientations Unit EPSG:4406 easting, northing (E,N) east, north kilometre EPSG:4496 easting, northing (E,N) east, north metre EPSG:4500 northing, easting (N,E) north, east metre EPSG:4491 westing, northing (W,N) west, north metre Default implementationThe default implementation delegates tocreateCoordinateSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createSphericalCSpublic SphericalCS createSphericalCS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 3-dimensional coordinate system with one distance measured from the origin and two angular coordinates. Not to be confused with an ellipsoidal coordinate system based on an ellipsoid "degenerated" into a sphere.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Axes Orientations Unit EPSG:6404 latitude, longitude, radius north, east, up degree, degree, metre Default implementationThe default implementation delegates tocreateCoordinateSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createCylindricalCSpublic CylindricalCS createCylindricalCS(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a 3-dimensional coordinate system made of a polar coordinate system extended by a straight perpendicular axis.Default implementationThe default implementation delegates tocreateCoordinateSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createPolarCSCreates a 2-dimensional coordinate system for coordinates represented by a distance from the origin and an angle from a fixed direction.Default implementationThe default implementation delegates tocreateCoordinateSystem(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the coordinate system for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createCoordinateSystemAxispublic CoordinateSystemAxis createCoordinateSystemAxis(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a coordinate system axis with name, direction, unit and range of values.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description Unit EPSG:106 Latitude (φ) degree EPSG:107 Longitude (λ) degree EPSG:1 Easting (E) metre EPSG:2 Northing (N) metre Default implementationThe default implementation delegates tocreateObject(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the axis for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createUnitCreates an unit of measurement from a code.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:
 SeeAuthority codes examples Code Description EPSG:9002 decimal degree EPSG:9001 metre EPSG:9030 kilometre EPSG:1040 second EPSG:1029 year Units.valueOfEPSG(int)for a more complete list of codes.Default implementationThe default implementation delegates tocreateObject(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the unit of measurement for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createParameterDescriptorpublic ParameterDescriptor<?> createParameterDescriptor(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a definition of a single parameter used by an operation method.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description EPSG:8801 Latitude of natural origin EPSG:8802 Longitude of natural origin EPSG:8805 Scale factor at natural origin EPSG:8806 False easting EPSG:8807 False northing Default implementationThe default implementation delegates tocreateObject(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the parameter descriptor for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createOperationMethodpublic OperationMethod createOperationMethod(String code) throws NoSuchAuthorityCodeException, FactoryException Creates a description of the algorithm and parameters used to perform a coordinate operation. AnOperationMethodis a kind of metadata: it does not perform any coordinate operation (e.g. map projection) by itself, but tells us what is needed in order to perform such operation.Available methods depend both on the set declared by the authority and on the list of methods implemented in Apache SIS. In order to be supported, an operation method must have its formulas coded in the Java programming language. See MathTransformProviderfor more information.Default implementationThe default implementation delegates tocreateObject(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the operation method for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createCoordinateOperationpublic CoordinateOperation createCoordinateOperation(String code) throws NoSuchAuthorityCodeException, FactoryException Creates an operation for transforming coordinates in the source CRS to coordinates in the target CRS. Coordinate operations contain a math transform, which does the actual work of transforming coordinates.Example: the set of available codes depends on the defining authority and theGeodeticAuthorityFactorysubclass in use. A frequently used authority is "EPSG", which includes the following codes:Authority codes examples Code Description EPSG:1133 ED50 to WGS 84 (1) EPSG:1241 NAD27 to NAD83 (1) EPSG:1173 NAD27 to WGS 84 (4) EPSG:6326 NAD83(2011) to NAVD88 height (1) Default implementationThe default implementation delegates tocreateObject(String)and casts the result. If the result cannot be casted, then aNoSuchAuthorityCodeExceptionis thrown.- Parameters:
- code- value allocated by authority.
- Returns:
- the operation for the given code.
- Throws:
- NoSuchAuthorityCodeException- if the specified- codewas not found.
- FactoryException- if the object creation failed for some other reason.
- See Also:
 
- 
createFromCoordinateReferenceSystemCodespublic Set<CoordinateOperation> createFromCoordinateReferenceSystemCodes(String sourceCRS, String targetCRS) throws NoSuchAuthorityCodeException, FactoryException Creates operations from source and target coordinate reference system codes. This method should only extract the information explicitly declared in a database like EPSG. This method should not attempt to infer by itself operations that are not explicitly recorded in the database.Default implementationThe default implementation returns an empty set.- Parameters:
- sourceCRS- coded value of source coordinate reference system.
- targetCRS- coded value of target coordinate reference system.
- Returns:
- the operations from sourceCRStotargetCRS.
- Throws:
- NoSuchAuthorityCodeException- if a specified code was not found.
- FactoryException- if the object creation failed for some other reason.
 
- 
newIdentifiedObjectFinderCreates a finder which can be used for looking up unidentified objects. The finder tries to fetch a fully identified object from an incomplete one, for example from an object without "ID[…]" or "AUTHORITY[…]" element in Well Known Text.- Returns:
- a finder to use for looking up unidentified objects.
- Throws:
- FactoryException- if the finder cannot be created.
- See Also:
 
- 
trimNamespaceTrims the namespace, if present. For example if this factory is an EPSG authority factory and the specified code start with the"EPSG:"prefix, then the prefix is removed. Otherwise, the string is returned unchanged (except for leading and trailing spaces).- Parameters:
- code- the code to trim.
- Returns:
- the code with the namespace part removed if that part matched one of the values given by
         getCodeSpaces().
- Since:
- 0.8
 
- 
toStringReturns a string representation of this factory for debugging purpose only. The string returned by this method may change in any future SIS version.
 
-