Registry / data / titiler-mosaic

titiler-mosaic

library2.0.1pypypi✓ verified 89d ago

TiTiler plugin for MosaicJSON (cogeo-mosaic) support. Version 2.0.1, active development. Allows creating tile endpoints from mosaic JSON documents.

data web-framework http-networking

pip install titiler-mosaic

github ↗package ↗homepage ↗docs ↗changelog ↗

INSTALL

IMPORT

SIG · TITILER-MOSAIC

titiler-mosaic

datapythonv2.0.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

MosaicTilerFactory

✓ from titiler.mosaic.factory import MosaicTilerFactory

✗ from titiler.mosaic import MosaicTilerFactory

MosaicTilerFactory is in the factory submodule, not directly in titiler.mosaic

Minimal setup to add mosaic tile endpoints to a FastAPI app.

from fastapi import FastAPI from titiler.mosaic.factory import MosaicTilerFactory app = FastAPI() mosaic = MosaicTilerFactory() app.include_router(mosaic.router)

Debug

Known issues

breakingIn titiler 2.0, the MosaicTilerFactory constructor signature changed. The `reader` parameter is now required and must be a reader class that inherits from BaseReader.

fix

Pass a valid reader class (e.g., from cogeo_mosaic.mosaic import MosaicJSON) to MosaicTilerFactory(reader=...).

affects: >=2.0.0

deprecatedThe `pixel-selection` method is deprecated in favor of `pixel_selection` (underscore). Old parameter names will be removed in a future version.

fix

Use `pixel_selection` instead of `pixel-selection` in endpoint parameters.

affects: >=1.2.1

gotchaThe `assets` parameter is now required for tile endpoints. Use `assets=:all:` to include all assets from the mosaic.

fix

Always include assets parameter in tile requests, e.g., `assets=:all:` or a comma-separated list.

affects: >=2.0.0

Errors

Common errors & fixes

ImportError: cannot import name 'MosaicTilerFactory' from 'titiler.mosaic'

MosaicTilerFactory is in the factory submodule, not directly in titiler.mosaic.

fix

Use: from titiler.mosaic.factory import MosaicTilerFactory

TypeError: MosaicTilerFactory.__init__() missing 1 required positional argument: 'reader'

In titiler-mosaic 2.0, reader argument is required.

fix

Provide a reader class: MosaicTilerFactory(reader=MyReader)

Upgrade

Version history

2.0.1latest on PyPI · released Mar 31, 2026

Audit

Dependencies

titiler-corerequiredCore TiTiler functionality required for mosaic endpoint

cogeo-mosaicrequiredMosaicJSON parsing and handling

Agent activity

21 hits · last 30 days

node

Anthropic

OpenAI (training)

Resources

githubhttps://github.com/developmentseed/titiler ↗

packagehttps://pypi.org/project/titiler-mosaic/ ↗

homepagehttps://developmentseed.org/titiler/ ↗

docshttps://developmentseed.org/titiler/ ↗

changeloghttps://developmentseed.org/titiler/release-notes/ ↗