geometry
Types
Boundaries are used for defining the minimal boundary rectangle of a geographical object. It contains the minimum and maximum values for x and y dimension.
Coordinate
used by TransformFault, Polyline, OffRoadRouteLocation, OnRoadRouteLocation, SegmentsByCoordinateRequest, TimeZoneRequest, Location, SearchByPositionBulkRequest, SearchByPositionRequest, Feature, MapSectionByCenter, MatchedPosition, MatchedTrackPosition, Position, ManipulateRouteWaypoint, MultiCoordinateOnRoadWaypoint, Node, PositionEnRoute, RouteEvent, Waypoint, PositionEnRouteToStop, PositionEnRouteToVehicleEndLocation
since 2.0
A coordinate is defined by its x and y values, specifying the geographical point in a two-dimensional coordinate system, and its z-value, specifying the elevation.
Field Name | Type | Required | Default | Since | Description |
---|---|---|---|---|---|
x | double | yes | - | 2.0 | The value in x-direction (west to east), longitude for WGS84. |
y | double | yes | - | 2.0 | The value in y-direction (south to north), latitude for WGS84. |
z | Double | no | - | 2.0 | The elevation value. In responses such as RouteResponse.polyline the z-coordinate is available only on request. |
EncodedGeometry
used by GeographicRestrictions, MapSegment, SegmentsByIntersectingPolylineRequest, SegmentsBySurroundingPolygonRequest, MatchedSegment, TrackResponse, AlternativeRoute, Leg, ReachableAreasResponse, ReachableAreasSegment, RouteResponse, Segment
since 2.0
An EncodedGeometry contains one or more representations of the same Geometry which can be selected for each request by GeometryOptions.responseGeometryTypes. If z-coordinates have to be represented WKB and WKT are used in an extended form as described by OpenGIS document 99-402r2.
Field Name | Type | Required | Default | Since | Description |
---|---|---|---|---|---|
plain | Geometry | no | - | 2.0 | The plain representation of the geometry using structured objects. |
wkb | byte[] | no | - | 2.0 | The WKB (well-known binary) representation of the geometry |
wkt | String | no | - | 2.0 | The WKT (well-known text) representation of the geometry. |
kml | KML | no | - | 2.0 | The KML (keyhole markup language) representation of the geometry. Coordinates are always present in WGS84 (EPSG:4326). |
geoJSON | String | no | - | 2.0 | The GeoJSON representation of the geometry. Coordinates are always present in WGS84 (EPSG:4326). |
Geometry (abstract)
extended by GeometryCollection, Polygon, Polyline
used by EncodedGeometry, GeometryCollection
since 2.0
Geometry objects consist of (multi-dimensional) arrays of coordinate points
No fields defined. |
A GeometryCollection is a geometry that is a collection of one or more geometries. All the elements in a GeometryCollection must be in the same spatial reference. This is also the reference for the GeometryCollection. GeometryCollection places no other constraints on its elements.
Field Name | Type | Required | Default | Since | Description |
---|---|---|---|---|---|
geometries | Geometry[] | 0..* | - | 2.0 | a geometry collection consists of a set of geometries |
A polygon is a planar two-dimensional geometric object, defined by one exterior boundary and zero or more interior boundaries. Each interior boundary defines a hole in the polygon.
Assertions:
- Polygons are topologically closed.
- The boundary of a polygon consists of a set of linear rings that make up its exterior and interior boundaries.
- No two rings in the boundary cross, they may intersect at a point but only as a tangent.
- A polygon may not have cut lines, spikes or punctures.
- The interior of every polygon is a connected coint set.
- The exterior of a polygon with one or more holes is not connected. Each hole defines a connected component of the exterior.
(Open GIS Standard)
Field Name | Type | Required | Default | Since | Description |
---|---|---|---|---|---|
polygonRings | Polyline[] | 0..* | - | 2.0 | A polygon consists of a set of linear rings (polylines that are simple and closed). The first ring specifies the shell of the polygon, all other rings specify holes. |
A polyline is a one-dimensional geometric object (sequence of points) with linear interpolation between points. Each consecutive pair of points defines a line segment. (Open GIS Standard) A linear ring is a polyline that is both closed and simple (no intersections allowed).
Field Name | Type | Required | Default | Since | Description |
---|---|---|---|---|---|
polyline | Coordinate[] | 0..* | - | 2.0 | A Polyline consists of at least two points, it is closed if first and last coordinate are equal. |
Defines the encoding of response geometries.