Skip to main content

An application for discovering collections from multiple STAC APIs and/or CMRs

Project description

Federated Collection Discovery

An application for discovering geospatial data collections from multiple STAC APIs and/or CMRs.

Installation

The package can be installed from pypi, optionally with uvicorn for serving the application locally:

for uvicorn:

pip install federated-collection-discovery[uvicorn]

If you are going to run the application in an AWS Lambda function, install the aws_lambda extras in the build context:

pip install federated-collection-discovery[aws_lambda]

Usage

To run the FastAPI application, set the FEDERATED_STAC_API_URLS environment variable and/or the FEDERATED_CMR_URLS environment variable, then launch it with uvicorn:

MAAP_API=https://stac.maap-project.org/
VEDA_API=https://openveda.cloud/api/stac/
ESA_API=https://catalogue.dataspace.copernicus.eu/stac
FEDERATED_STAC_API_URLS=${MAAP_API},${VEDA_API},${ESA_API} \
  uvicorn federated_collection_discovery.main:app --host 0.0.0.0 --port 8000

Development

Clone the repo

git clone git@github.com:developmentseed/federated-collection-discovery.git
cd federated-collection-discovery

Install Poetry

Ensure you have Poetry installed. If not, install it:

curl -sSL https://install.python-poetry.org | python3 -

Add Poetry to your system's PATH:

  • For Unix/MacOS:

    export PATH="$HOME/.local/bin:$PATH"
    

    Add the above line to your shell configuration file (~/.bashrc, ~/.bash_profile, or ~/.zshrc) to make it permanent.

  • For Windows:

    Add the path to your PATH environment variable through the system environment variable settings.

Install

Navigate to the src/server directory and install the dependencies (in a virtual environment) using Poetry:

python3 -m venv env
source env/bin/activate
cd src/server
poetry install

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

federated_collection_discovery-0.tar.gz (10.7 kB view details)

Uploaded Source

Built Distribution

federated_collection_discovery-0-py3-none-any.whl (13.3 kB view details)

Uploaded Python 3

File details

Details for the file federated_collection_discovery-0.tar.gz.

File metadata

File hashes

Hashes for federated_collection_discovery-0.tar.gz
Algorithm Hash digest
SHA256 a9fcec1b1720943a1714771b86a054dfdb6a4a249bdc1796ad1c8d89fac3ecd1
MD5 d90c412a7ab1e0c12e765dc9023ae253
BLAKE2b-256 9bd22203e8ff1e97c06ba8c68c060c4248b8188d1c1da462015b1a832e996e3a

See more details on using hashes here.

File details

Details for the file federated_collection_discovery-0-py3-none-any.whl.

File metadata

File hashes

Hashes for federated_collection_discovery-0-py3-none-any.whl
Algorithm Hash digest
SHA256 97165eadc4aa8f3aadbdadffe719aeb88454d23c15813d6231d4b3bacae17477
MD5 42d7e348b1c0688b50efc0d35323ab29
BLAKE2b-256 b5671c7069af67c4dc07ca4ccc66d77286e7a5c884f1884c046799ecf213bea0

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page