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.
Related projects¶
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
RangeReaderAPI 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