Skip to main content
Sign in

Tasking and SAR Data Access Release Notes - 20 September 2023

  • Updated

New

Archive catalog image footprints file download

At this release, we are announcing two new Public API endpoints to provide users with the ability to download geospatial files of the image footprints in the Capella public archive. In the past, this information has only been available at the individual collect level through the Catalog API. Now, this data is provided in bulk for the entire Capella archive for exploration and analysis in third-party geospatial tools and applications.

New API endpoints in the Capella Catalog API:

api_summary.jpg

GET /catalog/archive-export/available

A call to GET https://api.capellaspace.com/catalog/archive-export/available returns the names of all archive catalog image footprint files available for download in a response like the following:

get_response.jpg

All files available for download are organized into three timescale groupings:

  • latest
    • All collects captured in latest 7-day rolling period
    • Updated daily at 10:00 UTC
  • weekly
    • All collects broken out by week of capture (Monday – Sunday) and listed chronologically
    • Latest 4 weeks are updated daily at 10:00 UTC (to account for new data that may enter the public archive from archive holdback)
  • full
    • All collects in the public archive
    • Updated weekly, Mondays at 10:00 UTC

And are provided in the following industry standard geospatial data formats:

  • GeoParquet
    • Apache Parquet is a powerful column-oriented data format, built from the ground up as a modern alternative to CSV files. GeoParquet is an incubating Open Geospatial Consortium (OGC) standard that adds interoperable geospatial types (Point, Line, Polygon)
  • GeoPackage
    • An open, standards-based, platform-independent, portable, self-describing, compact format for transferring geospatial information
  • Shapefile (in a compressed zip file)
    • Esri vector data storage format for storing the location, shape, and attributes of geographic features

 

POST /catalog/archive-export/presigned

A call to POST https://api.capellaspace.com/catalog/archive-export/presigned with a properly formed message body will return presigned URL links to download the requested archive catalog footprint file(s).

The message body can include three parameters:

  • exportType
    • Values:
      • latest
      • weekly
      • full
    • Required
  • exportFormat
    • Values:
      • geoparquet
      • gpkg
      • shp.zip
    • Optional
      • Not to be included if fileNames is specified
      • Must be included if fileNames is NOT specified
  • fileNames
    • List of specific file name(s) to download
    • Optional
      • Not to be included if exportFormat is specified
      • Must be included if exportFormat is NOT specified

Message body examples:

  • Signed URL for latest data file in GeoPackage format:

latest_gpkg.jpg

  • Signed URLs for all weekly files in GeoParquet format:

weekly_geoparquet.jpg

  • Signed URL for full data file in Shapefile format:

full_shp.jpg

  • Signed URL for a specific weekly file in GeoPackage format:

weekly_geopkg_2.jpg

Response example:

post_response.jpg

Response properties:

  • exportType
    • The type of export which describes the export timescale grouping
    • Values
      • latest
      • weekly
      • full
  • exportFile
    • The name of the file to be downloaded
  • downloadHref
    • The signed URL to download the file
    • The URL is valid for 1 hour after generation

All files contain the following information for each collect included in the export:

  • Collect footprint geometry
  • Collect metadata
    • id
      • Capella unique Collect ID
    • datetime
      • Datetime the collect was acquired
    • mode
      • Imaging mode of the collect
    • product types
      • List of image formats available for the collect
    • url
      • Link to view the collect in the Capella Console UI
    • SLC
      • STAC ID (unique name) of the SLC format for the collect (if available)
    • GEO
      • STAC ID (unique name) of the GEO format for the collect (if available)
    • GEC
      • STAC ID (unique name) of the GEC format for the collect (if available)
    • SICD
      • STAC ID (unique name) of the SICD format for the collect (if available)
    • SIDD
      • STAC ID (unique name) of the SIDD format for the collect (if available)
    • CPHD
      • STAC ID (unique name) of the CPHD format for the collect (if available)

map.jpg

 

Improved

  • Task rejections due to an inactive contract period now include a message explaining the reason for the rejection
  • Product Category is now available as an optional column to display in the Tasks table
  • The Parent Organization Name for a user in a child organization is now viewable in the User Profile page (in addition to the child organization name) to show the organization relationship
  • The Pending Calculation display message on the Task Details page has been updated and a Reload Page button added
  • The Data Licensing link on the User Profile page now opens in a separate browser window
  • Custom Attribute 1 and Custom Attribute 2 have been added as optional columns to display in the Tasks table

 

Fixed

  • Tasks table CSV download now properly handles embedded commas in field values
  • Tasking Service API documentation changes
    • POST /task
      • preApproval parameter added to properties object
      • skipBilling parameter removed from properties object
      • billingEnvironment parameter removed from properties object
      • Schema updated to be a single CAPITaskingRequest schema for simplicity, not be broken out by product category. Underlying properties remain the same.
    • PATCH /task/{taskingrequestId}/status
      • Example Value corrected to be in the format of an object      
      • Schema corrected to be an object
    • GET /tiles/list/accessrequest/{accessrequestId}
      • Added to the documentation

Related articles