Version:

/vts

URL: http://GPUDB_IP_ADDRESS:GPUDB_PORT/vts

Overview

Kinetica provides a Vector Tile Service (VTS) to generate Vector Tiles and support client-side visualization of the geospatial data contained within the tiles. The Vector Tile format generated follows the open standard Mapbox Vector Tile specification. The Kinetica VTS feeds a client-side Vector Tile renderer, such as Mapbox GL, by adding the VTS URL to the renderer’s style configuration as a map layer source. Any Kinetica table that is defined with at least one WKT-type (geometry) column can be used as the data source for the layer parameter. The data source, geographical position, and zoom level of each Vector Tile are specified in a VTS request. The requested Vector Tile is then returned in the response.

Usage

Base VTS URI:

http://<kinetica-host>:<port>/vts/<layer>/<z>/<x>/<y>.pbf?attributes=<columns>

Important

The VTS URL needs to be specified in the client-side visualizer's configuration.

URI parameters:

Name Description Allowable Values
layer Name of data source table. A valid table name.
attributes List of geometry column names. A comma separated list of column names of the data source table.
z Zoom level of the requested tile. Non-negative integer. The maximum value is 30. Provide the parameter as {z} to have the client-side renderer dynamically set the value.
x Horizontal index of the requested tile. Non-negative integer. Provide the parameter as {x} to have the client-side renderer dynamically set the value.
y Vertical index of the requested tile. Non-negative integer. Provide the parameter as {y} to have the client-side renderer dynamically set the value.

Example

Below is an example of a Mapbox style specification using Kinetica’s VTS URL as a source. In this example, the source-layer (polygons) is matched with the layer in the Kinetica VTS URL to display the geometry in the returned Vector Tiles:

{
  "version": 8,
  "sources": {
    "vts-kinetica": {
      "type": "vector",
      "tiles": [
          "http://172.123.45.67:9191/vts/polygons/{z}/{x}/{y}.pbf?attributes=wkt"
      ],
      "maxzoom": 20
    }
  },
  "layers": [
    {
      "id": "background",
      "paint": {
        "background-color": "#C5D1ED"
      },
      "type": "background"
    },
    {
      "id": "countries-fill",
      "source": "vts-kinetica",
      "source-layer": "polygons",
      "paint": {
        "fill-color": "#EDF00F",
        "fill-outline-color": "#000000"
      },
      "type": "fill"
    }
  ]
}