woudc-api

REST and OGC API for WOUDC data services

Overview

WOUDC API provides a RESTful API for that provides discovery and access to ozone and ultraviolet radiation data in support of the World Ozone and Ultraviolet Radiation Data Centre (WOUDC), one of six World Data Centres as part of the Global Atmosphere Watch programme of the WMO.

Installation

Requirements

• Python 3 and above
• virtualenv
• Elasticsearch (5.5.0 and above)
• pygeoapi
• woudc-extcsv (0.5.0 and above)

Dependencies

Dependencies are listed in requirements.txt. Dependencies are automatically installed during installation.

Installing woudc-api

# setup virtualenv
python3 -m venv --system-site-packages woudc-api
cd woudc-api
source bin/activate

# setup local OGC schemas (i.e. WOUDC_API_OGC_SCHEMAS_LOCATION in default.env)
mkdir schemas.opengis.net
curl -O http://schemas.opengis.net/SCHEMAS_OPENGIS_NET.zip && unzip ./SCHEMAS_OPENGIS_NET.zip "ogcapi/*" -d schemas.opengis.net && rm -f ./SCHEMAS_OPENGIS_NET.zip

# clone pygeoapi codebase and install
git clone https://github.com/geopython/pygeoapi.git
cd pygeoapi
python setup.py install
cd ..

# clone woudc-api codebase and install
git clone https://github.com/woudc/woudc-api.git
cd woudc-api
python setup.py install

# set system environment variables
cp default.env local.env
vi local.env  # edit accordingly
. local.env

# generate openapi document
pygeoapi openapi generate -c $PYGEOAPI_CONFIG > $PYGEOAPI_OPENAPI

# run the server
woudc-api serve  # server runs on http://localhost:5000

curl http://localhost:5000  # redirect to WOUDC data services pages

curl http://localhost:5000/oapi  # OGC API endpoint

Development

# install dev requirements
pip install -r requirements-dev.txt

Code Conventions

• PEP8

Bugs and Issues

All bugs, enhancements and issues are managed on GitHub.

Contact

• Tom Kralidis
• Kevin Ngai