From dc221eb63d5a04f6ce7afb5d9605dad6b5dee31f Mon Sep 17 00:00:00 2001
From: jonhealy1
Elasticsearch and Opensearch backends for the stac-fastapi project.
## Sponsors & Supporters
From 47619f1de2bda4cb7f0331ffa981021ac0871fb3 Mon Sep 17 00:00:00 2001
From: jonhealy1
-
+
-## What is stac-fastapi-elasticsearch-opensearch?
-
-Stac-fastapi-elasticsearch-opensearch provides a high-performance, scalable API implementation for serving SpatioTemporal Asset Catalog (STAC) data - an enhanced GeoJSON format designed specifically for geospatial assets like satellite imagery, aerial photography, and other Earth observation data. This project enables organizations to:
-
-- **Efficiently catalog and search geospatial data** such as satellite imagery, aerial photography, DEMs, and other geospatial assets using Elasticsearch or OpenSearch as the database backend
-- **Implement standardized STAC APIs** that support complex spatial, temporal, and property-based queries across large collections of geospatial data
-- **Scale to millions of geospatial assets** with fast search performance through optimized spatial indexing and query capabilities
-- **Support OGC-compliant filtering** including spatial operations (intersects, contains, etc.) and temporal queries
-- **Perform geospatial aggregations** to analyze data distribution across space and time
-
-This implementation builds on the STAC-FastAPI framework, providing a production-ready solution specifically optimized for Elasticsearch and OpenSearch databases. It's ideal for organizations managing large geospatial data catalogs who need efficient discovery and access capabilities through standardized APIs.
[](https://pepy.tech/project/stac-fastapi-core)
[](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/graphs/contributors)
@@ -28,8 +17,19 @@ This implementation builds on the STAC-FastAPI framework, providing a production
[](https://github.com/radiantearth/stac-spec/tree/v1.1.0)
[](https://github.com/stac-utils/stac-fastapi)
-
+**Jump to:** [Project Overview](#project-overview) | [Sponsors & Supporters](#sponsors--supporters) | [Common Deployment Patterns](#common-deployment-patterns) | [Technologies](#technologies) | [Documentation & Resources](#documentation--resources) | [Quick Start](#quick-start) | [Full Table of Contents](#table-of-contents)
+
+## Project Overview
+Stac-fastapi-elasticsearch-opensearch provides a high-performance, scalable API implementation for serving SpatioTemporal Asset Catalog (STAC) data - an enhanced GeoJSON format designed specifically for geospatial assets like satellite imagery, aerial photography, and other Earth observation data. This project enables organizations to:
+
+- **Efficiently catalog and search geospatial data** such as satellite imagery, aerial photography, DEMs, and other geospatial assets using Elasticsearch or OpenSearch as the database backend
+- **Implement standardized STAC APIs** that support complex spatial, temporal, and property-based queries across large collections of geospatial data
+- **Scale to millions of geospatial assets** with fast search performance through optimized spatial indexing and query capabilities
+- **Support OGC-compliant filtering** including spatial operations (intersects, contains, etc.) and temporal queries
+- **Perform geospatial aggregations** to analyze data distribution across space and time
+
+This implementation builds on the STAC-FastAPI framework, providing a production-ready solution specifically optimized for Elasticsearch and OpenSearch databases. It's ideal for organizations managing large geospatial data catalogs who need efficient discovery and access capabilities through standardized APIs.
## Sponsors & Supporters
@@ -40,6 +40,17 @@ The following organizations have contributed time and/or funding to support the
+## Common Deployment Patterns
+
+stac-fastapi-elasticsearch-opensearch can be deployed in several ways depending on your needs:
+
+- **Containerized Application**: Run as a Docker container with connections to Elasticsearch/OpenSearch databases
+- **Serverless Function**: Deploy as AWS Lambda or similar serverless function with API Gateway
+- **Traditional Server**: Run on virtual machines or bare metal servers in your infrastructure
+- **Kubernetes**: Deploy as part of a larger microservices architecture with container orchestration
+
+The implementation is flexible and can scale from small local deployments to large production environments serving millions of geospatial assets.
+
## Technologies
This project is built on the following technologies: STAC, stac-fastapi, FastAPI, Elasticsearch, Python, OpenSearch
From 3cef3462c50d1ef12f025e81a20bb3c83638acd3 Mon Sep 17 00:00:00 2001
From: jonhealy1
+**Jump to:** [Common Deployment Patterns](#common-deployment-patterns) | [Documentation & Resources](#documentation--resources) | [Quick Start](#quick-start) | [Full Table of Contents](#table-of-contents)
[](https://pepy.tech/project/stac-fastapi-core)
[](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/graphs/contributors)
@@ -17,7 +18,6 @@
[](https://github.com/radiantearth/stac-spec/tree/v1.1.0)
[](https://github.com/stac-utils/stac-fastapi)
-**Jump to:** [Common Deployment Patterns](#common-deployment-patterns) | [Documentation & Resources](#documentation--resources) | [Quick Start](#quick-start) | [Full Table of Contents](#table-of-contents)
## Project Overview
From 683911d7138393a8ef3a2b5dec00220499225139 Mon Sep 17 00:00:00 2001
From: jonhealy1
-**Jump to:** [Common Deployment Patterns](#common-deployment-patterns) | [Documentation & Resources](#documentation--resources) | [Quick Start](#quick-start) | [Full Table of Contents](#table-of-contents)
+**Jump to:** [Quick Start](#quick-start) | [Table of Contents](#table-of-contents)
[](https://pepy.tech/project/stac-fastapi-core)
[](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/graphs/contributors)
From 35bf398fe8a9e995652d874bf40a1188dc19fedf Mon Sep 17 00:00:00 2001
From: jonhealy1
-**Jump to:** [Quick Start](#quick-start) | [Table of Contents](#table-of-contents)
+**Jump to:** [Project Overview](#project-overview) | [Quick Start](#quick-start) | [Table of Contents](#table-of-contents)
[](https://pepy.tech/project/stac-fastapi-core)
[](https://github.com/stac-utils/stac-fastapi-elasticsearch-opensearch/graphs/contributors)
@@ -18,6 +18,14 @@
[](https://github.com/radiantearth/stac-spec/tree/v1.1.0)
[](https://github.com/stac-utils/stac-fastapi)
+## Sponsors & Supporters
+
+The following organizations have contributed time and/or funding to support the development of this project:
+
+
## Project Overview
@@ -31,14 +39,7 @@ Stac-fastapi-elasticsearch-opensearch provides a high-performance, scalable API
This implementation builds on the STAC-FastAPI framework, providing a production-ready solution specifically optimized for Elasticsearch and OpenSearch databases. It's ideal for organizations managing large geospatial data catalogs who need efficient discovery and access capabilities through standardized APIs.
-## Sponsors & Supporters
-
-The following organizations have contributed time and/or funding to support the development of this project:
-
## Common Deployment Patterns
From a54afa6cec2b43a517dbf3e563cba0d1e922a916 Mon Sep 17 00:00:00 2001
From: jonhealy1
-
+
a*}A!0gfxlWi*V;t2(+&X0Gztb!a zUpV|P#U^bwe?*Z%+pC|ztN#%D=!G*`YP|A5M@a(gK+t*puJnM6jrUME6~E35Yw4Lk zAO9UFY%?2QWvQHH`!g{_XL0%S%GMOmzLZr;N*M8{#?f#0PLha+>(8L@aDVjWJrgb( zHAespe#nKryc=+GjKFi(mMmmrW~66tWYUqP-KS5t^kuhrpWlwS$&@+ibu1n=*7nku zV3X%x)XgAl++iOy*K>LEA6RfMC@RWDf@M>~9`E;_naZs3-s|C^>hUJh<6weD=@)?& z_+Px36ZIHABwfpB=8Crp1NwVxn=NhNZjtOxM|LPmGt>prZUp04AMFt zcD5&sl;l7G>-}_@GF60GV5vGC@C8VO+L!rTu8|LIroQpi_V)HR7^>8ID@Kf-L|7~# zTly5id3oF}*RG6*VW@(0D -jRoO{7X)}l@T}iCT !G5V8N7lREP@1(NZzBy&KjWc znt#sA*JT-{EW0bot}!MhS7?wS6n5i@CtHsF?}&_lf91f5xqs;=)7mF!B_$o;3E-tE zj2{$oH{oCb(BkfJc2Aw%obqVPDTpu#lGqVWbF3VRH-qar%^;uf;-M4T;?2aFUG8_6 z%Nl#!>9bVg)?J&gc;sHot4j47qlKe}p$N4_`X_1&Q9eYN5A-N|`yYu7JW}wn$`vN5 z^(Cqyn3f$JX{G$W6X#&ox{8}tUk67JERppY8i%SaCSsCiEvB5Be{2Q9dr|u`s7jl4 z=XRdptL})9&$*!+Sp$rUV{!V4f1}MF6m#vK-&bZ*Ce+{AGtSQUrv>Nko}8Ave}VJ& z0@@qX?g>7!i;%nQ=c|}}MBC&*gA+X<*($&9QcR t4-oO35 z@0KPvZB}P!bGo!tv2 woIEX9WoCc6gxHQnnAIhmBx=wL61Jcl1i;~8W)S|ftX!Zop$ zk(Mi3VO*$$yjlU&DZ*bY_r;r-_GJ%~t)DoAW;t#Ve{icHOyU>XjT!qdF3Z&~(w&j> zvK&aZEOBNnb@GoSf8}@I!Qfn~IkUZJ%wd~XEU8vBwXu8s@Cq|Hyk|Ck2Q{n*{Jrn{ zpZ+VHw@|j3g~v8Ne%G{}?qWaeFApO3osDH^#uQ;K)u${-0c;r-I+*vv`|n$}9T3Bl zX5H4y)|F6By1qTX{k(awiv9vh$-<%dAqQ%>L-9kMU$y7HPA;tKYp$G{KWG0~E0z<* zDmE>*rF}sEr+@l$f2OjO5; Cra}$Y >pdd!;>{M`>tt|)TM5$nGr=7WwNb^7n= z6gX~s%l?8Wx+^hTyKiYJueT7t4y8!(@3TqAXA&YaXo(C(W(En7WnmuuaD&jKOs`HE z#1P`fw9V{)C39-jP~%d(Xurp8D04XA;&`JaQ*k&u3xtScxc_P(PR-TNes@7G>8Izq z3tIc@)zp%0=<~h3y(1Zi591~&IHz8jysgZk>jARzYS&nGlI6FT4_usOrl_-R#yQLA zn>Rz=)9=lmf~fZ3?sx4VQUv vQiq`)RnC-RN`u)os3QOpnf)c^V%K6{z$ z8>>f9YJ{1*QL-7H1J3eWa_5^;BrzT0wLduW2gbX68Gq!>XuYEAte=9npLO5h>96#C z`jZnMN`HwviRo{mfO3E9T?8qHTmNShZwI$bKveMv;=cJ>HOuB<`=kh!zafHr0pAH_ z_RLwGZ%cU_S&@IRRfr{vxpVkHdH5@z3l3-avsryq%$;pqD=W3zLaXp^C} + zW0RgPr+kk1hTzYjV@B}jsmy!JRi^?Tvn}H##Zx7Zs;LSgqyJC;{y%A#a23_R%TE1H z6zN6BSaR21|Bs&eU;pp2-J~oQe=5{;x1K(J?mcF>Btd?|hv>%;G3t}I=2tA2*$#A; z 6(O9G~|U1ktDv)AJD67pn2l1dDb(OJEqWW6&r)D`Q5 eW zr{+ymoF7a}U+ $THfp_si2v(r@kl@ ziFSlhj{b_zE}}WJiwm6Dh3r1Ov);5#E3EY9%_AJ)20n`&j9)e8dlg=i?;Gg&k(ymg z*P#QBy-kY#PHODo-43Is|M->myNo99D6Fhcf#D xG<6*Ec^