creodias-finder

Query the CREO Data finder API for available products.

Usage

Query and download Sentinel-1 products for a given time range

import geojson
from datetime import datetime

from creodias_finder import query

results = query.query(
    'Sentinel1',
    start_date=datetime(2019, 1, 1),
    end_date=datetime(2019, 1, 2)
)

Returns

[
    ...,
    {'geometry': {'coordinates': [[[-66.400017, -65.643265],
                               [-58.727936, -63.775444],
                               [-56.687397, -65.090927],
                               [-64.635124, -67.052101],
                               [-66.400017, -65.643265]]],
              'type': 'Polygon'},
     'id': '639595ae-da84-5eac-a96d-aa5e323ca0e9',
     'properties': {'centroid': {'coordinates': [-61.543707, -65.4137725],
                                 'type': 'Point'},
                    'cloudCover': -1,
                    'collection': 'Sentinel1',
                    'completionDate': '2019-01-03T00:00:18.941Z',
                    'description': None,
                    'gmlgeometry': '<gml:Polygon '
                                   'srsName="EPSG:4326"><gml:outerBoundaryIs><gml:LinearRing><gml:coordinates>-66.400017,-65.643265 '
                                   '-58.727936,-63.775444 -56.687397,-65.090927 '
                                   '-64.635124,-67.052101 '
                                   '-66.400017,-65.643265</gml:coordinates></gml:LinearRing></gml:outerBoundaryIs></gml:Polygon>',
                    'instrument': 'SAR',
                    'keywords': [{'href': 'https://finder.creodias.eu/resto/api/collections/Sentinel1/search.json?&lang=en&q=Antarctica',
                                  'id': 'ab3b4ea14403e2e',
                                  'name': 'Antarctica',
                                  'normalized': 'antarctica',
                                  'type': 'continent'},
                                 {'gcover': 0.25,
                                  'href': 'https://finder.creodias.eu/resto/api/collections/Sentinel1/search.json?&lang=en&q=Antarctica',
    ...
]

Download selected products

from creodias_finder import download

ids = [result['id'] for key in results.values()]

CREDENTIALS = {
    username: 'my-creodias-email',
    password: 'my-creodias-password'
}

# download single product by product ID
download.download(ids[0], outfile='/home/andreas/data/', **CREDENTIALS)

# download a list of products, multithreaded
download.download_list(ids[1:11], threads=10, **CREDENTIALS)