A high-performance, modular Java ecosystem for cloud-native geospatial data.

Tileverse is a collection of loosely coupled Java libraries designed to solve the challenges of modern, cloud-centric geospatial applications. It provides the foundational blocks—efficient I/O, standardized tiling schemes, and robust format parsers—needed to build tile servers, ETL pipelines, and analytical tools.

Unlike monolithic GIS frameworks, Tileverse modules are designed to be composable. Pick exactly what you need: just the I/O layer for reading COGs from S3, just the math library for tile grid calculations, or the full stack for serving PMTiles.

Tileverse is available on Maven Central. We recommend using the Bill of Materials (BOM) to align versions across modules.

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>io.tileverse</groupId>
      <artifactId>tileverse-bom</artifactId>
      <version>1.1.0</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

<dependencies>
  <!-- I/O Layer -->
  <dependency>
    <groupId>io.tileverse.rangereader</groupId>
    <artifactId>tileverse-rangereader-all</artifactId>
  </dependency>

  <!-- Format Support -->
  <dependency>
    <groupId>io.tileverse.pmtiles</groupId>
    <artifactId>tileverse-pmtiles</artifactId>
  </dependency>
</dependencies>

dependencies {
    implementation platform('io.tileverse:tileverse-bom:1.1.0')

    implementation 'io.tileverse.rangereader:tileverse-rangereader-all'
    implementation 'io.tileverse.pmtiles:tileverse-pmtiles'
}

This example demonstrates how the modules compose to solve a real-world problem: reading a specific map tile from an S3 bucket without downloading the entire archive.

import io.tileverse.rangereader.s3.S3RangeReader;
import io.tileverse.rangereader.cache.CachingRangeReader;
import io.tileverse.pmtiles.PMTilesReader;
import java.nio.ByteBuffer;
import java.net.URI;

// 1. Configure the I/O layer (S3 + Memory Caching)
var s3Source = S3RangeReader.builder()
    .uri(URI.create("s3://my-bucket/maps/planet.pmtiles"))
    .region(Region.US_EAST_1)
    .build();

var cachedSource = CachingRangeReader.builder(s3Source)
    .capacity(50_000_000) // 50MB cache for headers/directories
    .build();

// 2. Initialize the Format Reader
try (var reader = new PMTilesReader(cachedSource::asByteChannel)) {
    
    // 3. Fetch a specific tile (z=0, x=0, y=0)
    Optional<ByteBuffer> tile = reader.getTile(0, 0, 0);
    
    tile.ifPresent(buffer -> {
        buffer.flip();
        System.out.println("Found tile: " + buffer.remaining() + " bytes");
        // Pass 'buffer' to VectorTileCodec to decode...
    });
}

The libraries are designed to work together but remain independent. PMTiles orchestrates the others, while RangeReader, VectorTiles, and TileMatrixSet are standalone utilities.

graph TD
    App[Your Application]
    
    subgraph "Core I/O"
        RR[Range Reader]
    end
    
    subgraph "Formats & Codecs"
        VT[Vector Tiles]
        PMT[PMTiles]
    end
    
    subgraph "Spatial Logic"
        TMS[Tile Matrix Set]
    end
    
    App --> RR
    App --> VT
    App --> PMT
    App --> TMS
    
    PMT -.-> RR
    PMT -.-> VT
    PMT -.-> TMS

Complete documentation is available at tileverse.io.

• Developer Guide: Building, testing, and contributing.
• Range Reader Guide: Advanced caching and authentication.
• Javadoc: API reference.

This is a standard Maven project wrapped with a Makefile for convenience.

• Java 21+ is required for building (runtime support starts at Java 17).
• Docker is required for running integration tests.

make help      # Show all commands
make           # Build and test everything
make test      # Run unit & integration tests
make format    # Fix code style (Spotless)

Released under the Apache License 2.0.

Copyright © 2025 Multiversio LLC.