input.rst 2.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071
  1. MBTiles Raster and Vector Data Stores
  2. =====================================
  3. Adding an MBTiles Mosaic Raster Data Source
  4. -------------------------------------------
  5. When the extension has been installed, :guilabel:MBTiles` will be an option in the :guilabel:`Raster Data Sources` list when creating a new data store.
  6. .. figure:: images/mbtilescreate.png
  7. :align: center
  8. *MBTiles in the list of raster data sources*
  9. .. figure:: images/mbtilesconfigure.png
  10. :align: center
  11. *Configuring an MBTiles data source*
  12. .. list-table::
  13. :widths: 20 80
  14. * - **Option**
  15. - **Description**
  16. * - ``Workspace``
  17. - Name of the workspace to contain the MBTiles Mosaic store. This will also be the prefix of the raster layers created from the store.
  18. * - ``Data Source Name``
  19. - Name of the MBTiles Store as it will be known to GeoServer. This can be different from the filename.
  20. * - ``Description``
  21. - A full free-form description of the MBTiles store.
  22. * - ``Enabled``
  23. - If checked, it enables the store. If unchecked (disabled), no data in the GeoPackage Mosaic Store will be served from GeoServer.
  24. * - ``URL``
  25. - Location of the MBTiles file. This can be an absolute path (such as :file:`file:C:\\Data\\landbase.mbtiles`) or a path relative to GeoServer's data directory (such as :file:`file:data/landbase.mbtiles`).
  26. Adding an MBTiles vector tiles Data Store
  27. -----------------------------------------
  28. When the extension has been installed, :guilabel:`MBTiles with vector tiles` will be an option in the :guilabel:`Vector Data Sources` list when creating a new data store.
  29. .. figure:: images/mbtiles-vector-create.png
  30. :align: center
  31. *MBTiles in the list of vector data sources*
  32. .. figure:: images/mbtiles-vector-configure.png
  33. :align: center
  34. *Configuring an MBTiles data store*
  35. .. list-table::
  36. :widths: 20 80
  37. * - **Option**
  38. - **Description**
  39. * - ``database``
  40. - Path to the MBTiles file
  41. * - ``user``
  42. - Optional username
  43. * - ``passwd``
  44. - Optional password
  45. After configuration the store will allow setting up the layers, as they get described in the
  46. ``json`` entry of the `metadata table <https://github.com/mapbox/mbtiles-spec/blob/master/1.3/spec.md#content>`_.
  47. .. figure:: images/mbtiles-vector-layers.png
  48. :align: center
  49. *Configuring layers out of a MBTiles store*
  50. Each vector tile contains data for all the layers described, the store maintains a "soft cache" of parsed
  51. tiles to avoid re-parsing them from the binary on multi-layer rendering operations.