Data Portal Upgrade Guide

On 18 October 2024 we have deployed a major update to the S5P-PAL Data Portal.

Most changes only affact the browsing interface, but if you are using the STAC API in your scripts, you should be aware of two breaking API changes:

  1. A redesign of the Data Portal STAC API paths

    Although the STAC API itself did not functionally change, the paths to the L2 and L3 catalogs have moved from the old:

    https://data-portal.s5p-pal.com/api/s5p-l2/collection.json
    and
    https://data-portal.s5p-pal.com/api/s5p-l3/collection.json

    to:

    https://data-portal.s5p-pal.com/api/s5p-l2
    and
    https://data-portal.s5p-pal.com/api/s5p-l3
  2. Removal of hierarchical browsing

    Previously, we had a static hierarchy of collections based on year, month, and day filters. This static hierarchy is gone, and, with it, these collections, such as:

    https://data-portal.s5p-pal.com/api/s5p-l2/L2__TCWV__/2024/1/27/collection.json

    If you had scripts that relied on these date-specific collections, we recommend that you replace those scripts with temporal search URLs, e.g. (URL decoded for readability):

    https://data-portal.s5p-pal.com/api/s5p-l2/collections/L2__TCWV__/items?datetime=2024-01-27T00:00:00.000Z/2024-01-28T00:00:00.000Z&limit=14

    This query will return the same set of items, albeit not as a Collection object, but rather as an ItemCollection object.


On 18 March 2024 we have deployed a major update to the S5P-PAL Data Portal. New features include:

  • A new version of the S5P-PAL mapping portal that includes maps of all S5P-PAL L2 products.
  • The addition of an L3 catalog to the data-portal, providing full download access to the grid files underlying these maps.

The update also introduces two backwards-incompatible changes that may break existing download scripts for L2 products.

  1. A redesign of the Data Portal STAC API paths

    Although the STAC API itself will not functionally change, the paths to and the names of the L2 catalog are moving from the current:

    https://data-portal.s5p-pal.com/cat/sentinel-5p/catalog.json

    to:

    https://data-portal.s5p-pal.com/api/s5p-l2/collection.json

    Note: in addition to the URL path change (from cat/sentinel-5p> to api/s5p-l2), we have also renamed catalog.json to collection.json throughout to be more in line with STAC API best practices.

  2. Product type renaming

    The current S5P_ prefix will be removed from the product_type metadata attribute of all S5P-PAL products in the L2 catalog. E.g. S5P_L2__AER_OT will become L2__AER_OT.

    This renaming implies that if you were using S5P_<product_type> strings in your scripts to e.g. browse, filter results, or construct collection search endpoints, those occurrences will need to be updated as well.

Support

Questions regarding this service can be send to the ESA EO Support Helpdesk.

This service is provided as part of the Sentinel-5P Product Algorithm Laboratory (S5P-PAL) and contains modified Copernicus Sentinel data processed by S[&]T.