how add a new collection to an STAC catalog eoAPI?

[automataIA]

I'm using python. How to add a new collection(empty collection) to an existing STAC catalog created with docker compose custom eoAPI, via python?
And then, how do you add the items(json, dict) to the collection? in the 'cleanest' way possible?

[zacharyDez]

Hi @automataIA! The answer depends on a few things, but have you checked out the examples in https://github.com/vincentsarago/MAXAR_opendata_to_pgstac to get started? The best practice is using pystac to build your catalog with something like this example for Maxar. Then, you can use pypgstac load collections collections.json --dsn postgresql://username:[email protected]:5439/postgis --method insert_ignore.

Would you like to add new items to the collections as new assets becomes available?

[XinboEddie]

Is there an alternative API method? @vincentsarago

[vincentsarago]

@XinboEddie depends if you allowed the Transaction Extension to you stac endpoints

[XinboEddie]

Is there a documentation for enabling the Transaction extension? I was looking at the repos and didn't find any... this is exactly what I'm looking for and thanks for mentioning this! @vincentsarago

[zacharyDez]

Hi Xinbo! Here's a link to the collection transaction extension: https://github.com/stac-api-extensions/collection-transaction, and the transaction extension (items): https://github.com/stac-api-extensions/transaction

[vincentsarago]

@XinboEddie by default no extensions are enabled

you can see how we customize our devseed eoapi application to enable/disable extensions

https://github.com/developmentseed/eoapi-devseed/blob/main/runtimes/eoapi/stac/eoapi/stac/app.py#L45C1-L77

but if you just need to enable the transaction extension you'll do something like

api = StacApi(
    extensions=[
        TransactionExtension(
            client=TransactionsClient(),
            settings=settings,
            response_class=ORJSONResponse,
        )
    ],
    ...
)