Class GeohashReferenceSystem
Object
FormattableObject
AbstractIdentifiedObject
AbstractReferenceSystem
ReferencingByIdentifiers
GeohashReferenceSystem
- All Implemented Interfaces:
Serializable,Formattable,Deprecable,LenientComparable,IdentifiedObject,ReferenceSystem
Geographic coordinates represented as geohashes strings.
Geohash is a simple encoding of geographic coordinates into a short string of letters and digits.
Longer strings are more accurate, however the accuracy is not uniformly distributed between latitude
and longitude, and removing digits decreases accuracy faster when the point is located close to the
equator than close to a pole. For a system having more uniform accuracy, see the
Military Grid Reference System (MGRS).
- Since:
- 0.8
- See Also:
Defined in the sis-referencing-by-identifiers module
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionclassConversions between direct positions and geohashes.static enumThe encoding format used byGeohashReferenceSystem.Coder. -
Field Summary
Fields inherited from class ReferencingByIdentifiers
OVERALL_OWNER_KEY, THEME_KEYFields inherited from class AbstractIdentifiedObject
DEPRECATED_KEY, LOCALE_KEYFields inherited from interface IdentifiedObject
ALIAS_KEY, IDENTIFIERS_KEY, NAME_KEY, REMARKS_KEYFields inherited from interface ReferenceSystem
DOMAIN_OF_VALIDITY_KEY, SCOPE_KEY -
Constructor Summary
ConstructorsConstructorDescriptionCreates a new geohash reference system for the given format and coordinate reference system. -
Method Summary
Modifier and TypeMethodDescriptionReturns a new object performing conversions betweenDirectPositionand geohashes.Returns the encoding/decoding format.Methods inherited from class ReferencingByIdentifiers
computeHashCode, equals, formatTo, getLocationTypes, getOverallOwner, getThemeMethods inherited from class AbstractReferenceSystem
getDomainOfValidity, getInterface, getScopeMethods inherited from class AbstractIdentifiedObject
castOrCopy, equals, formatTo, getAlias, getDescription, getIdentifiers, getName, getRemarks, hashCode, isDeprecated, isHeuristicMatchForNameMethods inherited from class FormattableObject
print, toString, toString, toWKTMethods inherited from class Object
clone, finalize, getClass, notify, notifyAll, wait, wait, waitMethods inherited from interface IdentifiedObject
getAlias, getIdentifiers, getName, getRemarks, toWKT
-
Constructor Details
-
GeohashReferenceSystem
public GeohashReferenceSystem(GeohashReferenceSystem.Format format, GeographicCRS crs) throws GazetteerException Creates a new geohash reference system for the given format and coordinate reference system.- Parameters:
format- the format used by theGeohashReferenceSystem.Coder.crs- the coordinate reference system. This is usuallyCommonCRS.defaultGeographic().- Throws:
GazetteerException- if the reference system cannot be created.
-
-
Method Details
-
getFormat
Returns the encoding/decoding format.- Returns:
- the encoding/decoding format.
-
createCoder
Returns a new object performing conversions betweenDirectPositionand geohashes. The returned object is not thread-safe; a new instance must be created for each thread, or synchronization must be applied by the caller.- Specified by:
createCoderin classReferencingByIdentifiers- Returns:
- a new object performing conversions between
DirectPositionand geohashes.
-