Package org.elasticsearch.common.geo.builders

Class PolygonBuilder

java.lang.Object

org.elasticsearch.common.geo.builders.ShapeBuilder<JtsGeometry,Geometry,PolygonBuilder>

org.elasticsearch.common.geo.builders.PolygonBuilder

All Implemented Interfaces:

NamedWriteable, Writeable, ToXContent, ToXContentObject

public class PolygonBuilder
extends ShapeBuilder<JtsGeometry,Geometry,PolygonBuilder>

The PolygonBuilder implements the groundwork to create polygons. This contains Methods to wrap polygons at the dateline and building shapes from the data held by the builder.

Nested Class Summary

Nested classes/interfaces inherited from class org.elasticsearch.common.geo.builders.ShapeBuilder

ShapeBuilder.Edge, ShapeBuilder.Orientation

Nested classes/interfaces inherited from interface org.elasticsearch.common.xcontent.ToXContent

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

Nested classes/interfaces inherited from interface org.elasticsearch.common.io.stream.Writeable

Writeable.Reader<V>, Writeable.Writer<V>

Field Summary

Fields

Modifier and Type	Field	Description
static GeoShapeType	TYPE

Fields inherited from class org.elasticsearch.common.geo.builders.ShapeBuilder

AUTO_INDEX_JTS_GEOMETRY, AUTO_VALIDATE_JTS_GEOMETRY, coordinates, DATELINE, FACTORY, INTERSECTION_ORDER, LOGGER, MULTI_POLYGON_MAY_OVERLAP, SPATIAL_CONTEXT, wrapdateline, ZERO_ZERO

Fields inherited from interface org.elasticsearch.common.xcontent.ToXContent

EMPTY_PARAMS

Constructor Summary

Constructors

Constructor	Description
PolygonBuilder(CoordinatesBuilder coordinates)
PolygonBuilder(CoordinatesBuilder coordinates, ShapeBuilder.Orientation orientation)
PolygonBuilder(LineStringBuilder lineString, ShapeBuilder.Orientation orientation)
PolygonBuilder(LineStringBuilder lineString, ShapeBuilder.Orientation orientation, boolean coerce)
PolygonBuilder(StreamInput in)	Read from a stream.

Method Summary

Modifier and Type	Method	Description
Geometry	buildGeometry()	build lucene geometry.
JtsGeometry	buildS4J()	Create a new Shape from this builder.
Geometry	buildS4JGeometry(GeometryFactory factory, boolean fixDateline)
PolygonBuilder	close()	Close the shell of the polygon
protected StringBuilder	contentToWKT()
Coordinate[][][]	coordinates()	The coordinates setup by the builder will be assembled to a polygon.
protected XContentBuilder	coordinatesArray(XContentBuilder builder, ToXContent.Params params)
boolean	equals(Object obj)
int	hashCode()
PolygonBuilder	hole(LineStringBuilder hole)	Add a new hole to the polygon
PolygonBuilder	hole(LineStringBuilder hole, boolean coerce)	Add a new hole to the polygon
List<LineStringBuilder>	holes()
protected static LinearRing	linearRing(List<Coordinate> coordinates)
protected static LinearRing	linearRingS4J(GeometryFactory factory, List<Coordinate> coordinates)
protected static MultiPolygon	multipolygonS4J(GeometryFactory factory, Coordinate[][][] polygons)	Create a Multipolygon from a set of coordinates.
int	numDimensions()	tracks number of dimensions for this shape
ShapeBuilder.Orientation	orientation()
protected static Polygon	polygonS4J(GeometryFactory factory, Coordinate[][] polygon)
LineStringBuilder	shell()
Polygon	toPolygonGeometry()
Polygon	toPolygonS4J()
protected Polygon	toPolygonS4J(GeometryFactory factory)
XContentBuilder	toXContent(XContentBuilder builder, ToXContent.Params params)
GeoShapeType	type()	get the shapes type
protected void	validateHole(LineStringBuilder shell, LineStringBuilder hole)	Validates only 1 vertex is tangential (shared) between the interior and exterior of a polygon
void	writeTo(StreamOutput out)	Write this into the StreamOutput.

Methods inherited from class org.elasticsearch.common.geo.builders.ShapeBuilder

coordinate, coordinate, coordinateListToWKT, coordinates, coordinates, coordinates, coordinatesToXcontent, debugEnabled, getWriteableName, intersection, intersections, jtsGeometry, readFromStream, shift, toString, toWKT, toXContent, writeCoordinateTo

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.elasticsearch.common.xcontent.ToXContentObject

isFragment

Field Detail

TYPE

public static final GeoShapeType TYPE

Constructor Detail

PolygonBuilder

public PolygonBuilder(LineStringBuilder lineString,
                      ShapeBuilder.Orientation orientation,
                      boolean coerce)

PolygonBuilder

public PolygonBuilder(LineStringBuilder lineString,
                      ShapeBuilder.Orientation orientation)

PolygonBuilder

public PolygonBuilder(CoordinatesBuilder coordinates,
                      ShapeBuilder.Orientation orientation)

PolygonBuilder

public PolygonBuilder(CoordinatesBuilder coordinates)

PolygonBuilder

public PolygonBuilder(StreamInput in)
               throws IOException

Read from a stream.

Throws:

IOException

Method Detail

writeTo

public void writeTo(StreamOutput out)
             throws IOException

Description copied from interface: Writeable

Write this into the StreamOutput.

Specified by:

writeTo in interface Writeable

Overrides:

writeTo in class ShapeBuilder<JtsGeometry,Geometry,PolygonBuilder>

Throws:

IOException

orientation

public ShapeBuilder.Orientation orientation()

hole

public PolygonBuilder hole(LineStringBuilder hole)

Add a new hole to the polygon

Parameters:

hole - linear ring defining the hole

Returns:

this

hole

public PolygonBuilder hole(LineStringBuilder hole,
                           boolean coerce)

Add a new hole to the polygon

Parameters:

hole - linear ring defining the hole

coerce - if set to true, it will try to close the hole by adding starting point as end point

Returns:

this

holes

public List<LineStringBuilder> holes()

Returns:

the list of holes defined for this polygon

shell

public LineStringBuilder shell()

Returns:

the list of points of the shell for this polygon

close

public PolygonBuilder close()

Close the shell of the polygon

validateHole

protected void validateHole(LineStringBuilder shell,
                            LineStringBuilder hole)

Validates only 1 vertex is tangential (shared) between the interior and exterior of a polygon

coordinates

public Coordinate[][][] coordinates()

The coordinates setup by the builder will be assembled to a polygon. The result will consist of a set of polygons. Each of these components holds a list of linestrings defining the polygon: the first set of coordinates will be used as the shell of the polygon. The others are defined to holes within the polygon. This Method also wraps the polygons at the dateline. In order to this fact the result may contains more polygons and less holes than defined in the builder it self.

Returns:

coordinates of the polygon

buildS4J

public JtsGeometry buildS4J()

Description copied from class: ShapeBuilder

Create a new Shape from this builder. Since calling this method could change the defined shape. (by inserting new coordinates or change the position of points) the builder looses its validity. So this method should only be called once on a builder

Specified by:

buildS4J in class ShapeBuilder<JtsGeometry,Geometry,PolygonBuilder>

Returns:

new Shape defined by the builder

buildGeometry

public Geometry buildGeometry()

Description copied from class: ShapeBuilder

build lucene geometry.

Specified by:

buildGeometry in class ShapeBuilder<JtsGeometry,Geometry,PolygonBuilder>

Returns:

GeoPoint, double[][], Line, Line[], Polygon, Polygon[], Rectangle, Object[]

coordinatesArray

protected XContentBuilder coordinatesArray(XContentBuilder builder,
                                           ToXContent.Params params)
                                    throws IOException

Throws:

IOException

toXContent

public XContentBuilder toXContent(XContentBuilder builder,
                                  ToXContent.Params params)
                           throws IOException

Throws:

IOException

buildS4JGeometry

public Geometry buildS4JGeometry(GeometryFactory factory,
                                 boolean fixDateline)

toPolygonS4J

public Polygon toPolygonS4J()

toPolygonS4J

protected Polygon toPolygonS4J(GeometryFactory factory)

toPolygonGeometry

public Polygon toPolygonGeometry()

linearRing

protected static LinearRing linearRing(List<Coordinate> coordinates)

linearRingS4J

protected static LinearRing linearRingS4J(GeometryFactory factory,
                                          List<Coordinate> coordinates)

type

public GeoShapeType type()

Description copied from class: ShapeBuilder

get the shapes type

Specified by:

type in class ShapeBuilder<JtsGeometry,Geometry,PolygonBuilder>

Returns:

type of the shape

numDimensions

public int numDimensions()

Description copied from class: ShapeBuilder

tracks number of dimensions for this shape

Specified by:

numDimensions in class ShapeBuilder<JtsGeometry,Geometry,PolygonBuilder>

polygonS4J

protected static Polygon polygonS4J(GeometryFactory factory,
                                    Coordinate[][] polygon)

multipolygonS4J

protected static MultiPolygon multipolygonS4J(GeometryFactory factory,
                                              Coordinate[][][] polygons)

Create a Multipolygon from a set of coordinates. Each primary array contains a polygon which in turn contains an array of linestrings. These line Strings are represented as an array of coordinates. The first linestring will be the shell of the polygon the others define holes within the polygon.

Parameters:

factory - GeometryFactory to use

polygons - definition of polygons

Returns:

a new Multipolygon

contentToWKT

protected StringBuilder contentToWKT()

Overrides:

contentToWKT in class ShapeBuilder<JtsGeometry,Geometry,PolygonBuilder>

hashCode

public int hashCode()

Overrides:

hashCode in class ShapeBuilder<JtsGeometry,Geometry,PolygonBuilder>

equals

public boolean equals(Object obj)

Overrides:

equals in class ShapeBuilder<JtsGeometry,Geometry,PolygonBuilder>