#geospatial

stac-server

SpatioTemporal Asset Catalog (STAC) API server

5 unstable releases

0.3.1 Sep 19, 2024
0.3.0 Sep 16, 2024
0.2.0 Sep 6, 2024
0.1.1 Aug 12, 2024
0.1.0 Apr 29, 2024

#210 in Science

Download history 1/week @ 2024-06-16 557/week @ 2024-08-04 122/week @ 2024-08-11 8/week @ 2024-08-18 141/week @ 2024-09-01 27/week @ 2024-09-08 262/week @ 2024-09-15 35/week @ 2024-09-22 58/week @ 2024-09-29

398 downloads per month
Used in stac-cli

MIT/Apache

2MB
8K SLoC

stac-server

GitHub Workflow Status docs.rs Crates.io Crates.io Contributor Covenant

A STAC API server with multiple backends.

Usage

To run a server from the command-line, use stac-cli. Any arguments will be interpreted as hrefs to STAC collections, items, and item collections, and will be loaded into the server on startup.

stac serve collection.json items.json

To use the pgstac backend:

stac serve --pgstac postgresql://username:password@localhost:5432/postgis

Library

To use this library in another application:

[dependencies]
stac-server = "0.3"

Deploying

There is currently no infrastructure-as-code for deploying stac-server. We hope to provide this support in the future.

Features

stac-server has two optional features.

axum

The axum feature enables routing and serving using axum.

pgstac

In order to use the pgstac, you need to enable the pgstac feature.

Backends

This table lists the provided backends and their supported conformance classes and extensions:

Capability Memory backend Pgstac backend
STAC API - Core
STAC API - Features
STAC API - Item Search
Aggregation extension ✖️ ✖️
Browseable extension ✖️ ✖️
Children extension ✖️ ✖️
Collection search extension ✖️ ✖️
Collection transaction extension ✖️ ✖️
Fields extension ✖️ ✖️
Filter extension ✖️ ✖️
Free-text search extension ✖️ ✖️
Language (I18N) extension ✖️ ✖️
Query extension ✖️ ✖️
Sort extension ✖️ ✖️
Transaction extension ✖️ ✖️

Other info

This crate is part of the stac-rs monorepo, see its README for contributing and license information.

Dependencies

~10–23MB
~336K SLoC