isabella232 / landsat-api

[DEPRECATED] An API for Landsat Metadata using Elastic Search

Landsat8 Metadata API

Important: This tool is retired and no longer maintianed. Please use sat-api.

A version of sat-api with Landsat metadata is accessible here.

---

This is an API for NASA/USGS Landsat-8 images. Landsat-api enables you to make geospatial, date and text queries on Landsat-8 metadata.

The metadata is released in csv format by USGS on a daily basis. You can download the raw metadata from here.

Download and install the lastest version of elastic search zip from ES website

Landsat-api powers a number of projects including Libra and AstroDigtal's Imagery Browser.

Dependencies

• MongoDb [2.6 or higher]

or

• ElastiSearch [1.6 or higher]

Installation

Install packages

$: npm install

Set environment variables on your system or add an .env file to the root directory of the app:

• DB_TYPE=mongo choices are mongo or es
• ES_HOST=example.com:9200 if you are using ElasticSearch
• MONGODB_URL=mongodb://user:[email protected]:11111/db_name if you use MongoDb
• AREA_LIMIT=500000 The area limit in (sq. km) for use in geo-spatial queries.
• REDIS_USE=true Whether to active the caching. Default is false.
• REDIS_HOST=127.0.0.1 default is 127.0.0.1
• REDIS_PASSWORD=redispassword Redis db password. Default is null.
• REDIS_DATABASE=myredisdb Name of the redis db. Default is null.
• REDIS_PORT=6379 Redis port. Default is 6379.
• LANDSAT_PAYLOAD_LIMIT Limit of payload size for POST in bytes. Default is 2048000.

Run

To run the api:

$ node index.js

To run the database updater

$ node updater.js

Note: updater.js works with MongoDb. If you plan to update an ElasticSearch installation replace updater.js with examples found here.

Test

$ npm test