Welcome to Terracotta¶
Use cases¶
Use it as data exploration tool to quickly serve up a folder containing GeoTiff images with
terracotta serve
.Make it your tile server backend on an existing webserver. You can ingest your data ahead of time (recommended) or on-demand.
Deploy it on serverless architectures such as AWS Lambda to serve tiles from S3 buckets. This allows you to build apps that scale almost infinitely with minimal maintenance!
Installation¶
If you are using Linux and already have Python 3.8+ installed, all you need to do to check out Terracotta is
$ pip install terracotta[recommended]
Otherwise, see our installation guide for conda-based and development installations on all platforms.
Why Terracotta?¶
It is trivial to get going. Got a folder full of cloud-optimized GeoTiffs in different projections you want to have a look at in your browser?
terracotta serve -r {name}.tif
andterracotta connect localhost:5000
get you there.We make minimal assumptions about your data, so you stay in charge. Keep using the tools you know and love to create and organize your data, Terracotta serves it exactly as it is.
Serverless deployment is a first-priority use case, so you don’t have to worry about maintaining or scaling your architecture.
Terracotta instances are self-documenting. Everything the frontend needs to know about your data is accessible from only a handful of API endpoints.
Web API¶
Every Terracotta deployment exposes the API it uses as a
swagger.json
file and a visual explorer hosted at
http://server.com/swagger.json
and http://server.com/apidoc
,
respectively. This is the best way to find out which API your
deployment of Terracotta uses.
To catch a first glance, feel free to explore the API of this Terracotta version.