Geospatial Objects¶
Points¶
A point can be any record that has fields containing the longitude and latitude of a geospatial point.
Shapes¶
Kinetica supports the following WKT types: Point, LineString, Polygon,
MultiPoint, MultiLineString, MultiPolygon, and GeometryCollection. WKT shapes
can include a z-level value ranging from -128 to +128 but rendering
points on the z-axis (e.g., via GAdmin or
/wms) is currently not supported.
Note
Though LINEARRING WKT types may be inserted into tables, any
LINEARRINGs used within a
geospatial function will be
converted to a LINESTRING
Examples of WKTs include:
| Type | WKT |
|---|---|
| Point | POINT (-77.1151397 38.8814540) |
| LineString | LINESTRING (-77.1151397 38.8814540, -122.3979088 37.7929045) |
| Polygon | POLYGON ((-77.115 38.881, -71.054 42.364, -122.398 37.793, -77.115 38.881)) |
| MultiPoint | MULTIPOINT ((-77.115 38.881), (-122.398 37.793)) |
| MultiLineString | MULTILINESTRING ((-77.115 38.881, -122.398 37.793), (-77.115 38.881, -71.054 42.364)) |
| MultiPolygon | MULTIPOLYGON (((-77 38, -71 42, -122 37, -77 38)), ((-122 37, -77 38, -71 42, -122 37))) |
| GeometryCollection | GEOMETRYCOLLECTION (POINT (-77.115 38.881), LINESTRING (-77.115 38.881, -122.398 37.793)) |
Tracks¶
Tracks are a collection of points which represent the path an object takes across the map. Unlike a WKT multiline string, each point in a track has an associated timestamp. Taken together: the longitude, latitude, and timestamp in each record describe where the object was at a given time; all points in a given track should contain the same track ID. Tables containing tracks must have columns of the following names and types (names are case-sensitive):
TRACKID- unrestricted stringx- any numeric type (int, float, double, etc.)y- any numeric type (int, float, double, etc.)TIMESTAMP- any numeric or time-based type (long, datetime, etc.)
Tracks can be accessed via the following endpoints:
Important
Join views cannot be used to render tracks.
Labels¶
Labels are text labels located at specified positions on the map. Each label can optionally be enclosed in a box and can have a line pointing to a specific location.