tileutils

type BoundingBox ¶

type BoundingBox struct {
	Left   float64
	Right  float64
	Top    float64
	Bottom float64
}

BoundingBox is a lat/lon set of coordinates for a bounding box

type BytesBufferPool ¶ added in v2.1.0

type BytesBufferPool struct {
	// contains filtered or unexported fields
}

BytesBufferPool provides reusable buffers for a single worker (no synchronization needed)

func NewBytesBufferPool(maxPoolSize, maxBufferSize int) *BytesBufferPool

func (p *BytesBufferPool) Get() *bytes.Buffer

func (p *BytesBufferPool) Put(buf *bytes.Buffer)

func (p *BytesBufferPool) Stats() PoolStats

type CreateMetadataOptions ¶

type CreateMetadataOptions struct {
	Filename string
	Version  string
	Format   MbTilesFormat
}

type DummyWriter ¶

type DummyWriter struct{}

DummyWriter doesn't do anything. It outputs info about the tile to be written to stdout. It doesn't actually write any tiles.

func (fw *DummyWriter) New() (TileWriter, func(), error)

func (fw *DummyWriter) Write(z, x, y int, tileData []byte) error

type FileWriter ¶

type FileWriter struct {
	Path string
}

FileWriter writes tiles out to a directory structure. The directories are organized under the Path provided, like Path/{z}/{x}/{y}.mvt

func (fw *FileWriter) New() (TileWriter, func(), error)

func (fw *FileWriter) Write(z, x, y int, tileData []byte) error

type MbTilesFormat ¶

type MbTilesFormat string

const (
	MbTilesFormatPbf  MbTilesFormat = "pbf"
	MbTilesFormatJpg  MbTilesFormat = "jpg"
	MbTilesFormatPng  MbTilesFormat = "png"
	MbTilesFormatWebP MbTilesFormat = "webp"
)

type MbTilesMetadata ¶

type MbTilesMetadata map[string]string

func CreateMetadata(tj *TileJSON, opts CreateMetadataOptions) MbTilesMetadata

type MbTilesWriter ¶

type MbTilesWriter struct {
	Filename string
	Writer   *mbtiles.Writer
}

MbTilesWriter outputs tiles to a mbtiles file.

Parameters:

• Filename: the output file to be written
• Writer: an instance of mbtiles.Writer to be used when writing the tiles

func (w *MbTilesWriter) BulkWrite(data []mbtiles.TileData) error

func (w *MbTilesWriter) BulkWriteMetadata(meta MbTilesMetadata) error

func (w *MbTilesWriter) New() (TileWriter, func(), error)

func (w *MbTilesWriter) Write(z, x, y int, tileData []byte) error

func (w *MbTilesWriter) WriteMetadata(name, value string) error

type PoolStats ¶ added in v2.1.0

type PoolStats struct {
	Created    int64   // Total buffers created
	Reused     int64   // Total buffer reuses
	Active     int64   // Buffers currently in pool
	ReuseRatio float64 // Ratio of reused vs created
}

PoolStats contains buffer pool usage statistics

type TileBulkWriter ¶

type TileBulkWriter interface {
	// BulkWrite commits a slice of tiles
	BulkWrite(data []mbtiles.TileData) error
}

TileBulkWriter extends the TileWriter interface to include the ability to write out tiles in bulk

type TileCoords ¶

type TileCoords struct {
	Z int
	X int
	Y int
}

func ListTiles(zooms []int, tj *TileJSON) []TileCoords

func TilesFromFile(filename string) ([]TileCoords, error)

type TileJSON ¶

type TileJSON struct {
	Attribution  string        `json:"attribution,omitempty"`
	Name         string        `json:"name"`
	Description  string        `json:"description"`
	Version      string        `json:"version,omitempty"`
	MinZoom      int           `json:"minzoom"`
	MaxZoom      int           `json:"maxzoom"`
	Bounds       []float64     `json:"bounds,omitempty"`
	Center       []float64     `json:"center,omitempty"`
	VectorLayers []VectorLayer `json:"vector_layers"`
}

type TileWriter ¶

type TileWriter interface {
	// New creates a new TileWriter for this type
	New() (TileWriter, func(), error)
	// Write commits a tile with tileData at the Z/X/Y coordinate
	Write(z, x, y int, tileData []byte) error
}

TileWriter abstracts how to write out tiles, allowing for different formats and implementations

type VectorLayer ¶

type VectorLayer struct {
	ID      string        `json:"id"`
	Queries []VectorQuery `json:"queries"`
}

type VectorQuery ¶

type VectorQuery struct {
	MinZoom int    `json:"minzoom"`
	MaxZoom int    `json:"maxzoom"`
	SQL     string `json:"sql"`
}

type WorkerGzipCompressor ¶ added in v2.1.0

type WorkerGzipCompressor struct {
	// contains filtered or unexported fields
}

WorkerGzipCompressor provides optimized gzip compression using a worker-local buffer pool

func NewWorkerGzipCompressor(level int) *WorkerGzipCompressor

func (c *WorkerGzipCompressor) Compress(data []byte, buf *bytes.Buffer) (*bytes.Buffer, error)

type ZoomLayerInfo ¶

type ZoomLayerInfo map[int]map[string][]string

ZoomLayerInfo is a mapped index of queries at each zoom. map[int] where int is the zoom level. map[string][]string where string1 is the layer name/id and []string is the list of queries.