ST_AsMVT
Prev  7.9.3. Andra format  Next

Name

ST_AsMVT — Aggregatfunktion som returnerar en MVT-representation av en uppsättning rader.

Synopsis

bytea ST_AsMVT(anyelement set row);

bytea ST_AsMVT(anyelement row, text name);

bytea ST_AsMVT(anyelement row, text name, integer extent);

bytea ST_AsMVT(anyelement row, text name, integer extent, text geom_name);

bytea ST_AsMVT(anyelement row, text name, integer extent, text geom_name, text feature_id_name);

Beskrivning

En aggregerad funktion som returnerar en binär Mapbox Vector Tile-representation av en uppsättning rader som motsvarar ett plattlager. Raderna måste innehålla en geometrikolumn som kommer att kodas som en funktionsgeometri. Geometrin måste vara i plattkoordinatrymden och giltig enligt MVT-specifikationen. ST_AsMVTGeom kan användas för att omvandla geometrin till plattkoordinatrymden. Övriga kolumner i raden kodas som attribut för objektet.

Mapbox Vector Tile-format kan lagra funktioner med varierande uppsättningar attribut. För att använda den här funktionen måste du ange en JSONB-kolumn i raddata som innehåller Json-objekt på en nivås djup. Nycklarna och värdena i JSONB-värdena kommer att kodas som funktionsattribut.

Plattor med flera lager kan skapas genom att sammanfoga flera anrop till denna funktion med hjälp av || eller STRING_AGG.

[Important]

Anropa inte med en GEOMETRYCOLLECTION som ett element i raden. Du kan dock använda ST_AsMVTGeom för att förbereda en geometrisamling för inkludering.

rad raddata med minst en geometrikolumn.

name är namnet på lagret. Default är strängen "default".

extent är plattans utsträckning i skärmutrymme enligt specifikationens definition. Standardvärdet är 4096.

geom_name är namnet på geometrikolumnen i raddata. Standard är den första geometrikolumnen. Observera att PostgreSQL som standard automatiskt viker icke-citerade identifierare till gemener, vilket innebär att om inte geometrikolumnen är citerad, t.ex. "MyMVTGeom", måste denna parameter tillhandahållas som gemener.

feature_id_name är namnet på kolumnen Feature ID i raddata. Om NULL eller negativt anges inte Feature ID. Den första kolumnen som matchar namn och giltig typ (smallint, integer, bigint) kommer att användas som Feature ID, och alla efterföljande kolumner kommer att läggas till som en egenskap. JSON-egenskaper stöds inte.

Förbättrad: 3.0 - stöd för Feature ID har lagts till.

Förbättrad: 2.5.0 - stöd för parallella frågor har lagts till.

Tillgänglighet: 2.4.0

Exempel

WITH mvtgeom AS
(
  SELECT ST_AsMVTGeom(geom, ST_TileEnvelope(12, 513, 412), extent =
> 4096, buffer =
> 64) AS geom, name, description
  FROM points_of_interest
  WHERE geom && ST_TileEnvelope(12, 513, 412, margin =
> (64.0 / 4096))
)
SELECT ST_AsMVT(mvtgeom.*)
FROM mvtgeom;