# 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

Defined in the `sis-referencing-by-identifiers` module

- Class Summary
  Class | Description
  --- | ---
  AbstractLocation | Identifiable geographic place.
  GeohashReferenceSystem | Geographic coordinates represented as geohashes strings.
  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.
  ReferencingByIdentifiers | Base class of reference systems that describe locations using geographic identifiers instead than coordinates.

- Enum Summary
  Enum | Description
  --- | ---
  GeohashReferenceSystem.Format | The encoding format used by `GeohashReferenceSystem​.Coder`.

- Exception Summary
  Exception | Description
  --- | ---
  GazetteerException | Thrown when a coordinate can not be converted to a geographic identifier, or conversely.
  ReferenceVerifyException | Thrown when a geographic identifier (or reference) has been successfully parsed but fails some verification.