titiler.stacapi


Nametitiler.stacapi JSON
Version 0.2.0 PyPI version JSON
download
home_pageNone
SummaryConnect titiler to STAC APIs.
upload_time2024-11-19 07:53:12
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords titiler stac api
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # titiler-stacapi

<p align="center">
  <img width="800" src="https://github.com/developmentseed/titiler-stacapi/assets/10407788/bb54162e-9a47-4a67-99e5-6dc91098e048">
  <p align="center">Connect titiler to STAC APIs</p>
</p>

<p align="center">
  <a href="https://github.com/developmentseed/titiler-stacapi/actions?query=workflow%3ACI" target="_blank">
      <img src="https://github.com/developmentseed/titiler-stacapi/workflows/CI/badge.svg" alt="Test">
  </a>
  <a href="https://codecov.io/gh/developmentseed/titiler-stacapi" target="_blank">
      <img src="https://codecov.io/gh/developmentseed/titiler-stacapi/branch/main/graph/badge.svg" alt="Coverage">
  </a>
  <a href="https://github.com/developmentseed/titiler-stacapi/blob/main/LICENSE" target="_blank">
      <img src="https://img.shields.io/github/license/developmentseed/titiler-stacapi.svg" alt="License">
  </a>
</p>

---

**Documentation**: <a href="https://developmentseed.org/titiler-stacapi/" target="_blank">https://developmentseed.org/titiler-stacapi/</a>

**Source Code**: <a href="https://github.com/developmentseed/titiler-stacapi" target="_blank">https://github.com/developmentseed/titiler-stacapi</a>

---

## Installation

To install from PyPI and run:

```bash
# Make sure you have pip up to date
python -m pip install -U pip
python -m pip  install titiler.stacapi
```

or from sources and run for development:

```bash
git clone https://github.com/developmentseed/titiler-stacapi.git
cd titiler-stacapi
python -m pip install -e .
```

## Launch

You'll need to have `TITILER_STACAPI_STAC_API_URL` variables set in your environment pointing to your STAC API service.

```
export TITILER_STACAPI_STAC_API_URL=https://api.stac
```

```
python -m pip install uvicorn

uvicorn titiler.stacapi.main:app --port 8000
```

### Using Docker

```
$ git clone https://github.com/developmentseed/titiler-stacapi.git
$ cd titiler-stacapi
$ export TITILER_STACAPI_STAC_API_URL=https://api.stac
$ docker-compose up --build api
```

It runs `titiler.stacapi` using Gunicorn web server.

### How it works

![](https://github.com/developmentseed/titiler-stacapi/assets/10407788/2e53bfe3-402a-4c57-bf61-c055e32f1362)

### WMTS and the Render extension

`titiler-stacapi` makes extensive use of the [**Render**](https://github.com/stac-extensions/render) extension, specifically at the `Collection` level.
By using the render's metadata, the `/wmts` endpoint (from the `OGCWMTSFactory` factory) can populate a set of `layers` returned by the `GetCapabilities` service.


## Contribution & Development

See [CONTRIBUTING.md](https://github.com//developmentseed/titiler-stacapi/blob/main/CONTRIBUTING.md)

## License

See [LICENSE](https://github.com//developmentseed/titiler-stacapi/blob/main/LICENSE)

## Authors

See [contributors](https://github.com/developmentseed/titiler-stacapi/graphs/contributors) for a listing of individual contributors.

## Changes

See [CHANGES.md](https://github.com/developmentseed/titiler-stacapi/blob/main/CHANGES.md).


            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "titiler.stacapi",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "TiTiler, STAC API",
    "author": null,
    "author_email": "Vincent Sarago <vincent@developmentseed.com>",
    "download_url": "https://files.pythonhosted.org/packages/8d/0a/1b380ef639955290ff70ce9d6f888461cd5f88bc400968061dbe6313a06c/titiler.stacapi-0.2.0.tar.gz",
    "platform": null,
    "description": "# titiler-stacapi\n\n<p align=\"center\">\n  <img width=\"800\" src=\"https://github.com/developmentseed/titiler-stacapi/assets/10407788/bb54162e-9a47-4a67-99e5-6dc91098e048\">\n  <p align=\"center\">Connect titiler to STAC APIs</p>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://github.com/developmentseed/titiler-stacapi/actions?query=workflow%3ACI\" target=\"_blank\">\n      <img src=\"https://github.com/developmentseed/titiler-stacapi/workflows/CI/badge.svg\" alt=\"Test\">\n  </a>\n  <a href=\"https://codecov.io/gh/developmentseed/titiler-stacapi\" target=\"_blank\">\n      <img src=\"https://codecov.io/gh/developmentseed/titiler-stacapi/branch/main/graph/badge.svg\" alt=\"Coverage\">\n  </a>\n  <a href=\"https://github.com/developmentseed/titiler-stacapi/blob/main/LICENSE\" target=\"_blank\">\n      <img src=\"https://img.shields.io/github/license/developmentseed/titiler-stacapi.svg\" alt=\"License\">\n  </a>\n</p>\n\n---\n\n**Documentation**: <a href=\"https://developmentseed.org/titiler-stacapi/\" target=\"_blank\">https://developmentseed.org/titiler-stacapi/</a>\n\n**Source Code**: <a href=\"https://github.com/developmentseed/titiler-stacapi\" target=\"_blank\">https://github.com/developmentseed/titiler-stacapi</a>\n\n---\n\n## Installation\n\nTo install from PyPI and run:\n\n```bash\n# Make sure you have pip up to date\npython -m pip install -U pip\npython -m pip  install titiler.stacapi\n```\n\nor from sources and run for development:\n\n```bash\ngit clone https://github.com/developmentseed/titiler-stacapi.git\ncd titiler-stacapi\npython -m pip install -e .\n```\n\n## Launch\n\nYou'll need to have `TITILER_STACAPI_STAC_API_URL` variables set in your environment pointing to your STAC API service.\n\n```\nexport TITILER_STACAPI_STAC_API_URL=https://api.stac\n```\n\n```\npython -m pip install uvicorn\n\nuvicorn titiler.stacapi.main:app --port 8000\n```\n\n### Using Docker\n\n```\n$ git clone https://github.com/developmentseed/titiler-stacapi.git\n$ cd titiler-stacapi\n$ export TITILER_STACAPI_STAC_API_URL=https://api.stac\n$ docker-compose up --build api\n```\n\nIt runs `titiler.stacapi` using Gunicorn web server.\n\n### How it works\n\n![](https://github.com/developmentseed/titiler-stacapi/assets/10407788/2e53bfe3-402a-4c57-bf61-c055e32f1362)\n\n### WMTS and the Render extension\n\n`titiler-stacapi` makes extensive use of the [**Render**](https://github.com/stac-extensions/render) extension, specifically at the `Collection` level.\nBy using the render's metadata, the `/wmts` endpoint (from the `OGCWMTSFactory` factory) can populate a set of `layers` returned by the `GetCapabilities` service.\n\n\n## Contribution & Development\n\nSee [CONTRIBUTING.md](https://github.com//developmentseed/titiler-stacapi/blob/main/CONTRIBUTING.md)\n\n## License\n\nSee [LICENSE](https://github.com//developmentseed/titiler-stacapi/blob/main/LICENSE)\n\n## Authors\n\nSee [contributors](https://github.com/developmentseed/titiler-stacapi/graphs/contributors) for a listing of individual contributors.\n\n## Changes\n\nSee [CHANGES.md](https://github.com/developmentseed/titiler-stacapi/blob/main/CHANGES.md).\n\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Connect titiler to STAC APIs.",
    "version": "0.2.0",
    "project_urls": {
        "Changelog": "https://developmentseed.org/titiler-stacapi/release-notes/",
        "Documentation": "https://developmentseed.org/titiler-stacapi/",
        "Homepage": "https://developmentseed.org/titiler-stacapi/",
        "Issues": "https://github.com/developmentseed/titiler-stacapi/issues",
        "Source": "https://github.com/developmentseed/titiler-stacapi"
    },
    "split_keywords": [
        "titiler",
        " stac api"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "738ce3bec6558822446618a0b3567d0feec743669462de85d7fac73ebfac0c14",
                "md5": "ae71ca34893bdfd2e59947a3872bcc66",
                "sha256": "d36da3ba435c5a63b434be1b62ace8015e14a127b884562480fcf0315f5068a9"
            },
            "downloads": -1,
            "filename": "titiler.stacapi-0.2.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "ae71ca34893bdfd2e59947a3872bcc66",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 49302,
            "upload_time": "2024-11-19T07:53:11",
            "upload_time_iso_8601": "2024-11-19T07:53:11.308226Z",
            "url": "https://files.pythonhosted.org/packages/73/8c/e3bec6558822446618a0b3567d0feec743669462de85d7fac73ebfac0c14/titiler.stacapi-0.2.0-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "8d0a1b380ef639955290ff70ce9d6f888461cd5f88bc400968061dbe6313a06c",
                "md5": "d448293de73116c550d574a09e6b365f",
                "sha256": "34fd17f971ed5d40ece26e363df0308353163f2eb22bff661fe60da520069b85"
            },
            "downloads": -1,
            "filename": "titiler.stacapi-0.2.0.tar.gz",
            "has_sig": false,
            "md5_digest": "d448293de73116c550d574a09e6b365f",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 37528,
            "upload_time": "2024-11-19T07:53:12",
            "upload_time_iso_8601": "2024-11-19T07:53:12.361307Z",
            "url": "https://files.pythonhosted.org/packages/8d/0a/1b380ef639955290ff70ce9d6f888461cd5f88bc400968061dbe6313a06c/titiler.stacapi-0.2.0.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-11-19 07:53:12",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "developmentseed",
    "github_project": "titiler-stacapi",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "lcname": "titiler.stacapi"
}
        
Elapsed time: 0.35886s