NASA MAAP API

The joint ESA-NASA Multi-Mission Algorithm and Analysis Platform (MAAP) focuses on developing a collaborative data system enabling collocated data, processing, and analysis tools for NASA and ESA datasets. The NASA MAAP API adheres to the joint ESA-NASA MAAP API specification currently in development. This joint architectural approach enables NASA and ESA to each run independent MAAPs, while ultimately sharing common facilities to share and integrate collocated platform services.

Development server: https://api.dit.maap-project.org/api

I. Local development using docker

cd docker
docker-compose -f docker-compose-local.yml up

II. Local development using poetry and virtualenv

Prerequisites:

• poetry
  • https://python-poetry.org/docs/#installation
• postgresql
  • Linux: sudo apt-get install postgresql python-psycopy2 libpq-dev
  • Mac OSx: brew install postgresql
• python3.9+

cd maap-api-nasa
poetry install

First run: Configure the database.

1. Add a new user called maapuser (A fix for 'role does not exist')

   NOTE: You may need to use sudo -u postgres before postgres commands.

   createuser maapuser

2. Create an empty postgres db (maap) (a fix for 'database maap does not exist'):

   createdatabase maap

3. OPTIONAL: PyCharm configuration, if using the PyCharm IDE:

• Script path: ./api/maapapp.py
• Environment variables: PYTHONUNBUFFERED=1
• Python interpreter: Python 3.9
• Working directory: ./api

(Obsolete?) Config Titiler endpoint and maap-api-host

In the settings.py (i.e., maap-api-nasa/api/settings.py):

# settings.py
API_HOST_URL = 'http://0.0.0.0:5000/' # For local testing

# ...

# The endpoint obtained after doing Titiler deployment
TILER_ENDPOINT = 'https://XXX.execute-api.us-east-1.amazonaws.com'
# If running the tiler locally, this can be TILER_ENDPOINT = 'http://localhost:8000'

Run the app:

poetry shell
FLASK_APP=api/maapapp.py flask run --host=0.0.0.0

Some issues you may experience while running the above line:

• Allowing using postgres without login (A fix for 'fe_sendauth: no password supplied'):

  sudo vi /etc/postgresql/9.5/main/pg_hba.conf #(the location may be different depend on OS and postgres version)

  # Reconfig as follows:
      local   all     all     trust
      host    all     all     127.0.0.1/32    trust
      host    all     all     ::1/0           trust
  # Save pg_hba.conf
  

  # Restart postgresql
  sudo /etc/init.d/postgresql reload
  sudo /etc/init.d/postgresql start

Running tests

When using docker-compose to start the app it is possible to run the tests locally if you first update the settings.py DATABASE_URL value to specify localhost as the servername instead of db (DO NOT check in this change).

python -m unittest test/api/endpoints/test_wmts_get_tile.py

If you are running the latest version of Titiler, use the following local test scripts: while keeping the server in the previous step running (i.e., local maap-api-nasa). Open a new terminal

poetry env use $(poetry env info -e)

#If you are running the latest version of Titiler, then use the following test scripts:
python -m unittest -v test/api/endpoints/test_wmts_get_tile_new_titiler.py
python -m unittest -v test/api/endpoints/test_wmts_get_capabilities_new_titiler.py

III. User Accounts

A valid MAAP API token must be included in the header for any API request. An Earthdata account is required to access the MAAP API. To obtain a token, URS credentials must be provided as shown below:

curl -X POST --header "Content-Type: application/json" -d "{ \"username\": \"urs_username\", \"password\": \"urs_password\" }" https://api.dit.maap-project.org/token

Comments:

• After running the local maap-api-nasa, go to http://0.0.0.0:5000/api to see the APIs.

• Or running the your own test scripts with:

curl -X POST --header "Content-Type: application/json" -d "{ \"username\": \"urs_username\", \"password\": \"urs_password\" }" http://0.0.0.0:5000/token