Enhance documentation for STAC integration and Zarr asset access#130
Enhance documentation for STAC integration and Zarr asset access#130emmanuelmathot wants to merge 2 commits intomainfrom
Conversation
|
Maybe add @ahocevar to the reviewers as the OpenLayers GeoZarr source options were the initial starting point for the reverse parsing. |
ahocevar
left a comment
There was a problem hiding this comment.
I added two comments to improve confusing parts of this documentation.
This is also to be seen in the context of openlayers/openlayers#17378, which suggests removing the group option of the OpenLayers GeoZarr source, in favor of providing a url that points to the multiscales root.
|
|
||
| ``` | ||
| ✅ s3://bucket/S2A_MSIL2A_20251008T100041.zarr/measurements/reflectance/r10m | ||
| ❌ s3://bucket/S2A_MSIL2A_20251008T100041.zarr/measurements.zarr/reflectance |
There was a problem hiding this comment.
This is confusing, because s3://bucket/S2A_MSIL2A_20251008T100041.zarr/measurements/reflectance/r10m does not have consolidated metadata. I'd suggest changing to
| ❌ s3://bucket/S2A_MSIL2A_20251008T100041.zarr/measurements.zarr/reflectance | |
| ✅ s3://bucket/S2A_MSIL2A_20251008T100041.zarr/measurements/reflectance | |
| ❌ s3://bucket/S2A_MSIL2A_20251008T100041.zarr/measurements.zarr/reflectance |
| Zarr is a **key/value store protocol**, not a file format. Crucially for clients, this means that **any Zarr group path is itself a valid store entry point**. A URL like: | ||
|
|
||
| ``` | ||
| s3://bucket/S2A_MSIL2A_20251008T100041.zarr/measurements/reflectance/r10m |
There was a problem hiding this comment.
This is confusing in the context of multiscales. Clients that support multiscales should receive asset urls with the available multiscales below them:
s3://bucket/S2A_MSIL2A_20251008T100041.zarr/measurements/reflectance
Update architecture and examples to clarify how STAC assets relate to Zarr stores, emphasizing direct access to Zarr groups and the importance of consolidated metadata. Include guidance on URL resolution and the role of the
rel: storelink.Fixes #124