Analytic products are available as GeoTIFF images. There are a number of image "assets" produced each time the analytic algorithms run. Each product contains the following assets.
Note: the term "asset" in this case is a reference to a change map GeoTIFF file.
Analytic products are part of the Area of Interest (AOI). To obtain links for downloading products, first obtain the product details using the /products{{aoi_id}} endpoint. Within the response is a "products" section with some metadata and assets listed. There are likely many products available, especially if continuous monitoring is enabled for the AOI as a new product will generate each time new data becomes available.
The URL's provided in this response do not point directly at the asset. Calling these URLs will return a "signed url" which provides authenticated access to download the product.
In the example below, to obtain the A.tif product created 2020-06-12 22:06:57, first call the provided URL:
"href": "https://yfjkzab738.execute-api.us-west-2.amazonaws.com/uat/asset/
authorize/0bdede89-4e63-479e-9e82-20a1085f3865/
4135d7b3-c5e0-4170-adf9-eb65299b3352/A.tif",
The response from the above endpoint includes a signed url that may be used to directly download the A.tif file.
https://change-monitoring-uat-storage.s3.amazonaws.com/
2dcaa602-0525-4eec-8451-ec07aa7ba438/1c0dc02b-68ee-433d-a1cf-4f93a9dcfc0d/
A.tif?AWSAccessKeyId=xxxxxx
Product portion of the /aoi response:
"products": [ { "id": "4135d7b3-c5e0-4170-adf9-eb65299b3352", "job_id": "0bdede89-4e63-479e-9e82-20a1085f3865", "aoi_id": "58045dcd-77c9-4097-82eb-710181e3e58f", "user_id": "4d457ecc-7bbb-45f0-a9ae-b4fbf5f8609f", "date_created": "2020-06-12 22:06:57", "snapshots_processed": null, "date_start": "2019-05-27", "date_end": "2020-05-27", "collection_searched": "sentinel-s1-l2", "method_applied": "cov", "assets": { "a": { "href": "https://yfjkzab738.execute-api.us-west-2.amazonaws.com/
uat/asset/authorize/0bdede89-4e63-479e-9e82-20a1085f3865/
4135d7b3-c5e0-4170-adf9-eb65299b3352/A.tif", "type": "image/tiff; application=geotiff;", "roles": [ "data" ], "title": "VV" }, "b": { "href": "https://yfjkzab738.execute-api.us-west-2.amazonaws.com/
uat/asset/authorize/0bdede89-4e63-479e-9e82-20a1085f3865/
4135d7b3-c5e0-4170-adf9-eb65299b3352/B.tif", "type": "image/tiff; application=geotiff;", "roles": [ "data" ], "title": "VH" }, "a_cog": { "href": "https://yfjkzab738.execute-api.us-west-2.amazonaws.com/uat/
asset/authorize/0bdede89-4e63-479e-9e82-20a1085f3865/
4135d7b3-c5e0-4170-adf9-eb65299b3352/A_cog.tif", "type": "image/tiff; application=geotiff; profile=cloud-optimized", "roles": [ "data" ], "title": "VV" }, "b_cog": { "href": "https://yfjkzab738.execute-api.us-west-2.amazonaws.com/
uat/asset/authorize/0bdede89-4e63-479e-9e82-20a1085f3865/
4135d7b3-c5e0-4170-adf9-eb65299b3352/B_cog.tif", "type": "image/tiff; application=geotiff; profile=cloud-optimized", "roles": [ "data" ], "title": "VH" },
Accessing the data used to generate change map results
Within the "products" section, the original input used to generate change maps is available. This is found using the "stac_item_ref" key.
"stac_item_ref": "https://yfjkzab738.execute-api.us-west-2.amazonaws.com/uat/
catalog/collections/s1-change/items/4135d7b3-c5e0-4170-adf9-eb65299b3352", "stac_item_generated": null, "window_in_months": 12
This URL points to the SAR image used to process the change result.