CODE-DE Datenkatalog-Änderung - Nutzerinformationen

CODE-DE Datenkatalog-Änderung - Nutzerinformationen  

  Von: Support-Team. am 26. Oktober 2023 14:57

Sehr geehrte Kunden,

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

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:
https://cloud.code-de.org:8080/swift/v1/AUTH279dbc97d5b5434fa8aeacf09c08c520/portalprod/media/filerpublic/a8/72/a872bbde-859a-44fe-a31d-3a33b8653471/20231025referencetableforproducttypeattributechangesinthenewcatalogueapiforcode-deand_eo-lab.pdf

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

Mit freundlichen Grüßen,
Ihr CODE-DE Team

Re: CODE-DE Datenkatalog-Änderung - Nutzerinformationen  

  Von: PhilippG am 14. Februar 2024 16:44

Liebes CODE-DE Team,

ich habe zwei Fragen:
1) ich nutze das QGIS Plugin - "STAC API Browser" um die Metadaten vom CODE-DE Datenkatalog anzusehen. Ich kann zwar eine valide Verbindung zu https://datahub.code-de.org/stac/ herstellen. Leider werden keine Collections angezeigt. Können Sie mir hier eventuell weiterhelfen?
2) Wenn ich z.B. die SENTINEL-1 Collection Metadaten im Browser ansehe (https://datahub.code-de.org/stac/collections/SENTINEL-1/items) dann fällt auf, dass diese nicht dem Muster in https://code-de.org/de/portfolio/?q=Sentinel-1 entsprechen, bzw. nur ein Bruchteil der tatsächlich vorhandenen Daten im STAC auftauchen. Beziehen sich die STAC Infos möglicherweise auf andere Daten?
Mit freundlichen Grüßen