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:

TypeWKT
PointPOINT (-77.1151397 38.8814540)
LineStringLINESTRING (-77.1151397 38.8814540, -122.3979088 37.7929045)
PolygonPOLYGON ((-77.115 38.881, -71.054 42.364, -122.398 37.793, -77.115 38.881))
MultiPointMULTIPOINT ((-77.115 38.881), (-122.398 37.793))
MultiLineStringMULTILINESTRING ((-77.115 38.881, -122.398 37.793), (-77.115 38.881, -71.054 42.364))
MultiPolygonMULTIPOLYGON (((-77 38, -71 42, -122 37, -77 38)), ((-122 37, -77 38, -71 42, -122 37)))
GeometryCollectionGEOMETRYCOLLECTION (POINT (-77.115 38.881), LINESTRING (-77.115 38.881, -122.398 37.793))

Tracks

Tracks are a set 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 string
  • x - 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.)

Track-based tables can utilize partitioning for better performance and data management. See Partitioning for details and limitations.

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.