Skip to content

Tileverse

Tileverse is a set of Java libraries for cloud-native geospatial applications. Each library solves one problem: object storage, tile archives, vector tile encoding, or tile grids. Use the ones you need, alone or together.

Libraries

Library Artifact Use it to
Storage tileverse-storage-all List, read, write and presign objects on local disks, HTTP, S3, Azure and GCS through one API, and read byte ranges of single files.
PMTiles tileverse-pmtiles Read PMTiles archives, as tile bytes or as decoded vector and raster tiles.
Versatiles tileverse-versatiles Read VersaTiles containers, as tile bytes or as decoded vector and raster tiles.
Vector Tiles tileverse-vectortiles Encode and decode Mapbox Vector Tiles with JTS geometries.
Tile Matrix Set tileverse-tilematrixset Map coordinates to tiles with the OGC Tile Matrix Set model.
Tile Store tileverse-tilestore Read tiles through one API, whatever the archive format.

Getting Started shows how to add them to a project.

Parquetry reads and writes Apache Parquet and GeoParquet files from Java. Its experimental modules read Apache Iceberg tables and STAC GeoParquet catalogs. It is a separate project with its own releases, and it reads object storage through Storage.

How they fit together

The archive readers build on the other libraries. Storage, Vector Tiles and Tile Matrix Set are independent of each other:

  • Reading Parquet or GeoParquet files in S3, Azure or GCS? Use Parquetry, which reads them through Storage.
  • Reading Cloud Optimized GeoTIFFs with byte-range requests? Use the RangeReader API of Storage.
  • Building a tile server from PostGIS? Use Vector Tiles and Tile Matrix Set.
  • Need a standard grid definition? Use Tile Matrix Set.
graph TD
    App[Your App]

    subgraph "I/O"
        ST[Storage<br/>+ RangeReader API]
    end

    subgraph "Formats"
        VT[Vector Tiles]
        PMT[PMTiles]
        VER[Versatiles]
    end

    subgraph "Spatial"
        TMS[Tile Matrix Set]
    end

    TS[Tile Store]

    subgraph "Related projects"
        PQ["Parquetry<br/>Parquet, GeoParquet,<br/>Apache Iceberg,<br/>STAC GeoParquet"]
    end

    App --> ST
    App --> VT
    App --> PMT
    App --> VER
    App --> TMS

    PMT -.-> ST
    PMT -.-> VT
    PMT -.-> TMS
    PMT -.-> TS

    VER -.-> ST
    VER -.-> VT
    VER -.-> TMS
    VER -.-> TS

    TS -.-> VT
    TS -.-> TMS

    App --> PQ
    PQ -.-> ST

    classDef external stroke-dasharray: 5 5
    class PQ external