{"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,"search_vec":"'2.0.1':13 'activ':14 'allow':16 'cogeo':9,26 'cogeo-mosa':8 'creat':17 'develop':15 'document':23 'endpoint':19 'fastapi':27 'json':22 'mosaic':3,10,21,24 'mosaicjson':7 'plugin':5 'support':11 'tile':18,25 'titil':2,4 'titiler-mosa':1 'version':12","created_at":"2026-05-01T17:46:22.132079+00:00","updated_at":"2026-05-01T17:46:22.132079+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":null,"cli_name":"","cli_version":null,"type":"library","homepage":"https://developmentseed.org/titiler/","github":"https://github.com/developmentseed/titiler","docs":"https://developmentseed.org/titiler/","changelog":"https://developmentseed.org/titiler/release-notes/","pypi":"https://pypi.org/project/titiler-mosaic/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data","web-framework","http-networking"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-28","last_verified":"2026-06-28","next_check":"2026-07-28","install_tag":null}}