feat(lambda-tiler): update imagery layer attributions to show licensor details BM-897

[tawera-manaena]

Motivation

As an Imagery Data Maintainer, I want to ensure that imagery is attributed to the correct licensor(s) for all published surveys so that councils and government departments receive appropriate recognition.

---

Attribution Types

	Compact	Extended
Template	© stac_license licensor_names	© stac_license licensor_names - tileset_info
Example	© CC BY 4.0 Otago Regional Council	© CC BY 4.0 Otago Regional Council - Otago 0.3 Rural Aerial Photos (2017-2019)

---

Modifications

packages/config-loader

• Updated the package so that it copies through providers metadata when generating config files.

packages/lambda-tiler

• Updated the attribution endpoint to include providers metadata as part of collections when returning AttributionStac responses.

• Updated the style endpoint to include a compact attribution on sources when returning StyleJson responses.

packages/attribution

• Updated the attribution class to return an extended attribution for the bottom-right of the landing page.

Verification

packages/lambda-tiler

1. Implemented a test suite for the style endpoint to ensure it generates the correct compact attribution for a given tileset.

packages/attribution

5. Implemented a test suite to verify that the new utility function createLicensorAttribution() generates the correct compact attribution for a given list of providers.

---

Example

Layer: Top of the South 0.15m Flood Aerial Photos (2022)

To recreate this example, you will need to locally download the collection.json file and at least one of the .TIFF files. You will then need to run them through the cogify process and serve them using the server package.

Landing Page

Screenshot showing the extended attribution for the bottom-right of the landing page.

Styles Endpoint

/v1/styles/:styleName.json

Excerpt from the JSON response showing the provider metadata:

{
    ...
    "collections": [
        {
            ...
            "providers": [
                {
                    "name": "Nelson City Council",
                    "roles": [
                        "licensor"
                    ]
                },
                {
                    "name": "Tasman District Council",
                    "roles": [
                        "licensor"
                    ]
                },
                {
                    "name": "Waka Kotahi",
                    "roles": [
                        "licensor"
                    ]
                },
                ...
            ],
            ...
        }
    ],
    ...
}

Attribution Endpoint

/v1/tiles/:tileSet/:tileMatrix/attribution.json

Excerpt from the JSON response showing the compact attribution for the layer source:

{
    ...
    "sources": {
        "basemaps-top-of-the-south-flood-2022-0.15m": {
            ...
            "attribution": "© CC BY 4.0 Nelson City Council, Tasman District Council, Waka Kotahi",
            ...
        }
    },
    ...
}