org.opengis.cite.kml22.util

Class KmlGeometryUnmarshaller

java.lang.Object

org.opengis.cite.kml22.util.KmlGeometryUnmarshaller

public class KmlGeometryUnmarshaller
extends Object

Unmarshals KML 2.x geometry representations (except <Model>) from DOM sources to JTS Geometry objects. The following geometry elements are supported: Point, LineString, LinearRing, Polygon, and MultiGeometry.

Constructor Summary

Constructors

Constructor and Description
KmlGeometryUnmarshaller() Creates an unmarshaller for KML 2.2 geometry elements.
KmlGeometryUnmarshaller(String namespaceURI) Constructs an unmarshaller for KML geometry elements in the given target namespace.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) CoordinateArraySequence	buildCoordinateArraySequence(Node coords) Builds a raw coordinate sequence from the tuples included in a given coordinates element.
Geometry	unmarshalKmlGeometry(Node node) Creates a JTS geometry object from a KML 2.x geometry representation.
(package private) LinearRing	unmarshalLinearRing(Element geoElem) Creates a LinearRing geometry object from a source KML2 LinearRing representation.
(package private) LineString	unmarshalLineString(Element geoElem) Creates a LineString object from a KML2 LineString representation.
(package private) GeometryCollection	unmarshalMultiGeometry(Element geoElem) Creates a GeometryCollection geometry object from a source KML2 MultiGeometry representation with one or more geometry members.
(package private) Point	unmarshalPoint(Element geoElem) Creates a Point geometry object from a source KML2 Point representation.
(package private) Polygon	unmarshalPolygon(Element geoElem) Creates a Polygon geometry object from a source KML2 Polygon representation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

KmlGeometryUnmarshaller

public KmlGeometryUnmarshaller()

Creates an unmarshaller for KML 2.2 geometry elements.

KmlGeometryUnmarshaller

public KmlGeometryUnmarshaller(String namespaceURI)

Constructs an unmarshaller for KML geometry elements in the given target namespace.

Parameters:

namespaceURI - The name of the target namespace (an absolute URI value).

Method Detail

unmarshalKmlGeometry

public Geometry unmarshalKmlGeometry(Node node)

Creates a JTS geometry object from a KML 2.x geometry representation. The provided node must be either an Element or a Document node; if the latter, the geometry must be the document element.

Parameters:

node - a DOM Document or Element node representation of a KML 2 geometry element.

Returns:

the corresponding JTS Geometry object.

unmarshalPoint

Point unmarshalPoint(Element geoElem)

Creates a Point geometry object from a source KML2 Point representation. The ID of the spatial reference system is set to 0 (undefined).

Parameters:

geoElem - A DOM Element representing a kml:Point element.

Returns:

the corresponding JTS Point object

unmarshalLineString

LineString unmarshalLineString(Element geoElem)

Creates a LineString object from a KML2 LineString representation. The ID of the spatial reference system is set to 0 (undefined).

Parameters:

geoElem - a DOM Element representing a gml:LineString element.

Returns:

the corresponding JTS LineString object

unmarshalLinearRing

LinearRing unmarshalLinearRing(Element geoElem)

Creates a LinearRing geometry object from a source KML2 LinearRing representation. The ID of the spatial reference system is set to 0 (undefined).

Parameters:

geoElem - a DOM Element representing a kml:LinearRing element.

Returns:

the corresponding JTS LinearRing object

unmarshalPolygon

Polygon unmarshalPolygon(Element geoElem)

Creates a Polygon geometry object from a source KML2 Polygon representation. The ID of the spatial reference system is set to 0 (undefined).

Parameters:

geoElem - a DOM Element representing a kml:Polygon element.

Returns:

the corresponding JTS Polygon object.

unmarshalMultiGeometry

GeometryCollection unmarshalMultiGeometry(Element geoElem)

Creates a GeometryCollection geometry object from a source KML2 MultiGeometry representation with one or more geometry members.

Parameters:

geoElem - a DOM Element representing a kml:MultiGeometry element.

Returns:

the corresponding JTS GeometryCollection object

buildCoordinateArraySequence

CoordinateArraySequence buildCoordinateArraySequence(Node coords)

Builds a raw coordinate sequence from the tuples included in a given coordinates element. According to the KML reference, coordinates must be specified as a space-separated list of 2D or 3D tuples: lon,lat[,alt]. An IllegalArgumentException is thrown if a coordinate tuple is is not 2D or 3D.

Parameters:

coords - a DOM Node representing a kml:coordinates element

Returns:

a CoordinateArraySequence that can be used to create primitive geometry objects