# Package org.apache.sis.referencing.gazetteer

package org.apache.sis.referencing.gazetteer
Mapping between geographic identifiers (addresses, grid indexes…) and locations (descriptions, coordinates…). This package provides base classes implementing the Spatial referencing by geographic identifiers (ISO 19112) standard. Those base classes are `AbstractLocation`, `ModifiableLocationType` and `ReferencingByIdentifiers`, completed by the `LocationFormat` utility class.

This package provides also implementations on top of above base classes. Some implementation classes are `MilitaryGridReferenceSystem` (also for civilian use) and `GeohashReferenceSystem`.

Since:
  0.8

- Related Packages
  Module
  Package
  Description
  org.apache.sis.referencing
  org.apache.sis.referencing
  Base classes for reference systems used for general positioning.
  org.apache.sis.referencing
  org.apache.sis.referencing.crs
  Coordinate Reference System (CRS) definitions as coordinate systems related to the earth through datum.
  org.apache.sis.referencing
  org.apache.sis.referencing.cs
  Coordinate System (CS) definitions as the set of coordinate system axes that spans the coordinate space.
  org.apache.sis.referencing
  org.apache.sis.referencing.datum
  Relationship of a `CoordinateSystem` (an abstract mathematical entity) to the earth or other system.
  org.apache.sis.referencing
  org.apache.sis.referencing.factory
  Creates Coordinate Reference System (CRS) objects from given properties or authority codes.
  org.apache.sis.referencing
  org.apache.sis.referencing.operation
  Relationship between any two Coordinate Reference Systems (CRS).
- Class
  Description
  AbstractLocation
  Identifiable geographic place.
  GazetteerException
  Thrown when a coordinate cannot be converted to a geographic identifier, or conversely.
  GazetteerFactory
  A factory of reference systems by identifiers implemented by the SIS library.
  GeohashReferenceSystem
  Geographic coordinates represented as geohashes strings.
  GeohashReferenceSystem.Format
  The encoding format used by `GeohashReferenceSystem​.Coder`.
  LocationFormat
  Formats `Location` instances in a tabular format.
  MilitaryGridReferenceSystem
  The Military Grid Reference System (MGRS).
  ModifiableLocationType
  Helper class for building the description of a location.
  ReferenceVerifyException
  Thrown when a geographic identifier (or reference) has been successfully parsed but fails some verification.
  ReferencingByIdentifiers
  Base class of reference systems that describe locations using geographic identifiers instead of coordinates.
  ReferencingByIdentifiers.Coder
  Conversions between direct positions and identifiers.