Skip to content

Update Hateoas Provider to Align with STAC Best Practices - #15

Merged
rajadain merged 2 commits into
deployfrom
kb/hateoas-stac-fix
Sep 24, 2026
Merged

rajadain merged 2 commits into
deployfrom
kb/hateoas-stac-fix

Conversation

@kieranbartels

Copy link
Copy Markdown
Member

Fixes #2404: HateoasProvider doesn't support STAC best-practices and breaks with shared-folder item layouts

Quick Overview: USGS restructured their STAC catalog to group items under a shared directory instead of each item having its own subdirectory. The upstream Hateoas provider doesn't support that file structure, but STAC's catalog-layout best practices explicitly allow this shared-directory structure.

This PR:

  • Builds item hrefs from the link's basename, not a fixed path segment
  • Supports both forms of file structure

Related Issue / discussion

https://code.usgs.gov/wma/nhgf/pygeoapi/-/merge_requests/159 (internal USGS deployment MR, linked for LimnoTech context): links the staging STAC branch to QA and main to production, to ensure a breakage doesn't happen again.

Additional information

Geopython pygeoapi doesn't have a test file for Hateoas provider (it does for other providers). That should be implemented in the future.

kieranbartels and others added 2 commits September 18, 2026 15:33
USGS restructured their STAC catalog to group items under a shared
directory instead of each item having its own subdirectory.

This commit:
- Builds item hrefs from the link's basename, not a fixed path segment
- Supports both forms of file structure
@rajadain

Copy link
Copy Markdown
Collaborator

Nice work! I'm going to merge this into deploy so we can get this loaded into the USGS Staging Site.

@rajadain
rajadain merged commit 1e5ea43 into deploy Sep 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants