CODE-DE Datenkatalog-Änderung Benutzerinformationen

Sehr geehrte Kunden,
Wir freuen uns, die Einführung der neuen API für den CODE-DE- und EO-Lab-Datenkatalog bekannt zu geben!

Am 26. Oktober 2023 ist zwischen 8:00 und 18:00 Uhr (MESZ) ein Wartungsfenster geplant, in dem die Umstellung vom alten auf den neuen Katalog wirksam wird. Bitte beachten Sie, dass es während dieser Zeit zu Unregelmäßigkeiten oder Service Unterbrechungen kommen kann. Diese Maßnahme ist jedoch notwendig, um den erfolgreichen Technologiewechsel gewährleisten zu können. Die Arbeiten können den ganzen Tag dauern, werden aber spätestens um 18:00 Uhr abgeschlossen sein.

Die neue Katalog-API ermöglicht eine erweiterte Suche im CODE-DE- und EO-Lab Datenkatalog in drei bekannten Standards: Odata, RESTO Open Search und STAC.

Für den Zugriff auf die alten Daten im Katalog kann weiterhin die alte Finder-API (RESTO) verwendet werden. Auf neue Produkte kann nur über die neuen Katalog-APIs zugegriffen werden.

Benutzer können unter folgenden Links auf die neuen Schnittstellen zugreifen:

Für CODE-DE:

• ODATA: https://datahub.code-de.org/odata/v1/Products?
• RESTO: https://datahub.code-de.org/resto/api/collections/Sentinel1/search.json?
• STAC: https://datahub.code-de.org/stac/

Für EO-Lab:

• Odata: https://datahub.eo-lab.org/odata/v1/Products?
• RESTO: https://datahub.eo-lab.org/resto/api/collections/Sentinel1/search.json?
• STAC: https://datahub.eo-lab.org/stac/

Benutzern wird empfohlen, auf die Odata-Schnittstelle zu migrieren, da dies die effizienteste Option ist.

Die neue Katalog-API basiert auf einer völlig neuen Datenbank, die an das Produkt-Metadaten-Mapping der Europäischen Weltraumorganisation (ESA) angepasst wurde. Daher wurden Attribute, insbesondere für Sentinel-Daten, neu organisiert und umbenannt, um sie an die offizielle ESA-Dokumentation anzupassen. Diese neuen Attributnamen (z. B. productType) und Werte (z. B. GRD) sind in den Odata- und STAC-Schnittstellen vorhanden. Um die Abwärtskompatibilität zu gewährleisten, können in der RESTO-Schnittstelle sowohl alte als auch neue Attributnamen verwendet werden, es können jedoch nur neue Werte ausgewählt werden.

Die Details zu den Werten der neuen Attribute finden Sie auch unter RESTO describe Endpoints (z. B. für CODE -DE https://datahub.code-de.org/resto/api/collections/Sentinel1/describe.xml und für EO-Lab https://datahub.eo-lab.org/resto/api/collections/Sentinel1/describe.xml ).

Des Weiteren haben wir die Attributänderungen in der Tabelle hier zum Download für Sie zusammengefasst.

Die neue Catalog-RESTO-Schnittstelle wahrt die Abwärtskompatibilität mit der alten RESTO (Finder) API in Bezug auf:

• Query structure
• Names of search options
• Names of products' attributes
• Response structure in json

Es besteht keine Abwärtskompatibilität hinsichtlich der Attributwerte (z. B. Level 2A, L2 usw.).

Die folgenden Funktionen sind veraltet und werden nicht verfügbar sein:

• Natural Language Queries
• Query response in XML
• Pretty_query
• Search.path