org.opengis.cite.kml2.validation

Class GeoExtentValidator

java.lang.Object

org.opengis.cite.kml2.validation.GeoExtentValidator

public class GeoExtentValidator
extends Object

Validates the content of an element that represents a geographic extent (that is, it substitutes directly or indirectly for kml:AbstractExtentGroup). The allowed elements include the following, although not all are permitted in every context:

• kml:LatLonBox
• kml:LatLonAltBox
• kml:LatLonQuad

Constructor Summary

Constructors

Constructor and Description
GeoExtentValidator() Constructor with default error handler.

Method Summary

Modifier and Type	Method and Description
String	getErrorMessages() Returns the error messages reported during the last validation episode.
Iterator<org.opengis.cite.validation.ValidationError>	getErrors() Returns the errors reported during the last validation episode.
(package private) Map<String,Double>	getNumericProperties(Node node, Map<String,Double> defaults) Builds a Map containing the numeric values conveyed by the child elements of the given node.
void	reset() Resets the error handler.
(package private) boolean	validateBox(Node boxNode) Validates a bounding box.
boolean	validateQuadrilateral(Node latlonQuad) Checks that a kml:LatLonQuad element has valid coordinates and satisfies the following additional constraints: the four coordinate tuples are specified in counter-clockwise order (the interior is to the left of the boundary curve), with the first coordinate corresponding to the lower-left corner of the overlayed image; the quadrilateral is convex (every interior angle <= 180 degrees).
boolean	validGeoExtent(Node node)

Methods inherited from class java.lang.Object

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

Constructor Detail

GeoExtentValidator

public GeoExtentValidator()

Constructor with default error handler.

Method Detail

getErrorMessages

public String getErrorMessages()

Returns the error messages reported during the last validation episode.

Returns:

A String containing error messages (may be empty).

getErrors

public Iterator<org.opengis.cite.validation.ValidationError> getErrors()

Returns the errors reported during the last validation episode.

Returns:

An iterator over the reported validation errors.

reset

public void reset()

Resets the error handler.

validGeoExtent

public boolean validGeoExtent(Node node)

validateQuadrilateral

public boolean validateQuadrilateral(Node latlonQuad)

Checks that a kml:LatLonQuad element has valid coordinates and satisfies the following additional constraints:

1. the four coordinate tuples are specified in counter-clockwise order (the interior is to the left of the boundary curve), with the first coordinate corresponding to the lower-left corner of the overlayed image;
2. the quadrilateral is convex (every interior angle <= 180 degrees).

Parameters:

latlonQuad - A kml:LatLonQuad element.

Returns:

true if all constraints are satisfied; false otherwise.

See Also:

"ATC-103: Valid geometry coordinates", "ATC-149: LatLonQuad coordinates"

validateBox

boolean validateBox(Node boxNode)

Validates a bounding box. The content of a kml:LatLon[Alt]Box element must satisfy all of the following constraints:

1. kml:north > kml:south;
2. kml:east > kml:west;
3. kml:minAltitude <= kml:maxAltitude;
4. if kml:minAltitude and kml:maxAltitude are both present, then kml:altitudeMode does not have the value "clampToGround".

Some additional constraints were introduced in KML 2.3 with the longitude range extension (to ± 360):

• kml:east - kml:west <= 360 (non-self-overlap)
• if |kml:west| > 180 or |kml:east| > 180, then kml:east > 0 and kml:west < 180 (uniqueness)

Parameters:

boxNode - An Element node that contains a bounding box element (kml:LatLon[Alt]Box).

Returns:

true if the box satisfies all constraints; false otherwise.

getNumericProperties

Map<String,Double> getNumericProperties(Node node,
                                        Map<String,Double> defaults)

Builds a Map containing the numeric values conveyed by the child elements of the given node. The keys are the local names of the elements that contain a parsable number (double).

Parameters:

node - A node expected to contain child elements.

defaults - A collection of default values.

Returns:

A Map containing numeric values.