org.elasticsearch.common.geo.builders

Class PolygonBuilder

java.lang.Object

org.elasticsearch.action.support.ToXContentToBytes

org.elasticsearch.common.geo.builders.ShapeBuilder

org.elasticsearch.common.geo.builders.PolygonBuilder

All Implemented Interfaces:

NamedWriteable, Writeable, ToXContent

public class PolygonBuilder
extends ShapeBuilder

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.CoordinateNode, ShapeBuilder.Edge, ShapeBuilder.GeoShapeType, ShapeBuilder.Orientation

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

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

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

ToXContent.DelegatingMapParams, ToXContent.MapParams, ToXContent.Params

Field Summary

Fields

Modifier and Type	Field and Description
static ShapeBuilder.GeoShapeType	TYPE

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

AUTO_INDEX_JTS_GEOMETRY, AUTO_VALIDATE_JTS_GEOMETRY, DATELINE, FACTORY, FIELD_COORDINATES, FIELD_GEOMETRIES, FIELD_ORIENTATION, FIELD_TYPE, 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 and 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 and Description
org.locationtech.spatial4j.shape.Shape	build() Create a new Shape from this builder.
com.vividsolutions.jts.geom.Geometry	buildGeometry(com.vividsolutions.jts.geom.GeometryFactory factory, boolean fixDateline)
PolygonBuilder	close() Close the shell of the polygon
com.vividsolutions.jts.geom.Coordinate[][][]	coordinates() The coordinates setup by the builder will be assembled to a polygon.
protected XContentBuilder	coordinatesArray(XContentBuilder builder, ToXContent.Params params)
boolean	equals(java.lang.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
java.util.List<LineStringBuilder>	holes()
protected static com.vividsolutions.jts.geom.LinearRing	linearRing(com.vividsolutions.jts.geom.GeometryFactory factory, java.util.List<com.vividsolutions.jts.geom.Coordinate> coordinates)
protected static com.vividsolutions.jts.geom.MultiPolygon	multipolygon(com.vividsolutions.jts.geom.GeometryFactory factory, com.vividsolutions.jts.geom.Coordinate[][][] polygons) Create a Multipolygon from a set of coordinates.
ShapeBuilder.Orientation	orientation()
protected static com.vividsolutions.jts.geom.Polygon	polygon(com.vividsolutions.jts.geom.GeometryFactory factory, com.vividsolutions.jts.geom.Coordinate[][] polygon)
LineStringBuilder	shell()
com.vividsolutions.jts.geom.Polygon	toPolygon()
protected com.vividsolutions.jts.geom.Polygon	toPolygon(com.vividsolutions.jts.geom.GeometryFactory factory)
XContentBuilder	toXContent(XContentBuilder builder, ToXContent.Params params)
ShapeBuilder.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

debugEnabled, getWriteableName, intersection, intersections, jtsGeometry, parse, parse, readFromStream, shift, toXContent, writeCoordinateTo

Methods inherited from class org.elasticsearch.action.support.ToXContentToBytes

buildAsBytes, buildAsBytes, toString, toString

Methods inherited from class java.lang.Object

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

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

isFragment

Field Detail

TYPE

public static final ShapeBuilder.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 java.io.IOException

Read from a stream.

Throws:

java.io.IOException

Method Detail

writeTo

public void writeTo(StreamOutput out)
             throws java.io.IOException

Description copied from interface: Writeable

Write this into the StreamOutput.

Throws:

java.io.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 java.util.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 com.vividsolutions.jts.geom.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

build

public org.locationtech.spatial4j.shape.Shape build()

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:

build in class ShapeBuilder

Returns:

new Shape defined by the builder

coordinatesArray

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

Throws:

java.io.IOException

toXContent

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

Throws:

java.io.IOException

buildGeometry

public com.vividsolutions.jts.geom.Geometry buildGeometry(com.vividsolutions.jts.geom.GeometryFactory factory,
                                                          boolean fixDateline)

toPolygon

public com.vividsolutions.jts.geom.Polygon toPolygon()

toPolygon

protected com.vividsolutions.jts.geom.Polygon toPolygon(com.vividsolutions.jts.geom.GeometryFactory factory)

linearRing

protected static com.vividsolutions.jts.geom.LinearRing linearRing(com.vividsolutions.jts.geom.GeometryFactory factory,
                                                                   java.util.List<com.vividsolutions.jts.geom.Coordinate> coordinates)

type

public ShapeBuilder.GeoShapeType type()

Description copied from class: ShapeBuilder

get the shapes type

Specified by:

type in class ShapeBuilder

Returns:

type of the shape

polygon

protected static com.vividsolutions.jts.geom.Polygon polygon(com.vividsolutions.jts.geom.GeometryFactory factory,
                                                             com.vividsolutions.jts.geom.Coordinate[][] polygon)

multipolygon

protected static com.vividsolutions.jts.geom.MultiPolygon multipolygon(com.vividsolutions.jts.geom.GeometryFactory factory,
                                                                       com.vividsolutions.jts.geom.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

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object