Connect PgSTAC and TiTiler.
Project description
Connect PgSTAC and TiTiler.
Documentation: https://stac-utils.github.io/titiler-pgstac/
Source Code: https://github.com/stac-utils/titiler-pgstac
TiTiler.PgSTAC
is a titiler extension which connect to pgstac STAC database in order to create dynamic mosaics based on Search Query
.
Installation
To install from PyPI and run:
# Make sure to have pip up to date
$ python -m pip install -U pip
# Install `psycopg` or `psycopg["binary"]` or `psycopg["c"]`
$ python -m pip install psycopg["binary"]
$ python -m pip install titiler.pgstac
To install from sources and run for development:
$ git clone https://github.com/stac-utils/titiler-pgstac.git
$ cd titiler-pgstac
$ python -m pip install -e .
PgSTAC
version
titiler.pgstac
depends on pgstac >=0.3.4
(https://github.com/stac-utils/pgstac/blob/main/CHANGELOG.md#v034).
psycopg
requirement
titiler.pgstac
depends on the psycopg
library. Because there are three ways of installing this package (psycopg
or , psycopg["c"]
, psycopg["binary"]
), the user must install this separately from titiler.pgstac
.
psycopg
: no wheel, pure python implementation. It requires thelibpq
installed in the system.psycopg["binary"]
: binary wheel distribution (shipped with libpq) of thepsycopg
package and is simpler for development. It requires development packages installed on the client machine.psycopg["c"]
: a C (faster) implementation of the libpq wrapper. It requires thelibpq
installed in the system.
psycopg[c]
or psycopg
are generally recommended for production use.
In titiler.pgstac
setup.py, we have added three options to let users choose which psycopg install to use:
pip install titiler.pgstac["psycopg"]
: pure pythonpip install titiler.pgstac["psycopg-c"]
: use the C wrapper (requires development packages installed on the client machine)pip install titiler.pgstac["psycopg-binary"]
: binary wheels
Launch
You'll need to have POSTGRES_USER
, POSTGRES_PASS
, POSTGRES_DBNAME
, POSTGRES_HOST
, POSTGRES_PORT
variables set in your environment pointing to your Postgres database where pgstac has been installed.
export POSTGRES_USER=username
export POSTGRES_PASS=password
export POSTGRES_DBNAME=postgis
export POSTGRES_HOST=database
export POSTGRES_PORT=5432
$ pip install uvicorn
$ uvicorn titiler.pgstac.main:app --reload
Using Docker
$ git clone https://github.com/stac-utils/titiler-pgstac.git
$ cd titiler-pgstac
$ docker-compose up --build tiler
It runs titiler.pgstac
using Gunicorn web server. To run Uvicorn based version:
$ docker-compose up --build tiler-uvicorn
Contribution & Development
See CONTRIBUTING.md
License
See LICENSE
Authors
See contributors for a listing of individual contributors.
Changes
See CHANGES.md.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for titiler.pgstac-0.2.4-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0660f70a71f4143a6d2f0cd63371bbadc91647ec7c574e3d6b07f6da4bdb3f19 |
|
MD5 | 504eb95f7c38568dc62c030c3568475a |
|
BLAKE2b-256 | f6200fb4552a78b956be5152ef3ad006ea71ba2f6991912488ade1bbf8ad3b0a |