Assets API

Assets are data from completed tasking and catalog orders that you can download.

The following order statuses mean you can download assets from storage:

• BEING_FULFILLED: Some order assets might have been delivered.
• FULFILLED: All order assets have been delivered.

You can generate a pre-signed URL to download an asset without authentication by calling the Create a download URL endpoint with the asset ID as the path parameter. The generated URL is valid for 5 minutes and can be shared. The URL will have the following format:

1
{
2
  "url": "https://storage.googleapis.com/user-storage-interstellar-prod/assets/<...>"
3
}

To get a streaming link for transformed assets, use STAC API endpoints as follows:

1. Find a STAC item containing a geospatial feature you want to stream. To search for STAC items with specific parameters across your storage, call the Get specific STAC items endpoint with your search parameters in the request body.

2. Inside a STAC item, view the assets object:

   1
   {
   2
     <...>,
   3
     "type": "FeatureCollection",
   4
     "features": [
   5
       {
   6
         "assets": {
   7
           "aot.tiff": {
   8
             "href": "https://api.sa.up42.com/v2/assets/a0d443a2-41e8-4995-8b54-a5cc4c448227",
   9
             "title": "Aerosol optical thickness",
   10
             "description": null,
   11
             "type": "image/tiff; application=geotiff; profile=cloud-optimized",
   12
             "roles": [
   13
               "data"
   14
             ]
   15
           },
   16
           "b01.tiff": {
   17
             "href": "https://api.sa.up42.com/v2/assets/55434287-31bc-3ad7-1a63-d61aac11ac55",
   18
             "title": "Costal aerosol band",
   19
             "description": null,
   20
             "type": "image/tiff; application=geotiff; profile=cloud-optimized",
   21
             "roles": [
   22
               "data"
   23
             ]
   24
           }
   25
         }
   26
       }
   27
     ],
   28
     <...>
   29
   }

3. Find the assets you want to stream and extract their IDs from the nested assets.<asset-name>.href parameter. For example:

   "href": "https://api.sa.up42.com/v2/assets/a0d443a2-41e8-4995-8b54-a5cc4c448227"
   ↓
   Asset ID: a0d443a2-41e8-4995-8b54-a5cc4c448227

4. To get a streaming link, call the Create a download URL endpoint with the chosen ID as the path parameter. The response will have the following format:

   1
   {
   2
     "url": "https://storage.googleapis.com/user-storage-interstellar-prod/assets/<...>"
   3
   }

5. Paste the streaming link into a third-party application or visualization software — for example, QGIS.

The status of the CNAM transformation or geospatial metadata extraction indicates the progress and outcome of transforming the asset’s metadata for CNAM compatibility. Only transformed assets can be accessed through  Data management → Map.