Package org.geotools.pmtiles.store

Class PMTilesDataStore

Object

ContentDataStore

VectorTilesDataStore

PMTilesDataStore

All Implemented Interfaces:

DataAccess<SimpleFeatureType,SimpleFeature>, DataStore

public class PMTilesDataStore
extends VectorTilesDataStore

GeoTools DataStore implementation for reading PMTiles archives containing Mapbox Vector Tiles.

This datastore provides access to cloud-optimized PMTiles archives from various sources including local files, HTTP/HTTPS servers, and cloud storage (AWS S3, Azure Blob Storage, Google Cloud Storage). It uses the Tileverse Range Reader library for efficient byte-range access and the Tileverse PMTiles library for reading the PMTiles format.

Features:

• Reads PMTiles v3 archives with embedded vector tiles
• Supports multiple data sources via RangeReader
• Automatic zoom level selection based on query resolution
• Spatial filtering and bbox optimization
• Coordinate reference system transformation
• Thread-safe concurrent access

See Also:

• PMTilesDataStoreFactory
• VectorTilesDataStore
• PMTiles Specification

Field Summary

Fields inherited from class VectorTilesDataStore

DEFAULT_GEOMETRY_FACTORY

Fields inherited from class ContentDataStore

dataStoreFactory, entries, featureFactory, filterFactory, geometryFactory, JOINED_FEATURE_TYPE, lockingManager, namespaceURI, typeFactory, WRITER_ADD, WRITER_COMMIT, WRITER_UPDATE

Constructor Summary

Constructors

Constructor	Description
PMTilesDataStore(RangeReader rangeReader)	Creates a new PMTiles datastore from a RangeReader.

Method Summary

Modifier and Type	Method	Description
void	dispose()	Disposes of this datastore and releases all resources, including closing the underlying RangeReader.

Methods inherited from class VectorTilesDataStore

createFeatureSource, createTypeNames, getTileStore

Methods inherited from class ContentDataStore

createContentState, createSchema, ensureEntry, ensureFeatureStore, entry, getDataStoreFactory, getEntry, getFeatureFactory, getFeatureReader, getFeatureSource, getFeatureSource, getFeatureSource, getFeatureSource, getFeatureTypeFactory, getFeatureWriter, getFeatureWriter, getFeatureWriterAppend, getFilterFactory, getGeometryFactory, getInfo, getLockingManager, getLogger, getNames, getNamespaceURI, getSchema, getSchema, getTypeNames, name, removeEntry, removeSchema, removeSchema, setDataStoreFactory, setFeatureFactory, setFeatureTypeFactory, setFilterFactory, setGeometryFactory, setNamespaceURI, updateSchema, updateSchema

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

PMTilesDataStore

public PMTilesDataStore(RangeReader rangeReader)
                 throws IOException

Creates a new PMTiles datastore from a RangeReader.

The RangeReader provides the underlying byte-range access to the PMTiles archive, which can be from any supported source (local file, HTTP, cloud storage). The datastore takes ownership of the RangeReader and will close it when dispose() is called.

Parameters:

rangeReader - the RangeReader providing access to the PMTiles archive

Throws:

IOException - if the PMTiles archive cannot be read or is invalid

Method Details

dispose

public void dispose()

Disposes of this datastore and releases all resources, including closing the underlying RangeReader.

After calling this method, the datastore should not be used anymore.

Specified by:

dispose in interface DataAccess<SimpleFeatureType,SimpleFeature>

Overrides:

dispose in class ContentDataStore