add Alternate URL

[vincentsarago]

By default we use HTTPS url, but if the STAC API is on AWS and the tiler is also on AWS it would be better to use s3:// url

Here is how to update the items.json to add S3 url and add an alternate https url

import json

with open("items.json") as fin:
    with open("items_s3.json", "w") as fou:
        for it in fin.readlines():
            item = json.loads(it.rstrip("\n"))
            item["stac_extensions"].append("https://stac-extensions.github.io/alternate-assets/v1.1.0/schema.json")
            for asset in item["assets"]:
                ori = item["assets"][asset]["href"]
                item["assets"][asset]["href"] = ori.replace("https://maxar-opendata.s3.amazonaws.com", "s3://maxar-opendata")
                item["assets"][asset]["alternate"] = {
                    "public": {
                        "title": "Public Access",
                        "href": ori,
                    }
                }
            fou.write(json.dumps(item) + "\n")

cat items_s3.json| head -n 1 | jq
{
  "type": "Feature",
  "stac_version": "1.0.0",
  "id": "46_033111333120_104001008216D000",
  "properties": {
    "datetime": "2023-02-17T04:34:35Z",
    "platform": "WV03",
    "gsd": 0.32,
    "ard_metadata_version": "0.0.1",
    "catalog_id": "104001008216D000",
    "utm_zone": 46,
    "quadkey": "033111333120",
    "view:off_nadir": 12.8,
    "view:azimuth": 312,
    "view:incidence_angle": 75.9,
    "view:sun_azimuth": 144.4,
    "view:sun_elevation": 51.1,
    "proj:epsg": 32646,
    "proj:geometry": {
      "type": "Polygon",
      "coordinates": [
        [
          [
            483588.8671875,
            2268416.4428710938
          ],
          [
            483862.60986328125,
            2268394.4702148438
          ],
          [
            484230.65185546875,
            2268403.6254882812
          ],
          [
            484588.92822265625,
            2268379.2114257812
          ],
          [
            485156.25,
            2268366.69921875
          ],
          [
            485156.25,
            2264843.75
          ],
          [
            483605.65185546875,
            2264843.75
          ],
          [
            483605.04150390625,
            2267459.1064453125
          ],
          [
            483588.8671875,
            2268416.4428710938
          ]
        ]
      ]
    },
    "grid:code": "MXRA-Z46-033111333120",
    "proj:bbox": [
      483588.8671875,
      2264843.75,
      485156.25,
      2268416.4428710938
    ],
    "tile:data_area": 5.5,
    "tile:clouds_area": 0,
    "tile:clouds_percent": 0
  },
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          92.84259615375773,
          20.514418665444474
        ],
        [
          92.84522188992554,
          20.51422247931915
        ],
        [
          92.84875179046215,
          20.514308319970347
        ],
        [
          92.85762974718072,
          20.51398215957682
        ],
        [
          92.85765914227906,
          20.482148269974356
        ],
        [
          92.84279006439591,
          20.482135453600524
        ],
        [
          92.84276011478431,
          20.505768190589983
        ],
        [
          92.84259615375773,
          20.514418665444474
        ]
      ]
    ]
  },
  "links": [],
  "assets": {
    "data-mask": {
      "href": "s3://maxar-opendata/events/BayofBengal-Cyclone-Mocha-May-23/ard/46/033111333120/2023-02-17/104001008216D000-data-mask.gpkg",
      "type": "application/geopackage+sqlite3",
      "title": "Data Mask",
      "roles": [
        "data-mask"
      ],
      "alternate": {
        "public": {
          "title": "Public Access",
          "href": "https://maxar-opendata.s3.amazonaws.com/events/BayofBengal-Cyclone-Mocha-May-23/ard/46/033111333120/2023-02-17/104001008216D000-data-mask.gpkg"
        }
      }
    },
    "ms_analytic": {
      "href": "s3://maxar-opendata/events/BayofBengal-Cyclone-Mocha-May-23/ard/46/033111333120/2023-02-17/104001008216D000-ms.tif",
      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
      "title": "Multispectral Image",
      "proj:bbox": [
        479843.75,
        2264843.75,
        485156.25,
        2270156.25
      ],
      "proj:shape": [
        4142,
        4142
      ],
      "proj:transform": [
        1.2825929502655722,
        0,
        479843.75,
        0,
        -1.2825929502655722,
        2270156.25,
        0,
        0,
        1
      ],
      "eo:bands": [
        {
          "name": "BAND_C",
          "common_name": "coastal",
          "description": "Coastal Blue"
        },
        {
          "name": "BAND_B",
          "common_name": "blue",
          "description": "Blue"
        },
        {
          "name": "BAND_G",
          "common_name": "green",
          "description": "Green"
        },
        {
          "name": "BAND_Y",
          "common_name": "yellow",
          "description": "Yellow"
        },
        {
          "name": "BAND_R",
          "common_name": "red",
          "description": "Red"
        },
        {
          "name": "BAND_RE",
          "common_name": "rededge",
          "description": "Red Edge 1"
        },
        {
          "name": "BAND_N",
          "common_name": "nir08",
          "description": "Near Infrared 1"
        },
        {
          "name": "BAND_N2",
          "common_name": "nir09",
          "description": "Near Infrared 2"
        }
      ],
      "roles": [
        "data"
      ],
      "alternate": {
        "public": {
          "title": "Public Access",
          "href": "https://maxar-opendata.s3.amazonaws.com/events/BayofBengal-Cyclone-Mocha-May-23/ard/46/033111333120/2023-02-17/104001008216D000-ms.tif"
        }
      }
    },
    "pan_analytic": {
      "href": "s3://maxar-opendata/events/BayofBengal-Cyclone-Mocha-May-23/ard/46/033111333120/2023-02-17/104001008216D000-pan.tif",
      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
      "title": "Panchromatic Image",
      "proj:bbox": [
        479843.75,
        2264843.75,
        485156.25,
        2270156.25
      ],
      "proj:shape": [
        16568,
        16568
      ],
      "proj:transform": [
        0.32064823756639305,
        0,
        479843.75,
        0,
        -0.32064823756639305,
        2270156.25,
        0,
        0,
        1
      ],
      "eo:bands": [
        {
          "name": "BAND_P",
          "description": "Pan"
        }
      ],
      "roles": [
        "data"
      ],
      "alternate": {
        "public": {
          "title": "Public Access",
          "href": "https://maxar-opendata.s3.amazonaws.com/events/BayofBengal-Cyclone-Mocha-May-23/ard/46/033111333120/2023-02-17/104001008216D000-pan.tif"
        }
      }
    },
    "visual": {
      "href": "s3://maxar-opendata/events/BayofBengal-Cyclone-Mocha-May-23/ard/46/033111333120/2023-02-17/104001008216D000-visual.tif",
      "type": "image/tiff; application=geotiff; profile=cloud-optimized",
      "title": "Visual Image",
      "proj:bbox": [
        479843.75,
        2264843.75,
        485156.25,
        2270156.25
      ],
      "proj:shape": [
        17408,
        17408
      ],
      "proj:transform": [
        0.30517578125,
        0,
        479843.75,
        0,
        -0.30517578125,
        2270156.25,
        0,
        0,
        1
      ],
      "eo:bands": [
        {
          "name": "BAND_R",
          "common_name": "red",
          "description": "Red"
        },
        {
          "name": "BAND_G",
          "common_name": "green",
          "description": "Green"
        },
        {
          "name": "BAND_B",
          "common_name": "blue",
          "description": "Blue"
        }
      ],
      "roles": [
        "visual"
      ],
      "alternate": {
        "public": {
          "title": "Public Access",
          "href": "https://maxar-opendata.s3.amazonaws.com/events/BayofBengal-Cyclone-Mocha-May-23/ard/46/033111333120/2023-02-17/104001008216D000-visual.tif"
        }
      }
    }
  },
  "bbox": [
    92.84259615375773,
    20.482135453600524,
    92.85765914227906,
    20.514418665444474
  ],
  "stac_extensions": [
    "https://stac-extensions.github.io/view/v1.0.0/schema.json",
    "https://stac-extensions.github.io/projection/v1.0.0/schema.json",
    "https://stac-extensions.github.io/eo/v1.0.0/schema.json",
    "https://stac-extensions.github.io/raster/v1.1.0/schema.json",
    "https://stac-extensions.github.io/grid/v1.0.0/schema.json",
    "https://stac-extensions.github.io/alternate-assets/v1.1.0/schema.json"
  ],
  "collection": "MAXAR_BayofBengal_Cyclone_Mocha_May_23"
}