Skip to content

Commit 8573efd

Browse files
committed
Mention PMTiles and specifically call out bbox and geometry
1 parent a0b54db commit 8573efd

1 file changed

Lines changed: 5 additions & 1 deletion

File tree

best-practices-item.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -105,7 +105,8 @@ Many implementors are tempted to use STAC to describe vector layers, putting a [
105105
file as the asset. This has proven to be useful as long as the asset represents a group of features rather
106106
than one particular feature. For instance this could be a useful way to distribute a buildings dataset where there is one
107107
GeoParquet file containing all the buildings within each particular region. In that case there would be an item for each region
108-
and each item would contain an asset pointing to the GeoParquet file. Alternatively to distribute a single file that contains
108+
and each item would contain an asset pointing to the GeoParquet file. To ensure that people can find the item of interest, be sure
109+
to include the bounding box and geometry footprint in the STAC metadata for each item. Alternatively to distribute a single file that contains
109110
all the features in a dataset create a collection with one asset at the collection or item level.
110111

111112
> [!NOTE]
@@ -115,6 +116,9 @@ all the features in a dataset create a collection with one asset at the collecti
115116
The [Table extension](https://github.com/stac-extensions/table) has proven to be useful to describe the contents
116117
of those file formats and should be provided within the asset metadata.
117118

119+
To facilitate visualization, it can be useful to include an asset that refers to a [PMTiles](https://github.com/protomaps/PMTiles)
120+
representation of each group of vectors. This asset would have the role "visual" and would exist alongside the "data" assets.
121+
118122
If you want the individual vectors to be accessible individually, the ideal approach
119123
is to serve it with [OGC API - Features](https://github.com/opengeospatial/ogcapi-features) standard. This
120124
allows each feature in the dataset (GeoParquet, Shapefile, etc.) to be represented online, and enables

0 commit comments

Comments
 (0)