Mapbox Vector Tile (MVT) and MVT Tileset Feature Representation

Features read from an MVT file consist of geometry and a series of attribute values. The attribute names are as defined in the workspace.

Features being returned may include additional attributes that do not appear on the reader schema if the tiles scanned for schema do not account for all attributes.

MVT string attribute values are stored in UTF-8 encoding.

In addition to the generic FME feature attributes that FME Workbench adds to all features (see About Feature Type Attributes), this format also adds format-specific attributes (Format Attributes).

Attribute Name Contents

mvt_id

Unique identifier for each feature.

mvt_tile_column

An integer value indicating the tile number in the X direction, according to the tiling scheme, for the tile containing the current feature.

Note   This is only generated when reading a zoom level or tileset and not a single MVT tile file.

mvt_tile_row

An integer value indicating the tile number in the Y direction, according to the tiling scheme, for the tile containing the current feature.

Note   This is only generated when reading a zoom level or tileset and not a single MVT tile file.

mvt_type

The format geometry type for the feature. See Geometry.

mvt_zoom_level

An integer value between 0 and 22 that indicates the zoom level for the tile containing the current feature.

Note   This is only generated when reading a zoom level or tileset and not a single MVT tile file.

Attribute Type Mapping

Attribute Type

FME Attribute Type

bool

fme_boolean

double

fme_decimal(width, precision)

double

fme_real32

double

fme_real64

int64

fme_int8

int64

fme_uint8

int64

fme_int16

int64

fme_uint16

int64

fme_int32

int64

fme_uint32

int64

fme_uint8

int64

fme_int64

int64

fme_uint64

string

fme_json

string

fme_char(width)

string

fme_buffer

string

fme_time

string

fme_date

string

fme_datetime

string

fme_varbinary(width)

string

fme_binary(width)

string

fme_binarybuffer

string

fme_xml

string

fme_varchar(width)

Geometry

The geometry of MVT features may be identified by the mvt_type attribute and correspond to 2D vector geometries. The valid values for this attribute are:

mvt_type

Description

wkb_geometry_collection

A heterogeneous collection of 2D geometries. This will be split into homogeneous geometries of points, lines, and polygons before being written.

wkb_line

2D Linear feature.

wkb_multi_line

2D Feature with multiple line geometries.

wkb_multi_point

2D Feature with multiple heterogeneous point geometries.

wkb_multi_polygon

2D Feature with multiple polygon geometries.

wkb_none

Absence of geometry. Can occur on read if there is a parsing error in the geometry.

wkb_point

2D Point feature.

wkb_polygon

2D Simple polygon or donut feature.

wkb_unknown

An unsupported geometry type other than those listed above.

This may include optional or experimental geometry types.

For more information, see the Mapbox Vector Tile Specification.