diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 32e5129a3..3e51106d0 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -93,6 +93,21 @@ Sources should be classified into one of the following categories of different t An imagery source can have an icon by setting the `icon` property to a URL of an image. This image should be sized such that it can be displayed also at a small scale, e.g. in the list of imagery layers next to the name. +### Imagery Catalogs + +Some providers publish whole catalogs of imagery layers (from tens to thousands), adding each of these indivdually as sources is not viable, so instead we can add each catalog in the `catalogs` directory. + +For example, we have a source for the OpenAerialMap mosaic, but we don't add each of the individual imagery layers as a source, instead we just add the catalog. + +#### Support Catalog Types + +##### OpenAerialMap `OAM_META` + +https://api.openaerialmap.org/meta provides an API to list all the individual OpenAerialMap imagery layers. + +##### STAC `STAC` + +For example LINZ NZ Imagery Catalog is available at https://nz-imagery.s3-ap-southeast-2.amazonaws.com/catalog.json and via the [STAC Browser](https://radiantearth.github.io/stac-browser/#/external/nz-imagery.s3-ap-southeast-2.amazonaws.com/catalog.json) ### Submitting your modifications diff --git a/catalogs/OpenAerialMap.json b/catalogs/OpenAerialMap.json new file mode 100644 index 000000000..4945ae655 --- /dev/null +++ b/catalogs/OpenAerialMap.json @@ -0,0 +1,14 @@ +{ + "name": "OpenAerialMap", + "url": "https://api.openaerialmap.org/meta", + "type": "OAM_META", + "id": "OpenAerialMap", + "attribution": { + "url": "http://beta.openaerialmap.org", + "text": "OpenAerialMap", + "required": true + }, + "license_url": "https://openaerialmap.org/legal/", + "privacy_policy_url": false, + "icon": "https://openaerialmap.org/assets/graphics/meta/favicon.ico" +} diff --git a/catalogs/oceania/nz/LINZ-NZ-Imagery.json b/catalogs/oceania/nz/LINZ-NZ-Imagery.json new file mode 100644 index 000000000..5257db46c --- /dev/null +++ b/catalogs/oceania/nz/LINZ-NZ-Imagery.json @@ -0,0 +1,15 @@ +{ + "name": "LINZ NZ Imagery", + "url": "https://nz-imagery.s3-ap-southeast-2.amazonaws.com/catalog.json", + "type": "STAC", + "id": "LINZ NZ Imagery", + "attribution": { + "url": "https://www.linz.govt.nz/data/licensing-and-using-data/attributing-elevation-or-aerial-imagery-data", + "text": "Sourced from LINZ CC-BY 4.0", + "required": true + }, + "license_url": "https://wiki.openstreetmap.org/wiki/Contributors#New_Zealand", + "privacy_policy_url": "https://www.linz.govt.nz/privacy", + "country_code": "NZ", + "icon": "https://basemaps.linz.govt.nz/assets/logo-linz.svg" +}