Sat-api is a STAC compliant web API for searching and serving metadata for geospatial data (including but not limited to satellite imagery).
Development Seed runs an instance of sat-api for the Landsat-8 and Sentinel-2 imagery that is hosted on AWS. You can access this at https://sat-api.developmentseed.org.
The STAC version supported by a given version of sat-api is shown in the table below. Additional information can be found in the CHANGELOG
| sat-api | STAC |
|---|---|
| 0.1.0 | 0.5.0 |
| 0.2.x | 0.6.0 |
The documentation includes information on the STAC spec, how to use the API, manage Elasticsearch, as well as how to deploy your own API on AWS. Access the documentation here
Sat-api includes a number of NPM packages (in the packages/ directory) that are used to create and populate an instance of sat-api. See the sat-utils org on NPM for the full list of packages. Lerna is used for for managing these packages.
The latest version released is on the master branch, and the latet development version is on the develop branch.
# Install dependencies in package.json
$ yarn
# Run lerna boostrap to link together packages and install those package dependencies
$ yarn bootstrap
# Run the build command in each of the packages (runs webpack)
$ yarn build
# To continually watch and build source files
$ yarn watch
# To run tests for all packages
$ yarn test
# To build API docs from the api spec
$ yarn build-api-docs
To create a new version for npm:
- create a new branch from master
$ yarn update- Follow the prompt and select the correct the version, then commit the changes.
- Update CHANGELOG.md.
- Tag your branch with the same version number
- Make a PR
- When the PR is merged to master, the npm packages are automatically deployed to npm
- In GitHub create a release with the version (prefixed with 'v') and paste in the CHANGELOG section. This will create a GitHub release and a tag.
sat-api was created by Development Seed and is part of a collection of tools called sat-utils.