Skip to content

Commit

Permalink
docs: add more information and links to the README
Browse files Browse the repository at this point in the history
  • Loading branch information
dwsilk authored Aug 20, 2024
1 parent b73bfaa commit 13a4ab8
Showing 1 changed file with 22 additions and 3 deletions.
25 changes: 22 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,26 @@
# New Zealand Elevation

Toitū Te Whenua makes New Zealand’s most up-to-date publicly owned elevation data freely available to use under an open licence.
You can access this through the [LINZ Data Service](https://data.linz.govt.nz/data/category/elevation/).
Toitū Te Whenua makes New Zealand's most up-to-date publicly owned elevation data freely available to use under an open licence. You can access this through the [LINZ Data Service](https://data.linz.govt.nz/data/category/elevation/), [LINZ Basemaps](https://basemaps.linz.govt.nz/@-41.8899962,174.0492437,z5?i=elevation) or the [Registry of Open Data on AWS](https://registry.opendata.aws/nz-elevation/).

This repository contains STAC Collection metadata for each elevation dataset, as well as some guidance documentation:

- [Naming](docs/naming.md) covers the s3://nz-elevation bucket naming structure
- [Usage](docs/usage.md) shows how TIFFs can be interacted with from S3 using GDAL, QGIS, etc
- [Elevation Compression](docs/tiff-compression) provides commentary and analysis on the compression options we explored.

## AWS Access

Toitū Te Whenua owns and maintains a public bucket which is sponsored and shared via the [Registry of Open Data on AWS](https://registry.opendata.aws/nz-elevation/) `s3://nz-elevation` in `ap-southeast-2`.

Using the [AWS CLI](https://aws.amazon.com/cli/) anyone can access all of the imagery specified in this repository.

```
aws s3 ls --no-sign-request s3://nz-elevation/
```

### Browsing the S3 Bucket

[STAC Browser](https://radiantearth.github.io/stac-browser/#/external/nz-elevation.s3.ap-southeast-2.amazonaws.com/catalog.json) can be used to browse through the contents of the S3 bucket.

## Related

Expand All @@ -13,4 +32,4 @@ Source code is licensed under [MIT](LICENSE).

All metadata and docs are licensed under [CC-BY-4.0](https://creativecommons.org/licenses/by/4.0/).

For [more information on elevation attribution](https://www.linz.govt.nz/products-services/data/licensing-and-using-data/attributing-elevation-or-aerial-imagery-data).
For [more information on imagery attribution](https://www.linz.govt.nz/products-services/data/licensing-and-using-data/attributing-elevation-or-aerial-imagery-data).

0 comments on commit 13a4ab8

Please sign in to comment.