Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Clarify difference between thumbnail and overview #1272

Open
m-mohr opened this issue Feb 22, 2024 · 1 comment
Open

Clarify difference between thumbnail and overview #1272

m-mohr opened this issue Feb 22, 2024 · 1 comment
Milestone

Comments

@m-mohr
Copy link
Collaborator

m-mohr commented Feb 22, 2024

The STAC Browser implementation assumes the following with regards to the roles overview and thumbnail:

  • Thumbnails do not necessarily fit to the extent of the geometry. As such thumbnails are not shown on the map, instead they are just shown as normal images embedded in HTML.
  • Overviews usually fit to the extento of the geometry. As such overviews are shown on the map.

Is this understanding of the spec correct? Should we clarify that?

@m-mohr m-mohr added this to the 1.1 milestone Feb 22, 2024
@m-mohr
Copy link
Collaborator Author

m-mohr commented Feb 22, 2024

From a recent conversation:

If role "thumbnail" is set for a PNG/JPEG image, it doesn't show it on the map. The reason is that thumbnails often don't actually fit to the actual extent of the geometry. Let's say you have a worldwide collection with a thumbnail that only covers a small selected area, you don't want to stretch that incorrectly over the whole globe. You could use the role "overview" if you are sure that placing the image on the map makes sense.
Having that said, that's how STAC Browser behaves. I'm not 100% certain whether the implementation in STAC Browser actually is really how it was meant to be. The spec seems ambiguous about it.

I made a small adjustment to STAC Browser. Follow this:

  • If you want to display the JPEG/PNG image on the map use overview and thumbnail as roles.
  • If you don't want to display the JPEG/PNG image on the map (often for collections), use only thumbnail as role.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

1 participant