mil.nga.geopackage.srs.SpatialReferenceSystem Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of geopackage-core Show documentation
Show all versions of geopackage-core Show documentation
Core functionality for GeoPackage implementations
package mil.nga.geopackage.srs;
import com.j256.ormlite.dao.ForeignCollection;
import com.j256.ormlite.field.DatabaseField;
import com.j256.ormlite.field.ForeignCollectionField;
import com.j256.ormlite.table.DatabaseTable;
import mil.nga.geopackage.GeoPackageConstants;
import mil.nga.geopackage.contents.Contents;
import mil.nga.geopackage.features.columns.GeometryColumns;
import mil.nga.geopackage.tiles.matrixset.TileMatrixSet;
import mil.nga.proj.Projection;
import mil.nga.proj.ProjectionFactory;
import mil.nga.sf.proj.GeometryTransform;
/**
* Spatial Reference System object. The coordinate reference system definitions
* it contains are referenced by the GeoPackage {@link Contents} and
* {@link GeometryColumns} objects to relate the vector and tile data in user
* tables to locations on the earth.
*
* @author osbornb
*/
@DatabaseTable(tableName = "gpkg_spatial_ref_sys", daoClass = SpatialReferenceSystemDao.class)
public class SpatialReferenceSystem {
/**
* Table name
*/
public static final String TABLE_NAME = "gpkg_spatial_ref_sys";
/**
* srsName field name
*/
public static final String COLUMN_SRS_NAME = "srs_name";
/**
* srsId field name
*/
public static final String COLUMN_SRS_ID = "srs_id";
/**
* id field name, srsId
*/
public static final String COLUMN_ID = COLUMN_SRS_ID;
/**
* organization field name
*/
public static final String COLUMN_ORGANIZATION = "organization";
/**
* organizationCoordsysId field name
*/
public static final String COLUMN_ORGANIZATION_COORDSYS_ID = "organization_coordsys_id";
/**
* definition field name
*/
public static final String COLUMN_DEFINITION = "definition";
/**
* description field name
*/
public static final String COLUMN_DESCRIPTION = "description";
/**
* Human readable name of this SRS
*/
@DatabaseField(columnName = COLUMN_SRS_NAME, canBeNull = false)
private String srsName;
/**
* Unique identifier for each Spatial Reference System within a GeoPackage
*/
@DatabaseField(columnName = COLUMN_SRS_ID, id = true, canBeNull = false)
private long srsId;
/**
* Case-insensitive name of the defining organization e.g. EPSG or epsg
*/
@DatabaseField(columnName = COLUMN_ORGANIZATION, canBeNull = false)
private String organization;
/**
* Numeric ID of the Spatial Reference System assigned by the organization
*/
@DatabaseField(columnName = COLUMN_ORGANIZATION_COORDSYS_ID, canBeNull = false)
private long organizationCoordsysId;
/**
* Well-known Text Representation of the Spatial Reference System
*/
@DatabaseField(columnName = COLUMN_DEFINITION, canBeNull = false)
private String definition;
/**
* Human readable description of this SRS
*/
@DatabaseField(columnName = COLUMN_DESCRIPTION)
private String description;
/**
* Well-known Text extension Representation of the Spatial Reference System
*/
private String definition_12_063;
/**
* Coordinate epoch
*/
private Double epoch;
/**
* Contents
*/
@ForeignCollectionField(eager = false)
private ForeignCollection contents;
/**
* Geometry Columns
*/
@ForeignCollectionField(eager = false)
private ForeignCollection geometryColumns;
/**
* Matrix Tile Set
*/
@ForeignCollectionField(eager = false)
private ForeignCollection tileMatrixSet;
/**
* Default Constructor
*/
public SpatialReferenceSystem() {
}
/**
* Copy Constructor
*
* @param srs
* srs to copy
* @since 1.3.0
*/
public SpatialReferenceSystem(SpatialReferenceSystem srs) {
srsName = srs.srsName;
srsId = srs.srsId;
organization = srs.organization;
organizationCoordsysId = srs.organizationCoordsysId;
definition = srs.definition;
description = srs.description;
definition_12_063 = srs.definition_12_063;
epoch = srs.epoch;
}
/**
* Get the id
*
* @return id
*/
public long getId() {
return srsId;
}
/**
* Set the id
*
* @param id
* id
*/
public void setId(long id) {
this.srsId = id;
}
/**
* Get the srs name
*
* @return srs name
*/
public String getSrsName() {
return srsName;
}
/**
* Set the srs name
*
* @param srsName
* srs name
*/
public void setSrsName(String srsName) {
this.srsName = srsName;
}
/**
* Get the srs id
*
* @return srs id
*/
public long getSrsId() {
return srsId;
}
/**
* Set the srs id
*
* @param srsId
* srs id
*/
public void setSrsId(long srsId) {
this.srsId = srsId;
}
/**
* Get the organization
*
* @return organization
*/
public String getOrganization() {
return organization;
}
/**
* Set the organization
*
* @param organization
* organization
*/
public void setOrganization(String organization) {
this.organization = organization;
}
/**
* Get the organization coordsys id
*
* @return organization coordsys id
*/
public long getOrganizationCoordsysId() {
return organizationCoordsysId;
}
/**
* Set the organization coordsys id
*
* @param organizationCoordsysId
* organization coordsys id
*/
public void setOrganizationCoordsysId(long organizationCoordsysId) {
this.organizationCoordsysId = organizationCoordsysId;
}
/**
* Get the definition
*
* @return definition
*/
public String getDefinition() {
return definition;
}
/**
* Set the definition
*
* @param definition
* definition
*/
public void setDefinition(String definition) {
this.definition = definition;
}
/**
* Get the description
*
* @return description
*/
public String getDescription() {
return description;
}
/**
* Set the description
*
* @param description
* description
*/
public void setDescription(String description) {
this.description = description;
}
/**
* Get the 12_063 WKT definition
*
* @return 12_06 3WKT definition
* @since 1.2.1
*/
public String getDefinition_12_063() {
return definition_12_063;
}
/**
* Set the 12_063 WKT definition
*
* @param definition_12_063
* 12_063 WKT definition
* @since 1.2.1
*/
public void setDefinition_12_063(String definition_12_063) {
this.definition_12_063 = definition_12_063;
}
/**
* Get the coordinate epoch
*
* @return coordinate epoch
* @since 6.6.0
*/
public Double getEpoch() {
return epoch;
}
/**
* Set the coordinate epoch
*
* @param epoch
* coordinate epoch
* @since 6.6.0
*/
public void setEpoch(Double epoch) {
this.epoch = epoch;
}
/**
* Get the contents
*
* @return contents
*/
public ForeignCollection getContents() {
return contents;
}
/**
* Get the geometry columns
*
* @return geometry columns
*/
public ForeignCollection getGeometryColumns() {
return geometryColumns;
}
/**
* Get the tile matrix set
*
* @return tile matrix set
*/
public ForeignCollection getTileMatrixSet() {
return tileMatrixSet;
}
/**
* Get the projection for the Spatial Reference System
*
* @return projection
* @since 3.0.0
*/
public Projection getProjection() {
String authority = getOrganization();
long code = getOrganizationCoordsysId();
String definition = getProjectionDefinition();
Projection projection = ProjectionFactory.getProjection(authority, code,
null, definition);
return projection;
}
/**
* Get the projection definition
*
* @return definition
* @since 6.2.0
*/
public String getProjectionDefinition() {
String definition = getDefinition_12_063();
if (definition == null || definition.isBlank() || definition.trim()
.equalsIgnoreCase(GeoPackageConstants.UNDEFINED_DEFINITION)) {
definition = getDefinition();
if (definition != null && (definition.isBlank()
|| definition.trim().equalsIgnoreCase(
GeoPackageConstants.UNDEFINED_DEFINITION))) {
definition = null;
}
}
return definition;
}
/**
* Get the projection transform from the provided projection to the Spatial
* Reference System projection
*
* @param projection
* from projection
* @return projection transform
* @since 3.0.0
*/
public GeometryTransform getTransformation(Projection projection) {
return GeometryTransform.create(projection, getProjection());
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy