STREAMed DATA REQUESTS

Data streaming allows a faster delivery of the data. It enables immediate streaming of one dataset to the user's machine (instead of a file package being created on the CSA server and then sent). However, the following constraints apply:

  • Only CEF products can be downloaded using these requests

  • Only one dataset can be requested

  • Only one file is delivered for the time period requested, i.e. delivery interval option is not available

  • Header only cannot be requested

  • If the internet connection is broken before file download has completed, the request must be made again to retrieve the whole file

Note that authentication is not required.

 

The details of the request need to be built on the following base:

https://csa.esac.esa.int/csa-sl-tap/data?RETRIEVAL_TYPE=product&RETRIEVAL_ACCESS=streamed&

Then add the DATASET_ID, START_DATE and END_DATE details, which are also mandatory:

PARAMETER NAME(S)

DESCRIPTION

MANDATORY?

POSSIBLE VALUES

RETRIEVAL_TYPE

Type of retrieval. PRODUCT (Cluster data file) or HEADER

YES

PRODUCT or HEADER

RETRIEVAL_ACCESS

Type of retrieval access = STREAMED in this case

YES

STREAMED

DATASET_ID

Unique identifier of the dataset whose data we want to retrieve.
Please note that wild cards ('*') are NOT allowed since only one file/dataset is allowed.

YES

Any of the Cluster datasets.

START_DATE

Start time of the time range that the retrieved files should cover.

YES

ISO time format: 'yyyy-MM-ddTHH:mm:ssZ'

END_DATE

End time of the time range that the retrieved files should cover.

YES

ISO time format: 'yyyy-MM-ddTHH:mm:ssZ'

Unlike the direct and asynchronous requests, the request will be rejected if the start_date and end_date aren't included.

The only optional parameter is:

PARAMETER NAME(S)

DESCRIPTION

MANDATORY?

POSSIBLE VALUES

GZIP

Specifies if the retrieved file is gzip compressed or not. By default, "0"

NO

0 or 1

 

STREAMed USE CASES

Streamed UC1 - SIMPLE REQUEST

Request DWP caveats for time range '2007-01-15 18:00:00 / 2007-01-16 00:00:00'.

https://csa.esac.esa.int/csa-sl-tap/data?RETRIEVAL_TYPE=product&RETRIEVAL_ACCESS=streamed&DATASET_ID=C3_CQ_DWP_INST&START_DATE=2007-01-15T18:00:00Z&END_DATE=2007-01-16T00:00:00Z

 

Streamed UC2 - COMPRESSED

Request PEACE products for more than one month in compressed format:

https://csa.esac.esa.int/csa-sl-tap/data?RETRIEVAL_TYPE=product&RETRIEVAL_ACCESS=streamed&DATASET_ID=C4_CP_PEA_LERL_PSD&START_DATE=2004-09-18T10:00:00Z&END_DATE=2004-10-20T22:00:00Z&GZIP=1