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

Closed
m-mohr opened this issue Feb 22, 2024 · 1 comment · Fixed by #1291
Closed

Clarify difference between thumbnail and overview #1272

m-mohr opened this issue Feb 22, 2024 · 1 comment · Fixed by #1291
Assignees
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.

@emmanuelmathot emmanuelmathot self-assigned this Jun 27, 2024
m-mohr added a commit that referenced this issue Jun 27, 2024
m-mohr added a commit that referenced this issue Jun 27, 2024
m-mohr added a commit that referenced this issue Jun 27, 2024
m-mohr added a commit that referenced this issue Jun 27, 2024
@m-mohr m-mohr linked a pull request Jun 27, 2024 that will close this issue
4 tasks
m-mohr added a commit that referenced this issue Jun 28, 2024
@m-mohr m-mohr closed this as completed Jun 28, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants