The discovery of data for tasking is done in two steps:
- List available tasking collections: a list of all available collections for tasking.
- 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.
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.
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.