README

The Copernicus Data Space Ecosystem's STAC catalogue for omnisense/omnilab: the products of Sentinel-1, -2, -3, -5P and -6, Landsat, MODIS, the Copernicus DEM and the Copernicus services, searched by collection, point or box, period and cloud cover, page by page - their footprint, properties, assets and thumbnail. Searching needs no account.

$copernicus = (new CopernicusSourceFactory($http))->create();
$page = $copernicus->products(new ProductQuery(['sentinel-2-l2a'], new Point(48.5734, 7.7521), new \DateTimeImmutable('-10 days'), maxCloudCover: 30));
foreach ($page as $scene) {
    $scene->datetime;                        // 2026-10-12T10:29:11Z
    $scene->cloudCover();                    // 1.84
    $scene->properties['grid:code'];         // MGRS-32ULU
    $scene->preview;                         // an open thumbnail
    $scene->asset('TCI_10m')->href;          // s3://eodata/...: kept as the catalogue gives it
    $scene->asset('TCI_10m')->httpsHref();   // https://download.dataspace.copernicus.eu/...: needs a token
}
$copernicus->products($query->with(['cursor' => $page->next]));

omnilab:
    sources:
        copernicus:
            factory: copernicus
            options:
                collections: [sentinel-2-l2a]    # what a query that names none searches

Downloading: out of scope

Every asset's address is kept: an s3://eodata/... one (the CDSE S3 endpoint, with S3 keys) and an https://download.dataspace.copernicus.eu/... alternate. Reading either needs a free CDSE account: an access token from https://identity.dataspace.copernicus.eu/auth/realms/CDSE/protocol/openid-connect/token sent as Authorization: Bearer - by the application, with its own HTTP client. This package searches only, and has no token option: a token would be an account's secret in the source's configuration for no call it makes. The thumbnail ($product->preview) is open.

Terms of use

The catalogue is open. The Sentinel data are free and open to all under the Sentinel data legal notice (credit "contains modified Copernicus Sentinel data [year]"); the other collections carry their own licences (each collection's license link); the Data Space's terms and conditions and quotas apply.

See docs/.

Responsibility

This package is an independent, unofficial client: it is not affiliated with, endorsed by or sponsored by the Copernicus programme and its data providers. It reaches their service on behalf of whoever runs it, and it does not redistribute their data beyond the short excerpts recorded as test fixtures. Its MIT licence covers this package's code only and grants no right to the service or to its data.

Whoever installs and runs this package is responsible for complying with the terms above, for obtaining whatever they require (an account, a key, a licence or subscription, an attribution or a citation, a rate limit to respect), and for any use made of what it returns. The authors publish it free of charge, make no commercial use of it, and accept no liability for how it is used (see LICENSE).

License: MIT.