Package org.apache.sis.io.wkt
package org.apache.sis.io.wkt
Well Known Text (WKT) parsing and formatting.
This package implements the services provided by various convenience methods:
CRS.fromWKT(String)
(SIS parsing static method)CRSFactory.createFromWKT(String)
(GeoAPI parsing method)MathTransformFactory.createFromWKT(String)
(GeoAPI parsing method)IdentifiedObject.toWKT()
(GeoAPI formatting method)
WKTFormat
class provided in this package gives more control.
For example, this package allows to:
- Format projection and parameters using the names of a chosen authority.
For example, the "Mercator (variant A)" projection is named
"Mercator_1SP"
by OGC 01-009 and"CT_Mercator"
by GeoTIFF. - Format the elements with different quote characters or brackets style.
For example, both
ID["EPSG",4326]
andID("EPSG",4326)
are legal WKT. - Format with a different indentation or format the whole WKT on a single line.
- Apply syntactic coloring on terminal supporting ANSI escape codes (a.k.a. ECMA-48, ISO/IEC 6429 and X3.64).
- Alter the parsing in a way compatible with non-standard (but commonly used) WKT.
For example, some others software products ignore the
AXIS[…]
elements at parsing time. - Report warnings that occurred during parsing or formatting.
Referencing WKT
Referencing WKT is defined using Extended Backus Naur Form (EBNF) in two versions:- ISO 19162 defines the current format, also known as “WKT 2”. The specification is also made available online by OGC.
- The previous format — “WKT 1” — was defined in the OGC document 01-009. This definition is shown on GeoAPI.
Convention
enumeration.
Geometry WKT
TheGeneralEnvelope
and GeneralDirectPosition
classes
provide their own, limited, WKT parsing and formatting services for the BOX
and POINT
elements.
A description for this WKT format can be found on
Wikipedia.
Where to find WKT examples
An excellent source of well-formed WKT is the online EPSG Geodetic Parameter Registry. The WKT of many Coordinate Reference System object can be viewed using the pattern below (replace3395
by the EPSG code of the desired CRS):
Example: "WGS 84 / World Mercator": https://epsg.org/crs/wkt/id/3395Readers should be aware that some popular other sources of WKT are actually invalid, since many of them do not comply with EPSG definitions (especially on axis order). The above-cited EPSG repository is the authoritative source of CRS definitions in the EPSG namespace.
- Since:
- 0.4
- Version:
- 1.3
- See Also:
-
ClassDescriptionParses Well Known Text (WKT).The colors to use for formatting Well Known Text (WKT) objects.The convention to use for WKT formatting.An element in a Well Know Text (WKT).Kind of an element in a Well Known Text.Base class for objects that can be formatted as Well Known Text (WKT).Provides support methods for formatting a Well Known Text (WKT).Well Known Text (WKT) parser for referencing objects.Whether WKT keywords shall be written with lower, upper or camel case styles.Whether to use short or long WKT keywords.Well Known Text (WKT) parser for math transforms.A parser or a factory capable to create an object from a string in the WKT format.A mutable set containing either
null
or a single element.A tree ofElement
s saved for later use.A helper class for compressing a tree ofElement
s as a tree ofStoredTree.Node
s.A helper class for decompressing a tree ofElement
s from a tree ofStoredTree.Node
s.Unmodifiable copy ofElement
without contextual information such asElement.offset
.The set of symbols to use for Well Known Text (WKT) parsing and formatting.Controls the replacement of characters, abbreviations and names between the objects in memory and their WKT representations.TheTransliterator.DEFAULT
implementation.TheTransliterator.IDENTITY
implementation.Thrown byFormattableObject.toWKT()
when an object cannot be formatted as WKT.Thrown when a Well Known Text (WKT) cannot be parsed.Stores temporary information needed for completing the construction of anDefaultVerticalExtent
instance.Warnings that occurred during a Well Known Text (WKT) parsing or formatting.A factory providing CRS objects parsed from WKT definitions associated to authority codes.A special kind of value used in theWKTDictionary.definitions
map when the same code is used by more than one authority and version.Parser and formatter for Well Known Text (WKT) strings.