Honua.Sdk.Catalogs 1.13.1

Honua.Sdk.Catalogs

REST clients for the Honua metadata catalog endpoints — both STAC (SpatioTemporal Asset Catalog) and OGC API Records. Single package, two standards-based read surfaces: landing pages, conformance, collections, item / record paging with bbox, datetime, and CQL2 filtering, GET and POST search with automatic next-link paging, and raw JSON escape hatches for extension fields not yet promoted to typed properties.

STAC types live under Honua.Sdk.Catalogs.Stac.* and OGC API Records types under Honua.Sdk.Catalogs.Records.*.

Part of the Honua .NET SDK — see the repo README for the full package catalog, browser/WASM support, authentication, and release policy.

Install

Stable releases are on nuget.org and install anonymously. An unversioned add resolves to the newest stable release (the current SDK version is in the repo README). Prereleases stay on the authenticated GitHub Packages feed; see INSTALL.md.

dotnet add package Honua.Sdk.Catalogs

STAC

using Honua.Sdk.Catalogs.Stac;
using Honua.Sdk.Catalogs.Stac.Extensions;
using Honua.Sdk.Catalogs.Stac.Models;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();
services.AddHonuaStac(o => o.BaseAddress = new Uri("https://your-honua-server"));
var provider = services.BuildServiceProvider();

var client = provider.GetRequiredService<IHonuaStacClient>();

var collections = await client.ListCollectionsAsync(cancellationToken);

await foreach (var page in client.SearchPagesAsync(
    new StacSearchQuery
    {
        Collections = ["sentinel-2-l2a"],
        Bbox = [-105.3, 39.9, -105.1, 40.1],
        Datetime = "2024-06-01T00:00:00Z/2024-09-01T00:00:00Z",
        Limit = 100,
    },
    cancellationToken))
{
    Console.WriteLine($"Page with {page.Features?.Count ?? 0} items");
}

OGC API Records

using Honua.Sdk.Catalogs.Records;
using Honua.Sdk.Catalogs.Records.Extensions;
using Honua.Sdk.Catalogs.Records.Models;
using Microsoft.Extensions.DependencyInjection;

var services = new ServiceCollection();
services.AddHonuaOgcRecords(o => o.BaseAddress = new Uri("https://your-honua-server"));
var provider = services.BuildServiceProvider();

var client = provider.GetRequiredService<IHonuaOgcRecordsClient>();

var collections = await client.ListCollectionsAsync(cancellationToken);

await foreach (var page in client.GetRecordsPagesAsync(
    "metadata",
    new OgcRecordsQuery
    {
        Query = "imagery",
        Bbox = [-180, -90, 180, 90],
        Limit = 50,
    },
    cancellationToken))
{
    Console.WriteLine($"Page with {page.Records?.Count ?? 0} records");
}

Documentation

• Quickstart
• Authentication
• Troubleshooting
• Metadata catalog parity

License

Apache 2.0