{"id":27460,"library":"titiler-mosaic","title":"titiler-mosaic","description":"TiTiler plugin for MosaicJSON (cogeo-mosaic) support. Version 2.0.1, active development. Allows creating tile endpoints from mosaic JSON documents.","status":"active","version":"2.0.1","language":"python","source_language":"en","source_url":"https://github.com/developmentseed/titiler","tags":["mosaic","tiles","cogeo","fastapi"],"install":[{"cmd":"pip install titiler-mosaic","lang":"bash","label":"PyPI"}],"dependencies":[{"reason":"Core TiTiler functionality required for mosaic endpoint","package":"titiler-core","optional":false},{"reason":"MosaicJSON parsing and handling","package":"cogeo-mosaic","optional":false}],"imports":[{"note":"MosaicTilerFactory is in the factory submodule, not directly in titiler.mosaic","wrong":"from titiler.mosaic import MosaicTilerFactory","symbol":"MosaicTilerFactory","correct":"from titiler.mosaic.factory import MosaicTilerFactory"}],"quickstart":{"code":"from fastapi import FastAPI\nfrom titiler.mosaic.factory import MosaicTilerFactory\n\napp = FastAPI()\nmosaic = MosaicTilerFactory()\napp.include_router(mosaic.router)","lang":"python","description":"Minimal setup to add mosaic tile endpoints to a FastAPI app."},"warnings":[{"fix":"Pass a valid reader class (e.g., from cogeo_mosaic.mosaic import MosaicJSON) to MosaicTilerFactory(reader=...).","message":"In titiler 2.0, the MosaicTilerFactory constructor signature changed. The `reader` parameter is now required and must be a reader class that inherits from BaseReader.","severity":"breaking","affected_versions":">=2.0.0"},{"fix":"Use `pixel_selection` instead of `pixel-selection` in endpoint parameters.","message":"The `pixel-selection` method is deprecated in favor of `pixel_selection` (underscore). Old parameter names will be removed in a future version.","severity":"deprecated","affected_versions":">=1.2.1"},{"fix":"Always include assets parameter in tile requests, e.g., `assets=:all:` or a comma-separated list.","message":"The `assets` parameter is now required for tile endpoints. Use `assets=:all:` to include all assets from the mosaic.","severity":"gotcha","affected_versions":">=2.0.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"Use: from titiler.mosaic.factory import MosaicTilerFactory","cause":"MosaicTilerFactory is in the factory submodule, not directly in titiler.mosaic.","error":"ImportError: cannot import name 'MosaicTilerFactory' from 'titiler.mosaic'"},{"fix":"Provide a reader class: MosaicTilerFactory(reader=MyReader)","cause":"In titiler-mosaic 2.0, reader argument is required.","error":"TypeError: MosaicTilerFactory.__init__() missing 1 required positional argument: 'reader'"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}