public class GeodeticObjectFactory extends AbstractFactory implements CRSFactory, CSFactory, DatumFactory, Parser
CRSFactory
(for example
authority factories or WKT parsers).GeodeticObjectFactory
class is not easy to use directly.
Users are encouraged to use an authority factory instead
(or the CRS#forCode(String)
convenience method) when the CRS object to construct can be identified
by a code in the namespace of an authority (typically EPSG).
Map<String,?>
argument, often followed by explicit arguments.
Unless otherwise noticed, information provided in the properties
map are considered ignorable metadata
while information provided in explicit arguments have an impact on coordinate transformation results.
The following table lists the keys recognized by the GeodeticObjectFactory
default implementation,
together with the type of values associated to those keys.
A value for the "name"
key is mandatory for all objects, while all other properties are optional.
GeodeticObjectFactory
methods ignore all unknown properties.
"remarks"
may have a language and country code suffix.
For example the "remarks_fr"
property stands for remarks in French and
the "remarks_fr_CA"
property stands for remarks in French Canadian.
They are convenience properties for building the InternationalString
value.
The "locale"
property applies only in case of exception for formatting the error message, and
is used only on a best effort basis. The locale is discarded after successful construction
since localizations are applied by the InternationalString.toString(Locale)
method.
Defined in the sis-referencing
module
Constructor and Description |
---|
GeodeticObjectFactory()
Constructs a factory with no default properties.
|
GeodeticObjectFactory(Map<String,?> properties)
Constructs a factory with the given default properties.
|
Modifier and Type | Method and Description |
---|---|
protected Map<String,?> |
complete(Map<String,?> properties)
Returns the union of the given
properties map with the default properties given at
construction time. |
AffineCS |
createAffineCS(Map<String,?> properties,
CoordinateSystemAxis axis0,
CoordinateSystemAxis axis1)
Creates a two-dimensional affine coordinate system from the given pair of axis.
|
AffineCS |
createAffineCS(Map<String,?> properties,
CoordinateSystemAxis axis0,
CoordinateSystemAxis axis1,
CoordinateSystemAxis axis2)
Creates a three-dimensional affine coordinate system from the given set of axis.
|
CartesianCS |
createCartesianCS(Map<String,?> properties,
CoordinateSystemAxis axis0,
CoordinateSystemAxis axis1)
Creates a two-dimensional Cartesian coordinate system from the given pair of axis.
|
CartesianCS |
createCartesianCS(Map<String,?> properties,
CoordinateSystemAxis axis0,
CoordinateSystemAxis axis1,
CoordinateSystemAxis axis2)
Creates a three-dimensional Cartesian coordinate system from the given set of axis.
|
CompoundCRS |
createCompoundCRS(Map<String,?> properties,
CoordinateReferenceSystem... elements)
Creates a compound coordinate reference system from an ordered list of
CoordinateReferenceSystem objects. |
CoordinateSystemAxis |
createCoordinateSystemAxis(Map<String,?> properties,
String abbreviation,
AxisDirection direction,
Unit<?> unit)
Creates a coordinate system axis from an abbreviation and a unit.
|
CylindricalCS |
createCylindricalCS(Map<String,?> properties,
CoordinateSystemAxis axis0,
CoordinateSystemAxis axis1,
CoordinateSystemAxis axis2)
Creates a cylindrical coordinate system from the given set of axis.
|
DerivedCRS |
createDerivedCRS(Map<String,?> properties,
CoordinateReferenceSystem baseCRS,
Conversion conversion,
CoordinateSystem derivedCS)
Creates a derived coordinate reference system from a conversion.
|
Ellipsoid |
createEllipsoid(Map<String,?> properties,
double semiMajorAxis,
double semiMinorAxis,
Unit<Length> unit)
Creates an ellipsoid from semi-axis length values.
|
EllipsoidalCS |
createEllipsoidalCS(Map<String,?> properties,
CoordinateSystemAxis axis0,
CoordinateSystemAxis axis1)
Creates an ellipsoidal coordinate system without ellipsoidal height.
|
EllipsoidalCS |
createEllipsoidalCS(Map<String,?> properties,
CoordinateSystemAxis axis0,
CoordinateSystemAxis axis1,
CoordinateSystemAxis axis2)
Creates an ellipsoidal coordinate system with ellipsoidal height.
|
EngineeringCRS |
createEngineeringCRS(Map<String,?> properties,
EngineeringDatum datum,
CoordinateSystem cs)
Creates a engineering coordinate reference system.
|
EngineeringDatum |
createEngineeringDatum(Map<String,?> properties)
Creates an engineering datum.
|
Ellipsoid |
createFlattenedSphere(Map<String,?> properties,
double semiMajorAxis,
double inverseFlattening,
Unit<Length> unit)
Creates an ellipsoid from a major semi-axis length and inverse flattening.
|
CoordinateReferenceSystem |
createFromWKT(String text)
Creates a Coordinate Reference System object from a Well Known Text (WKT).
|
CoordinateReferenceSystem |
createFromXML(String xml)
Creates a coordinate reference system object from a XML string.
|
GeocentricCRS |
createGeocentricCRS(Map<String,?> properties,
GeodeticDatum datum,
CartesianCS cs)
Creates a geocentric coordinate reference system from a Cartesian coordinate system.
|
GeocentricCRS |
createGeocentricCRS(Map<String,?> properties,
GeodeticDatum datum,
SphericalCS cs)
Creates a geocentric coordinate reference system from a spherical coordinate system.
|
GeodeticDatum |
createGeodeticDatum(Map<String,?> properties,
Ellipsoid ellipsoid,
PrimeMeridian primeMeridian)
Creates geodetic datum from ellipsoid and (optionally) Bursa-Wolf parameters.
|
GeographicCRS |
createGeographicCRS(Map<String,?> properties,
GeodeticDatum datum,
EllipsoidalCS cs)
Creates a geographic coordinate reference system.
|
ImageCRS |
createImageCRS(Map<String,?> properties,
ImageDatum datum,
AffineCS cs)
Creates an image coordinate reference system.
|
ImageDatum |
createImageDatum(Map<String,?> properties,
PixelInCell pixelInCell)
Creates an image datum.
|
LinearCS |
createLinearCS(Map<String,?> properties,
CoordinateSystemAxis axis)
Creates a linear coordinate system.
|
PolarCS |
createPolarCS(Map<String,?> properties,
CoordinateSystemAxis axis0,
CoordinateSystemAxis axis1)
Creates a polar coordinate system from the given pair of axis.
|
PrimeMeridian |
createPrimeMeridian(Map<String,?> properties,
double longitude,
Unit<Angle> angularUnit)
Creates a prime meridian, relative to Greenwich.
|
ProjectedCRS |
createProjectedCRS(Map<String,?> properties,
GeographicCRS baseCRS,
Conversion conversion,
CartesianCS derivedCS)
Creates a projected coordinate reference system from a conversion.
|
SphericalCS |
createSphericalCS(Map<String,?> properties,
CoordinateSystemAxis axis0,
CoordinateSystemAxis axis1,
CoordinateSystemAxis axis2)
Creates a spherical coordinate system from the given set of axis.
|
TemporalCRS |
createTemporalCRS(Map<String,?> properties,
TemporalDatum datum,
TimeCS cs)
Creates a temporal coordinate reference system.
|
TemporalDatum |
createTemporalDatum(Map<String,?> properties,
Date origin)
Creates a temporal datum from an enumerated type value.
|
TimeCS |
createTimeCS(Map<String,?> properties,
CoordinateSystemAxis axis)
Creates a temporal coordinate system.
|
UserDefinedCS |
createUserDefinedCS(Map<String,?> properties,
CoordinateSystemAxis axis0,
CoordinateSystemAxis axis1)
Creates a two-dimensional user defined coordinate system from the given pair of axis.
|
UserDefinedCS |
createUserDefinedCS(Map<String,?> properties,
CoordinateSystemAxis axis0,
CoordinateSystemAxis axis1,
CoordinateSystemAxis axis2)
Creates a three-dimensional user defined coordinate system from the given set of axis.
|
VerticalCRS |
createVerticalCRS(Map<String,?> properties,
VerticalDatum datum,
VerticalCS cs)
Creates a vertical coordinate reference system.
|
VerticalCS |
createVerticalCS(Map<String,?> properties,
CoordinateSystemAxis axis)
Creates a vertical coordinate system.
|
VerticalDatum |
createVerticalDatum(Map<String,?> properties,
VerticalDatumType type)
Creates a vertical datum from an enumerated type value.
|
getVendor
public GeodeticObjectFactory()
public GeodeticObjectFactory(Map<String,?> properties)
GeodeticObjectFactory
will fallback on the map given to this constructor for any property
not present in the map provided to a createFoo(Map<String,?>, …)
method.properties
- The default properties, or null
if none.protected Map<String,?> complete(Map<String,?> properties)
properties
map with the default properties given at
construction time. Entries in the given properties
map have precedence, even if their value is null
(i.e. a null value "erase" the default property value).
Entries with null value after the union will be omitted.
This method is invoked by all createFoo(Map<String,?>, …)
methods.
properties
- The user-supplied properties.public GeocentricCRS createGeocentricCRS(Map<String,?> properties, GeodeticDatum datum, CartesianCS cs) throws FactoryException
The components needed by this method can be created by the following methods:
createGeodeticDatum(Map, Ellipsoid, PrimeMeridian)
createCartesianCS(Map, CoordinateSystemAxis, CoordinateSystemAxis, CoordinateSystemAxis)
DefaultGeocentricCRS
instance.createGeocentricCRS
in interface CRSFactory
properties
- Name and other properties to give to the new object.datum
- The geodetic datum to use in created CRS.cs
- The three-dimensional Cartesian coordinate system for the created CRS.FactoryException
- if the object creation failed.DefaultGeocentricCRS.DefaultGeocentricCRS(Map, GeodeticDatum, CartesianCS)
public CartesianCS createCartesianCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) throws FactoryException
The components needed by this method can be created by the following method:
The default implementation creates aDefaultCartesianCS
instance.createCartesianCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis0
- The first axis (e.g. “Geocentric X”).axis1
- The second axis (e.g. “Geocentric Y”).axis2
- The third axis (e.g. “Geocentric Z”).FactoryException
- if the object creation failed.DefaultCartesianCS.DefaultCartesianCS(Map, CoordinateSystemAxis, CoordinateSystemAxis, CoordinateSystemAxis)
public GeocentricCRS createGeocentricCRS(Map<String,?> properties, GeodeticDatum datum, SphericalCS cs) throws FactoryException
The components needed by this method can be created by the following methods:
createGeodeticDatum(Map, Ellipsoid, PrimeMeridian)
createSphericalCS(Map, CoordinateSystemAxis, CoordinateSystemAxis, CoordinateSystemAxis)
DefaultGeocentricCRS
instance.createGeocentricCRS
in interface CRSFactory
properties
- Name and other properties to give to the new object.datum
- Geodetic datum to use in created CRS.cs
- The spherical coordinate system for the created CRS.FactoryException
- if the object creation failed.DefaultGeocentricCRS.DefaultGeocentricCRS(Map, GeodeticDatum, SphericalCS)
public SphericalCS createSphericalCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) throws FactoryException
The components needed by this method can be created by the following method:
The default implementation creates aDefaultSphericalCS
instance.createSphericalCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis0
- The first axis (e.g. “Spherical latitude”).axis1
- The second axis (e.g. “Spherical longitude”).axis2
- The third axis (e.g. “Geocentric radius”).FactoryException
- if the object creation failed.DefaultSphericalCS.DefaultSphericalCS(Map, CoordinateSystemAxis, CoordinateSystemAxis, CoordinateSystemAxis)
public GeographicCRS createGeographicCRS(Map<String,?> properties, GeodeticDatum datum, EllipsoidalCS cs) throws FactoryException
The components needed by this method can be created by the following methods:
createGeodeticDatum(Map, Ellipsoid, PrimeMeridian)
createEllipsoidalCS(Map, CoordinateSystemAxis, CoordinateSystemAxis)
DefaultGeographicCRS
instance.createGeographicCRS
in interface CRSFactory
properties
- Name and other properties to give to the new object.datum
- Geodetic datum to use in created CRS.cs
- The two- or three-dimensional ellipsoidal coordinate system for the created CRS.FactoryException
- if the object creation failed.DefaultGeographicCRS.DefaultGeographicCRS(Map, GeodeticDatum, EllipsoidalCS)
public GeodeticDatum createGeodeticDatum(Map<String,?> properties, Ellipsoid ellipsoid, PrimeMeridian primeMeridian) throws FactoryException
The components needed by this method can be created by the following methods:
createEllipsoid(Map, double, double, Unit)
or createFlattenedSphere(Map, double, double, Unit)
createPrimeMeridian(Map, double, Unit)
DefaultGeodeticDatum
instance.createGeodeticDatum
in interface DatumFactory
properties
- Name and other properties to give to the new object.ellipsoid
- The ellipsoid to use in new geodetic datum.primeMeridian
- The prime meridian to use in new geodetic datum.FactoryException
- if the object creation failed.DefaultGeodeticDatum.DefaultGeodeticDatum(Map, Ellipsoid, PrimeMeridian)
public PrimeMeridian createPrimeMeridian(Map<String,?> properties, double longitude, Unit<Angle> angularUnit) throws FactoryException
The default implementation creates a DefaultPrimeMeridian
instance.
createPrimeMeridian
in interface DatumFactory
properties
- Name and other properties to give to the new object.longitude
- The longitude of prime meridian in supplied angular units East of Greenwich.angularUnit
- The angular units of longitude.FactoryException
- if the object creation failed.DefaultPrimeMeridian.DefaultPrimeMeridian(Map, double, Unit)
public EllipsoidalCS createEllipsoidalCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1) throws FactoryException
The components needed by this method can be created by the following method:
The default implementation creates aDefaultEllipsoidalCS
instance.createEllipsoidalCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis0
- The first axis (e.g. “Geodetic latitude”).axis1
- The second axis (e.g. “Geodetic longitude”).FactoryException
- if the object creation failed.DefaultEllipsoidalCS.DefaultEllipsoidalCS(Map, CoordinateSystemAxis, CoordinateSystemAxis)
public EllipsoidalCS createEllipsoidalCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) throws FactoryException
The components needed by this method can be created by the following method:
The default implementation creates aDefaultEllipsoidalCS
instance.createEllipsoidalCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis0
- The first axis (e.g. “Geodetic latitude”).axis1
- The second axis (e.g. “Geodetic longitude”).axis2
- The third axis (e.g. “Ellipsoidal height”).FactoryException
- if the object creation failed.DefaultEllipsoidalCS.DefaultEllipsoidalCS(Map, CoordinateSystemAxis, CoordinateSystemAxis, CoordinateSystemAxis)
public Ellipsoid createEllipsoid(Map<String,?> properties, double semiMajorAxis, double semiMinorAxis, Unit<Length> unit) throws FactoryException
DefaultEllipsoid
instance.createEllipsoid
in interface DatumFactory
properties
- Name and other properties to give to the new object.semiMajorAxis
- The equatorial radius in supplied linear units.semiMinorAxis
- The polar radius in supplied linear units.unit
- The linear units of ellipsoid axes.FactoryException
- if the object creation failed.DefaultEllipsoid.createEllipsoid(Map, double, double, Unit)
public Ellipsoid createFlattenedSphere(Map<String,?> properties, double semiMajorAxis, double inverseFlattening, Unit<Length> unit) throws FactoryException
DefaultEllipsoid
instance.createFlattenedSphere
in interface DatumFactory
properties
- Name and other properties to give to the new object.semiMajorAxis
- The equatorial radius in supplied linear units.inverseFlattening
- The eccentricity of ellipsoid.unit
- The linear units of major axis.FactoryException
- if the object creation failed.DefaultEllipsoid.createFlattenedSphere(Map, double, double, Unit)
public ProjectedCRS createProjectedCRS(Map<String,?> properties, GeographicCRS baseCRS, Conversion conversion, CartesianCS derivedCS) throws FactoryException
The components needed by this method can be created by the following methods:
createGeographicCRS(Map, GeodeticDatum, EllipsoidalCS)
DefaultCoordinateOperationFactory.createDefiningConversion(Map, OperationMethod, ParameterValueGroup)
createCartesianCS(Map, CoordinateSystemAxis, CoordinateSystemAxis)
conversion
argument shall not includes the operation steps
for performing unit
conversions and change of axis order since those operations will be inferred by this constructor.
The default implementation creates a DefaultProjectedCRS
instance.
createProjectedCRS
in interface CRSFactory
properties
- Name and other properties to give to the new object.baseCRS
- The geographic coordinate reference system to base projection on.conversion
- The defining conversion from a normalized base to a normalized derived CRS.derivedCS
- The coordinate system for the projected CRS.FactoryException
- if the object creation failed.DefaultProjectedCRS.DefaultProjectedCRS(Map, GeographicCRS, Conversion, CartesianCS)
public CartesianCS createCartesianCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1) throws FactoryException
The components needed by this method can be created by the following method:
The default implementation creates aDefaultCartesianCS
instance.createCartesianCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis0
- The first axis (e.g. “Easting”).axis1
- The second axis (e.g. “Northing”).FactoryException
- if the object creation failed.DefaultCartesianCS.DefaultCartesianCS(Map, CoordinateSystemAxis, CoordinateSystemAxis)
public DerivedCRS createDerivedCRS(Map<String,?> properties, CoordinateReferenceSystem baseCRS, Conversion conversion, CoordinateSystem derivedCS) throws FactoryException
GeodeticCRS
, VerticalCRS
,
TemporalCRS
or EngineeringCRS
interface depending on the type of the base CRS and the
coordinate system.
The components needed by this method can be created by the following methods:
createFooCRS(…)
method for geocentric, geographic, vertical, temporal or engineering CRS.DefaultCoordinateOperationFactory.createDefiningConversion(Map, OperationMethod, ParameterValueGroup)
createFooCS(…)
method for Cartesian, spherical, ellipsoidal, vertical, temporal, linear, affine, polar, cylindrical or user-defined CS.conversion
argument shall not includes the operation steps
for performing unit
conversions and change of axis order since those operations will be inferred by this constructor.
The default implementation creates a DefaultDerivedCRS
instance.
createDerivedCRS
in interface CRSFactory
properties
- Name and other properties to give to the new object.baseCRS
- The coordinate reference system to base projection on. Shall be an instance of SingleCRS
.conversion
- The defining conversion from a normalized base to a normalized derived CRS.derivedCS
- The coordinate system for the derived CRS.FactoryException
- if the object creation failed.DefaultDerivedCRS.create(Map, SingleCRS, Conversion, CoordinateSystem)
public VerticalCRS createVerticalCRS(Map<String,?> properties, VerticalDatum datum, VerticalCS cs) throws FactoryException
The components needed by this method can be created by the following methods:
The default implementation creates aDefaultVerticalCRS
instance.createVerticalCRS
in interface CRSFactory
properties
- Name and other properties to give to the new object.datum
- The vertical datum to use in created CRS.cs
- The vertical coordinate system for the created CRS.FactoryException
- if the object creation failed.DefaultVerticalCRS.DefaultVerticalCRS(Map, VerticalDatum, VerticalCS)
public VerticalDatum createVerticalDatum(Map<String,?> properties, VerticalDatumType type) throws FactoryException
DefaultVerticalDatum
instance.createVerticalDatum
in interface DatumFactory
properties
- Name and other properties to give to the new object.type
- The type of this vertical datum (often geoidal).FactoryException
- if the object creation failed.DefaultVerticalDatum.DefaultVerticalDatum(Map, VerticalDatumType)
public VerticalCS createVerticalCS(Map<String,?> properties, CoordinateSystemAxis axis) throws FactoryException
The components needed by this method can be created by the following method:
The default implementation creates aDefaultVerticalCS
instance.createVerticalCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis
- The single axis (e.g. “height” or “depth”).FactoryException
- if the object creation failed.DefaultVerticalCS.DefaultVerticalCS(Map, CoordinateSystemAxis)
public TemporalCRS createTemporalCRS(Map<String,?> properties, TemporalDatum datum, TimeCS cs) throws FactoryException
The components needed by this method can be created by the following methods:
The default implementation creates aDefaultTemporalCRS
instance.createTemporalCRS
in interface CRSFactory
properties
- Name and other properties to give to the new object.datum
- The temporal datum to use in created CRS.cs
- The temporal coordinate system for the created CRS.FactoryException
- if the object creation failed.DefaultTemporalCRS.DefaultTemporalCRS(Map, TemporalDatum, TimeCS)
public TemporalDatum createTemporalDatum(Map<String,?> properties, Date origin) throws FactoryException
DefaultTemporalDatum
instance.createTemporalDatum
in interface DatumFactory
properties
- Name and other properties to give to the new object.origin
- The date and time origin of this temporal datum.FactoryException
- if the object creation failed.DefaultTemporalDatum.DefaultTemporalDatum(Map, Date)
public TimeCS createTimeCS(Map<String,?> properties, CoordinateSystemAxis axis) throws FactoryException
The components needed by this method can be created by the following methods:
The default implementation creates aDefaultTimeCS
instance.createTimeCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis
- The single axis.FactoryException
- if the object creation failed.DefaultTimeCS.DefaultTimeCS(Map, CoordinateSystemAxis)
public CompoundCRS createCompoundCRS(Map<String,?> properties, CoordinateReferenceSystem... elements) throws FactoryException
CoordinateReferenceSystem
objects.
Apache SIS puts no restriction on the components that can be used in a compound CRS.
However for better inter-operability, users are encouraged to follow the order mandated by ISO 19162:
GeographicCRS
or ProjectedCRS
or EngineeringCRS
).VerticalCRS
or a ParametricCRS
(but not both).TemporalCRS
.DefaultCompoundCRS
instance.createCompoundCRS
in interface CRSFactory
properties
- Name and other properties to give to the new object.elements
- Ordered array of CoordinateReferenceSystem
objects.FactoryException
- if the object creation failed.DefaultCompoundCRS.DefaultCompoundCRS(Map, CoordinateReferenceSystem...)
public ImageCRS createImageCRS(Map<String,?> properties, ImageDatum datum, AffineCS cs) throws FactoryException
DefaultImageCRS
instance.createImageCRS
in interface CRSFactory
properties
- Name and other properties to give to the new object.datum
- The image datum to use in created CRS.cs
- The Cartesian or oblique Cartesian coordinate system for the created CRS.FactoryException
- if the object creation failed.DefaultImageCRS.DefaultImageCRS(Map, ImageDatum, AffineCS)
public ImageDatum createImageDatum(Map<String,?> properties, PixelInCell pixelInCell) throws FactoryException
DefaultImageDatum
instance.createImageDatum
in interface DatumFactory
properties
- Name and other properties to give to the new object.pixelInCell
- Specification of the way the image grid is associated with the image data attributes.FactoryException
- if the object creation failed.DefaultImageDatum.DefaultImageDatum(Map, PixelInCell)
public AffineCS createAffineCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1) throws FactoryException
The components needed by this method can be created by the following methods:
The default implementation creates aDefaultAffineCS
instance.createAffineCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis0
- The first axis.axis1
- The second axis.FactoryException
- if the object creation failed.DefaultAffineCS.DefaultAffineCS(Map, CoordinateSystemAxis, CoordinateSystemAxis)
public EngineeringCRS createEngineeringCRS(Map<String,?> properties, EngineeringDatum datum, CoordinateSystem cs) throws FactoryException
The components needed by this method can be created by the following methods:
createEngineeringDatum(Map)
createFooCS(…)
method for Cartesian, spherical, linear, affine, polar, cylindrical or user-defined CS.DefaultEngineeringCRS
instance.createEngineeringCRS
in interface CRSFactory
properties
- Name and other properties to give to the new object.datum
- The engineering datum to use in created CRS.cs
- The coordinate system for the created CRS.FactoryException
- if the object creation failed.DefaultEngineeringCRS.DefaultEngineeringCRS(Map, EngineeringDatum, CoordinateSystem)
public EngineeringDatum createEngineeringDatum(Map<String,?> properties) throws FactoryException
DefaultEngineeringDatum
instance.createEngineeringDatum
in interface DatumFactory
properties
- Name and other properties to give to the new object.FactoryException
- if the object creation failed.DefaultEngineeringDatum.DefaultEngineeringDatum(Map)
public AffineCS createAffineCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) throws FactoryException
The components needed by this method can be created by the following methods:
The default implementation creates aDefaultAffineCS
instance.createAffineCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis0
- The first axis.axis1
- The second axis.axis2
- The third axis.FactoryException
- if the object creation failed.DefaultAffineCS.DefaultAffineCS(Map, CoordinateSystemAxis, CoordinateSystemAxis)
public CylindricalCS createCylindricalCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) throws FactoryException
The components needed by this method can be created by the following methods:
The default implementation creates aDefaultCylindricalCS
instance.createCylindricalCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis0
- The first axis.axis1
- The second axis.axis2
- The third axis.FactoryException
- if the object creation failed.DefaultCylindricalCS.DefaultCylindricalCS(Map, CoordinateSystemAxis, CoordinateSystemAxis, CoordinateSystemAxis)
public PolarCS createPolarCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1) throws FactoryException
The components needed by this method can be created by the following methods:
The default implementation creates aDefaultPolarCS
instance.createPolarCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis0
- The first axis.axis1
- The second axis.FactoryException
- if the object creation failed.DefaultPolarCS.DefaultPolarCS(Map, CoordinateSystemAxis, CoordinateSystemAxis)
public LinearCS createLinearCS(Map<String,?> properties, CoordinateSystemAxis axis) throws FactoryException
The components needed by this method can be created by the following methods:
The default implementation creates aDefaultLinearCS
instance.createLinearCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis
- The single axis.FactoryException
- if the object creation failed.DefaultLinearCS.DefaultLinearCS(Map, CoordinateSystemAxis)
public UserDefinedCS createUserDefinedCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1) throws FactoryException
The components needed by this method can be created by the following methods:
The default implementation creates aDefaultUserDefinedCS
instance.createUserDefinedCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis0
- The first axis.axis1
- The second axis.FactoryException
- if the object creation failed.DefaultUserDefinedCS.DefaultUserDefinedCS(Map, CoordinateSystemAxis, CoordinateSystemAxis)
public UserDefinedCS createUserDefinedCS(Map<String,?> properties, CoordinateSystemAxis axis0, CoordinateSystemAxis axis1, CoordinateSystemAxis axis2) throws FactoryException
The components needed by this method can be created by the following methods:
The default implementation creates aDefaultUserDefinedCS
instance.createUserDefinedCS
in interface CSFactory
properties
- Name and other properties to give to the new object.axis0
- The first axis.axis1
- The second axis.axis2
- The third axis.FactoryException
- if the object creation failed.DefaultUserDefinedCS.DefaultUserDefinedCS(Map, CoordinateSystemAxis, CoordinateSystemAxis, CoordinateSystemAxis)
public CoordinateSystemAxis createCoordinateSystemAxis(Map<String,?> properties, String abbreviation, AxisDirection direction, Unit<?> unit) throws FactoryException
CoordinateSystemAxis
javadoc for more information.
The default implementation creates a DefaultCoordinateSystemAxis
instance.
createCoordinateSystemAxis
in interface CSFactory
properties
- Name and other properties to give to the new object.abbreviation
- The coordinate axis abbreviation.direction
- The axis direction.unit
- The coordinate axis unit.FactoryException
- if the object creation failed.DefaultCoordinateSystemAxis.DefaultCoordinateSystemAxis(Map, String, AxisDirection, Unit)
public CoordinateReferenceSystem createFromXML(String xml) throws FactoryException
The default implementation delegates to XML.unmarshal(String)
createFromXML
in interface CRSFactory
xml
- Coordinate reference system encoded in XML format.FactoryException
- if the object creation failed.public CoordinateReferenceSystem createFromWKT(String text) throws FactoryException
UNIT[…]
and ORDER[…]
elements have been omitted.
ProjectedCRS["SIRGAS 2000 / Brazil Mercator", BaseGeodCRS["SIRGAS 2000", Datum["Sistema de Referencia Geocentrico para las Americas 2000", Ellipsoid["GRS 1980", 6378137, 298.257222101]]], Conversion["Petrobras Mercator", Method["Mercator (variant B)", Id["EPSG",9805]], Parameter["Latitude of 1st standard parallel", -2], Parameter["Longitude of natural origin", -43], Parameter["False easting", 5000000], Parameter["False northing", 10000000]], CS[cartesian,2], Axis["easting (E)", east], Axis["northing (N)", north], LengthUnit["metre", 1], Id["EPSG",5641]]
WKTFormat
with the addition of thread-safety. This is okay for occasional use,
but is sub-optimal if this method is extensively used in a multi-thread environment.
Furthermore this method offers no control on the WKT conventions
in use and on the handling of warnings.
Applications which need to parse a large amount of WKT strings should consider to use
the WKTFormat
class instead than this method.createFromWKT
in interface Parser
createFromWKT
in interface CRSFactory
text
- Coordinate system encoded in Well-Known Text format (version 1 or 2).FactoryException
- if the object creation failed.org.apache.sis.io.wkt
,
WKT 2 specification,
Legacy WKT 1Copyright © 2010–2015 The Apache Software Foundation. All rights reserved.