de.micromata.opengis.kml.v_2_2_0
Class LineString

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.LineString

All Implemented Interfaces:

java.lang.Cloneable

public class LineString
extends Geometry
implements java.lang.Cloneable

Defines a connected set of line segments. Use to specify the color, color mode, and width of the line. When a LineString is extruded, the line is extended to the ground, forming a polygon that looks somewhat like a wall or fence. For extruded LineStrings, the line itself uses the current LineStyle, and the extrusion uses the current PolyStyle. See the KML Tutorial for examples of LineStrings (or paths).

Syntax:

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

Extends:

Field Summary

protected AltitudeMode	altitudeMode AltitudeMode
protected java.util.List<Coordinate>	coordinates (required)
protected java.lang.Boolean	extrude
protected java.util.List<AbstractObject>	lineStringObjectExtension
protected java.util.List<java.lang.Object>	lineStringSimpleExtension
protected java.lang.Boolean	tessellate

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

LineString()

Method Summary

LineString	addToCoordinates(double longitude, double latitude) add a value to the coordinates property collection
LineString	addToCoordinates(double longitude, double latitude, double altitude) add a value to the coordinates property collection
LineString	addToCoordinates(java.lang.String coordinates) add a value to the coordinates property collection
LineString	addToGeometryObjectExtension(AbstractObject geometryObjectExtension) add a value to the geometryObjectExtension property collection
LineString	addToGeometrySimpleExtension(java.lang.Object geometrySimpleExtension) add a value to the geometrySimpleExtension property collection
LineString	addToLineStringObjectExtension(AbstractObject lineStringObjectExtension) add a value to the lineStringObjectExtension property collection
LineString	addToLineStringSimpleExtension(java.lang.Object lineStringSimpleExtension) add a value to the lineStringSimpleExtension property collection
LineString	addToObjectSimpleExtension(java.lang.Object objectSimpleExtension) add a value to the objectSimpleExtension property collection
LineString	clone()
java.util.List<Coordinate>	createAndSetCoordinates() Creates a new instance of List<Coordinate and set it to this.coordinates.
boolean	equals(java.lang.Object obj)
AltitudeMode	getAltitudeMode()
java.util.List<Coordinate>	getCoordinates()
java.util.List<AbstractObject>	getLineStringObjectExtension()
java.util.List<java.lang.Object>	getLineStringSimpleExtension()
int	hashCode()
java.lang.Boolean	isExtrude()
java.lang.Boolean	isTessellate()
void	setAltitudeMode(AltitudeMode value)
void	setCoordinates(java.util.List<Coordinate> coordinates)
void	setExtrude(java.lang.Boolean value)
void	setGeometryObjectExtension(java.util.List<AbstractObject> geometryObjectExtension)
void	setGeometrySimpleExtension(java.util.List<java.lang.Object> geometrySimpleExtension)
void	setLineStringObjectExtension(java.util.List<AbstractObject> lineStringObjectExtension)
void	setLineStringSimpleExtension(java.util.List<java.lang.Object> lineStringSimpleExtension)
void	setObjectSimpleExtension(java.util.List<java.lang.Object> objectSimpleExtension)
void	setTessellate(java.lang.Boolean value)
LineString	withAltitudeMode(AltitudeMode altitudeMode) fluent setter
LineString	withCoordinates(java.util.List<Coordinate> coordinates) fluent setter
LineString	withExtrude(java.lang.Boolean extrude) fluent setter
LineString	withGeometryObjectExtension(java.util.List<AbstractObject> geometryObjectExtension) fluent setter
LineString	withGeometrySimpleExtension(java.util.List<java.lang.Object> geometrySimpleExtension) fluent setter
LineString	withId(java.lang.String id) fluent setter
LineString	withLineStringObjectExtension(java.util.List<AbstractObject> lineStringObjectExtension) fluent setter
LineString	withLineStringSimpleExtension(java.util.List<java.lang.Object> lineStringSimpleExtension) fluent setter
LineString	withObjectSimpleExtension(java.util.List<java.lang.Object> objectSimpleExtension) fluent setter
LineString	withTargetId(java.lang.String targetId) fluent setter
LineString	withTessellate(java.lang.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 java.lang.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 java.lang.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 java.util.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.

lineStringSimpleExtension

protected java.util.List<java.lang.Object> lineStringSimpleExtension

lineStringObjectExtension

protected java.util.List<AbstractObject> lineStringObjectExtension