@maticoapp/deck.gl-pmtiles

This repo provides a typed Deck.gl layer and loader for PMTiles data. PMTiles data provides a serverless and compact way to store tile geospatial data. Combined with Deck.gl's rendering, this provides a flexible and powerful way to cheaply manage geospatial data.

Learn more about Brandon Liu's PMTiles and ProtoMaps work.

Breaking Changes

Version 0.0.3 breaks support for V2 tiles. Legacy support will be coming back soon. If you need to use legacy v2 spec PMtiles, use version 0.0.14 of this package.

Roadmap

• Raster tile support
• V2 legacy support

Repo Scripts:

1yarn build-dev 
2// builds the loader/layer for development and listens for changes
3    
4    
5yarn build-prod 
6// builds the loader/layer for production
7    
8yarn dev 
9// runs the development server for the loader/layer and the frontend example

Example Usage:

1import React from 'react'
2import { PMTLayer } from "@maticoapp/deck.gl-pmtiles";
3import DeckGL from "@deck.gl/react/typed";
4
5const INITIAL_VIEW_STATE = {
6  longitude: -80,
7  latitude: 37,
8  zoom: 6,
9  pitch: 0,
10  bearing: 0,
11};
12
13const Example: React.FC = () => {
14    const Layers = [
15        new PMTLayer({
16            id: "pmtiles-layer",
17            data: "https://protomaps-static.sfo3.digitaloceanspaces.com/mantle-trial.pmtiles",
18            getFillColor: [255, 120, 120],
19            stroked: true,
20            getLineColor: [8, 8, 8],
21            lineWidthMinPixels: 1
22        })
23    ]
24
25    return  <DeckGL
26            controller={true}
27            layers={layers}
28            initialViewState={INITIAL_VIEW_STATE}
29            />
30}
31
32export default Example
33

Peer Dependencies

You must also install these packages in your app:

• deck.gl
• pmtiles

Other Libraries and References

This repo's code builds on existing work adapted from:

• Deckgl MVT Layer (MIT Licensed)
• @jtmiclat/deck.gl-pmtiles (MIT Licensed)
• PMtiles Leaflet and Maplibre implementations (BSD-3 license)