Package org.locationtech.jts.io.kml
Class KMLWriter
- java.lang.Object
-
- org.locationtech.jts.io.kml.KMLWriter
-
public class KMLWriter extends java.lang.Object
Writes a formatted string containing the KML representation of a JTSGeometry
. The output is KML fragments which can be substituted wherever the KML Geometry abstract element can be used.Output elements are indented to provide a nicely-formatted representation. An output line prefix and maximum number of coordinates per line can be specified.
The Z ordinate value output can be forced to be a specific value. The
extrude
andaltitudeMode
modes can be set. If set, the corresponding sub-elements will be output.
-
-
Field Summary
Fields Modifier and Type Field Description static java.lang.String
ALTITUDE_MODE_ABSOLUTE
The KML standard valueabsolute
for use insetAltitudeMode(String)
.static java.lang.String
ALTITUDE_MODE_CLAMPTOGROUND
The KML standard valueclampToGround
for use insetAltitudeMode(String)
.static java.lang.String
ALTITUDE_MODE_RELATIVETOGROUND
The KML standard valuerelativeToGround
for use insetAltitudeMode(String)
.
-
Constructor Summary
Constructors Constructor Description KMLWriter()
Creates a new writer.
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description void
setAltitudeMode(java.lang.String altitudeMode)
Sets the value output in thealtitudeMode
element.void
setExtrude(boolean extrude)
Sets the flag to be output in theextrude
element.void
setLinePrefix(java.lang.String linePrefix)
Sets a tag string which is prefixed to every emitted text line.void
setMaximumCoordinatesPerLine(int maxCoordinatesPerLine)
Sets the maximum number of coordinates to output per line.void
setPrecision(int precision)
Sets the maximum number of decimal places to output in ordinate values.void
setTesselate(boolean tesselate)
Sets the flag to be output in thetesselate
element.void
setZ(double zVal)
Sets the Z value to be output for all coordinates.java.lang.String
write(Geometry geom)
Writes aGeometry
in KML format as a string.void
write(Geometry geometry, java.io.Writer writer)
Writes the KML representation of aGeometry
to aWriter
.void
write(Geometry geometry, java.lang.StringBuffer buf)
Appends the KML representation of aGeometry
to aStringBuffer
.static java.lang.String
writeGeometry(Geometry geometry, double z)
Writes a Geometry as KML to a string, using a specified Z value.static java.lang.String
writeGeometry(Geometry geometry, double z, int precision, boolean extrude, java.lang.String altitudeMode)
Writes a Geometry as KML to a string, using a specified Z value, precision, extrude flag, and altitude mode code.
-
-
-
Field Detail
-
ALTITUDE_MODE_CLAMPTOGROUND
public static java.lang.String ALTITUDE_MODE_CLAMPTOGROUND
The KML standard valueclampToGround
for use insetAltitudeMode(String)
.
-
ALTITUDE_MODE_RELATIVETOGROUND
public static java.lang.String ALTITUDE_MODE_RELATIVETOGROUND
The KML standard valuerelativeToGround
for use insetAltitudeMode(String)
.
-
ALTITUDE_MODE_ABSOLUTE
public static java.lang.String ALTITUDE_MODE_ABSOLUTE
The KML standard valueabsolute
for use insetAltitudeMode(String)
.
-
-
Method Detail
-
writeGeometry
public static java.lang.String writeGeometry(Geometry geometry, double z)
Writes a Geometry as KML to a string, using a specified Z value.- Parameters:
geometry
- the geometry to writez
- the Z value to use- Returns:
- a string containing the KML geometry representation
-
writeGeometry
public static java.lang.String writeGeometry(Geometry geometry, double z, int precision, boolean extrude, java.lang.String altitudeMode)
Writes a Geometry as KML to a string, using a specified Z value, precision, extrude flag, and altitude mode code.- Parameters:
geometry
- the geometry to writez
- the Z value to useprecision
- the maximum number of decimal places to writeextrude
- the extrude flag to writealtitudeMode
- the altitude model code to write- Returns:
- a string containing the KML geometry representation
-
setLinePrefix
public void setLinePrefix(java.lang.String linePrefix)
Sets a tag string which is prefixed to every emitted text line. This can be used to indent the geometry text in a containing document.- Parameters:
linePrefix
- the tag string
-
setMaximumCoordinatesPerLine
public void setMaximumCoordinatesPerLine(int maxCoordinatesPerLine)
Sets the maximum number of coordinates to output per line.- Parameters:
maxCoordinatesPerLine
- the maximum number of coordinates to output
-
setZ
public void setZ(double zVal)
Sets the Z value to be output for all coordinates. This overrides any Z value present in the Geometry coordinates.- Parameters:
zVal
- the Z value to output
-
setExtrude
public void setExtrude(boolean extrude)
Sets the flag to be output in theextrude
element.- Parameters:
extrude
- the extrude flag to output
-
setTesselate
public void setTesselate(boolean tesselate)
Sets the flag to be output in thetesselate
element.- Parameters:
tesselate
- the tesselate flag to output
-
setAltitudeMode
public void setAltitudeMode(java.lang.String altitudeMode)
Sets the value output in thealtitudeMode
element.- Parameters:
altitudeMode
- string representing the altitude mode
-
setPrecision
public void setPrecision(int precision)
Sets the maximum number of decimal places to output in ordinate values. Useful for limiting output size.- Parameters:
precision
- the number of decimal places to output
-
write
public java.lang.String write(Geometry geom)
Writes aGeometry
in KML format as a string.- Parameters:
geom
- the geometry to write- Returns:
- a string containing the KML geometry representation
-
write
public void write(Geometry geometry, java.io.Writer writer) throws java.io.IOException
Writes the KML representation of aGeometry
to aWriter
.- Parameters:
geometry
- the geometry to writewriter
- the Writer to write to- Throws:
java.io.IOException
- if an I/O error occurred
-
-