Discover collections

Discover tasking collections using the API.


Data collection and product list for tasking

Overview

The discovery of data for tasking is done in two steps:

  1. List available tasking collections: a list of all available collections for tasking.
  2. List available data products for a given collection: Once a data collection is chosen get a list of all available products for that particular collection.

The list of data products is dependent on the data collection. I.e., different collections offer different data products.

List tasking collections

Issuing the following command lists all available tasking collections name.

curl -s -L -X GET -H "Authorization: Bearer $PTOKEN" \
https://api.up42.com/collections | jq -r \
'.data[] | select(.type=="TASKING") | .name'

And the corresponding output:

capella-tasking
PHR-tasking
SPOT-tasking
pneo-tasking

To get a combination of names and descriptions, we do:

curl -s -L -X GET -H "Authorization: Bearer $PTOKEN" \
https://api.up42.com/collections | jq -r \
'.data[] | select(.type == "TASKING") | [.name, .description] | @csv'

Producing the output shown on this Gist.

Once we decide on a given data collection for tasking we need to next choose the data products we want to request when tasking.

List data products

Let us consider that we want to task the Pléiades Neo constellation.

To filter all the available data products for the corresponding data collection, we do:

curl -s -L -X GET -H "Authorization: Bearer $PTOKEN" \
https://api.up42.com/data-products | jq -r --arg col "pneo-tasking" \
'.data[] | select(.collectionName == $col) | .productConfiguration | [.id, .title, .description] | @csv'

The output is listed here.

Now you can place an order using the API.