<< Click to Display Table of Contents >> Navigation: Technical Guide > Geometry > Structure |
Here is the general structure of a DTSGeoJson with all the fields it uses:
{
"type": "",
"coordinates": [],
"orientation": [],
"cs": "",
"dimensions": 2,
"corrections": [],
"extras": {},
"geoJsonString": ""
}
Geometry data only
Please note that the structure above represents the content of the "geometry" field in a full GeoJson "Feature" object. DTS only uses this part, as the other feature elements are not relevant to the geometry and cannot be related to pure geometry structures in the various systems DTS connects.
type |
Unchanged from the standard specification. DTS supports all GeoJson geometry types: Point, Multipoint, LineString, MultiLineString, Polygon, MultiPolygon and GeometryCollection. This field must be populated.
|
coordinates |
Represents the coordinates of the geometry in the same format as the standard specification. If the geometry contains elements that are not supported by the standard specification (e.g. arcs, splines, etc.), the coordinates will contain a "flattened" approximation (a series of straight line segments), while the exact definition of the sector will be stored in corrections. This ensures that clients which only support the standard format can get a close approximation of these geometries from the expected field, while clients that support the DTSGeoJson extras can substitute the approximated sectors with the exact version. This field must be populated. |
orientation(s) |
Is only present for Point (orientation) and MultiPoint (orientations) and encodes the directions points are facing (e.g. building placements). It is encoded as a single coordinate for Points and as multiple coordinates for MultiPoints. The coordinate encoding is the same as in the coordinates field. Non-oriented points will have orientations with all ordinates = 0.0, or simply lack the field. |
cs |
Specifies the SRID of the coordinate system the geometry is defined in. This field is not required. |
dimensions |
Specifies the dimensionality of the geometry. Supported values are 2 and 3, but 3D geometries with certain sector types are not supported for approximation (see Known Limitations). If left unpopulated, the value will be inferred from the coordinates. |
corrections |
Stores the exact representation of curve sectors that are not supported by the GeoJson standard specification. If not populated or empty, the coordinates are considered to be the exact representation of the geometry. The format of the corrections is detailed in a separate section. |
extras |
Stores extra information the geometry structure may contain which is only relevant to certain data sources (e.g. annotation text, justification, etc.). It presents as a key-value map (string-string) and the values are as provided/required by the datasource. |
geoJsonString |
A String representation of the entire DTSGeoJson object (in JSON format). This field is present as a workaround for including DTSGeoJson geometry representations in SOAP XML messages and only has relevance in that context. In any other circumstances it will be absent and/or ignored. |