# 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

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

- Related Packages
  Package
  Description
  org.apache.sis.referencing
  Base classes for reference systems used for general positioning.
  org.apache.sis.referencing.crs
  Coordinate Reference System (CRS) definitions as coordinate systems related to the earth through datum.
  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.datum
  Relationship of a `CoordinateSystem` (an abstract mathematical entity) to the earth or other system.
  org.apache.sis.referencing.factory
  Creates Coordinate Reference System (CRS) objects from given properties or authority codes.
  org.apache.sis.referencing.operation
  Relationship between any two Coordinate Reference Systems (CRS).
- Class
  Description
  AbstractLocation
  Identifiable geographic place.
  GazetteerException
  Thrown when a coordinate can not be converted to a geographic identifier, or conversely.
  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.