de.micromata.opengis.kml.v_2_2_0

Class LinearRing

java.lang.Object

de.micromata.opengis.kml.v_2_2_0.AbstractObject

de.micromata.opengis.kml.v_2_2_0.Geometry

de.micromata.opengis.kml.v_2_2_0.LinearRing

All Implemented Interfaces:

Cloneable

public class LinearRing
extends Geometry
implements Cloneable

Defines a closed line string, typically the outer boundary of a Polygon. Optionally, a LinearRing can also be used as the inner boundary of a Polygon to create holes in the Polygon. A Polygon can contain multiple elements used as inner boundaries.

Note: In Google Earth, a Polygon with an of clampToGround follows the great circle; however, a LinearRing (by itself) with an of clampToGround follows lines of constant latitude.

Syntax:

<LinearRing id="ID">
   <!-- specific to LinearRing -->
   <extrude>0</extrude>                       <!-- boolean -->
   <tessellate>0</tessellate>                 <!-- boolean -->
   <altitudeMode>clampToGround</altitudeMode> 
     <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
     <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
   <coordinates>...</coordinates>             <!-- lon,lat[,alt] tuples --> 
 </LinearRing>

Extends:

Field Summary

Fields

Modifier and Type	Field and Description
protected AltitudeMode	altitudeMode AltitudeMode clampToGround, relativeToGround, absolute See Also: See and
protected List<Coordinate>	coordinates (required) A single tuple consisting of floating point values for longitude, latitude, and altitude (in that order).
protected Boolean	extrude Boolean value.
protected List<AbstractObject>	linearRingObjectExtension
protected List<Object>	linearRingSimpleExtension
protected Boolean	tessellate Boolean value.

Fields inherited from class de.micromata.opengis.kml.v_2_2_0.Geometry

geometryObjectExtension, geometrySimpleExtension

Fields inherited from class de.micromata.opengis.kml.v_2_2_0.AbstractObject

id, objectSimpleExtension, targetId

Constructor Summary

Constructors

Constructor and Description
LinearRing()

Method Summary

Methods

Modifier and Type	Method and Description
LinearRing	addToCoordinates(double longitude, double latitude) add a value to the coordinates property collection
LinearRing	addToCoordinates(double longitude, double latitude, double altitude) add a value to the coordinates property collection
LinearRing	addToCoordinates(String coordinates) add a value to the coordinates property collection
LinearRing	addToGeometryObjectExtension(AbstractObject geometryObjectExtension) add a value to the geometryObjectExtension property collection
LinearRing	addToGeometrySimpleExtension(Object geometrySimpleExtension) add a value to the geometrySimpleExtension property collection
LinearRing	addToLinearRingObjectExtension(AbstractObject linearRingObjectExtension) add a value to the linearRingObjectExtension property collection
LinearRing	addToLinearRingSimpleExtension(Object linearRingSimpleExtension) add a value to the linearRingSimpleExtension property collection
LinearRing	addToObjectSimpleExtension(Object objectSimpleExtension) add a value to the objectSimpleExtension property collection
LinearRing	clone()
List<Coordinate>	createAndSetCoordinates() Creates a new instance of List<Coordinate and set it to this.coordinates.
boolean	equals(Object obj)
AltitudeMode	getAltitudeMode()
List<Coordinate>	getCoordinates()
List<AbstractObject>	getLinearRingObjectExtension()
List<Object>	getLinearRingSimpleExtension()
int	hashCode()
Boolean	isExtrude()
Boolean	isTessellate()
void	setAltitudeMode(AltitudeMode value)
void	setCoordinates(List<Coordinate> coordinates)
void	setExtrude(Boolean value)
void	setGeometryObjectExtension(List<AbstractObject> geometryObjectExtension)
void	setGeometrySimpleExtension(List<Object> geometrySimpleExtension)
void	setLinearRingObjectExtension(List<AbstractObject> linearRingObjectExtension)
void	setLinearRingSimpleExtension(List<Object> linearRingSimpleExtension)
void	setObjectSimpleExtension(List<Object> objectSimpleExtension)
void	setTessellate(Boolean value)
LinearRing	withAltitudeMode(AltitudeMode altitudeMode) fluent setter
LinearRing	withCoordinates(List<Coordinate> coordinates) fluent setter
LinearRing	withExtrude(Boolean extrude) fluent setter
LinearRing	withGeometryObjectExtension(List<AbstractObject> geometryObjectExtension) fluent setter
LinearRing	withGeometrySimpleExtension(List<Object> geometrySimpleExtension) fluent setter
LinearRing	withId(String id) fluent setter
LinearRing	withLinearRingObjectExtension(List<AbstractObject> linearRingObjectExtension) fluent setter
LinearRing	withLinearRingSimpleExtension(List<Object> linearRingSimpleExtension) fluent setter
LinearRing	withObjectSimpleExtension(List<Object> objectSimpleExtension) fluent setter
LinearRing	withTargetId(String targetId) fluent setter
LinearRing	withTessellate(Boolean tessellate) fluent setter

Methods inherited from class de.micromata.opengis.kml.v_2_2_0.Geometry

getGeometryObjectExtension, getGeometrySimpleExtension

Methods inherited from class de.micromata.opengis.kml.v_2_2_0.AbstractObject

getId, getObjectSimpleExtension, getTargetId, setId, setTargetId

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

extrude

protected Boolean extrude

Boolean value. Specifies whether to connect the LineString to the ground. To extrude a LineString, the altitude mode must be either relativeToGround, relativeToSeaFloor, or absolute. The vertices in the LineString are extruded toward the center of the Earth's sphere.

Boolean value. Specifies whether to connect the LinearRing to the ground. To extrude this geometry, the altitude mode must be either relativeToGround, relativeToSeaFloor, or absolute. Only the vertices of the LinearRing are extruded, not the center of the geometry. The vertices are extruded toward the center of the Earth's sphere.

Boolean value. Specifies whether to connect the Polygon to the ground. To extrude a Polygon, the altitude mode must be either relativeToGround, relativeToSeaFloor, or absolute. Only the vertices are extruded, not the geometry itself (for example, a rectangle turns into a box with five faces. The vertices of the Polygon are extruded toward the center of the Earth's sphere.

Boolean value. Specifies whether to connect the point to the ground with a line. To extrude a Point, the value for must be either relativeToGround, relativeToSeaFloor, or absolute. The point is extruded toward the center of the Earth's sphere.

tessellate

protected Boolean tessellate

Boolean value. Specifies whether to allow the LineString to follow the terrain. To enable tessellation, the altitude mode must be clampToGround or clampToSeaFloor. Very large LineStrings should enable tessellation so that they follow the curvature of the earth (otherwise, they may go underground and be hidden).

Boolean value. Specifies whether to allow the LinearRing to follow the terrain. To enable tessellation, the value for must be clampToGround or clampToSeaFloor. Very large LinearRings should enable tessellation so that they follow the curvature of the earth (otherwise, they may go underground and be hidden).

Boolean value. Specifies whether to allow the Polygon to follow the terrain. To enable tessellation, the Polygon must have an altitude mode of clampToGround or clampToSeaFloor. Very large Polygons should enable tessellation so that they follow the curvature of the earth (otherwise, they may go underground and be hidden).

altitudeMode

protected AltitudeMode altitudeMode

AltitudeMode

clampToGround, relativeToGround, absolute

See Also: See and

coordinates

protected List<Coordinate> coordinates

(required)

A single tuple consisting of floating point values for longitude, latitude, and altitude (in that order). Longitude and latitude values are in degrees, where longitude ≥ −180 and <= 180 latitude ≥ −90 and ≤ 90 altitude values (optional) are in meters above sea level

Do not include spaces between the three values that describe a coordinate.

Two or more coordinate tuples, each consisting of floating point values for longitude, latitude, and altitude. The altitude component is optional. Insert a space between tuples. Do not include spaces within a tuple.

linearRingSimpleExtension

protected List<Object> linearRingSimpleExtension

linearRingObjectExtension

protected List<AbstractObject> linearRingObjectExtension