Observation Instance – Django REST framework

Get a list of Observation objects.

### Available end points:

- `/observations/` - Will list all Results in the database
- `/observations.json` - Will return all Results in json format. This can
also be achieved by using the accept header. `application/json`
- `/observations/<object_id>/` - Returns Results object with that id

### Available Methods:

- `GET`
- `HEAD`

### Available filters:

- `title`
- `uuid`
- `keywords`
- `status`
- `result_field`
- `discoveryKeywords`
- `updateFrequency`
- `nonGeographicFlag`
- `publicationState`
- `permissions`

### How to use filters:

These filters can be used like django query filters using __ for related model relationships.

- `/observations/?uuid=d594d53df2612bbd89c2e0e770b5c1a0`
- `/observations/?status=completed`
- `/observations/?results_field__dataPath__startswith=/neodc/esacci`
- `/observations/?discoveryKeywords__name=ESACCI`
- `/observations/?nonGeographicFlag=True`

Filters can be stacked to build an 'AND' relationship. E.g.

- `/observations/?publicationState__in=published,citable&nonGeographicFlag=True`
- `/observations/?publicationState__in=published,citable&discoveryKeyword__name=NDGO0003`

GET /api/v2/observations/19025/?format=api

HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 19025,
    "uuid": "99180e6c305744be9b5e73b7a0e4b324",
    "title": "Sentinel 3A Ocean and Land Colour Instrument (OLCI) Ocean Colour Full Resolution (EFR) data",
    "abstract": "This dataset contains ocean and land colour imagery data from the Ocean and Land Colour Instrument (OLCI) aboard the European Space Agency (ESA) Sentinel 3A Satellite. Sentinel 3A was launched on the 16th February 2016. Data are provided by ESA and are made available via CEDA to any registered user. OLCI is an optical instrument used to provide data continuity for Environmental Satellite (ENVISAT's) Medium Resolution Imaging Spectrometer (MERIS). OLCI is a push-broom imaging spectrometer that measures solar radiation reflected by the Earth. The OLCI radiometer images using 21 spectral bands ranging from 400nm to 1020nm.  The Full Resolution (EFR) data is calibrated, geo-located and spatially re-sampled Top Of Atmosphere (TOA) radiance for all 21 OLCI spectral bands. For the normal orbit of Sentinel 3A the OLCI instrument provides a spatial resolution of 300m with worldwide coverage every ~2 days.\r\n\r\nThe OLCI files are collected into a SAFE container. Processed level-1 products are encapsulated in free-standing NetCDF 4 product files.",
    "keywords": "Sentinel, Ocean and Land Colour Instrument, OLCI",
    "publicationState": "published",
    "dataPublishedTime": "2022-10-18T14:48:38",
    "doiPublishedTime": null,
    "updateFrequency": "continual",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/20124/?format=api",
        "dataPath": "/neodc/sentinel3a/data/OLCI/L1_EFR/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 191677015118077,
        "numberOfFiles": 791400,
        "fileFormat": "These image files are in NETCDF4 format."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/4980/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26117/?format=api"
    ],
    "dataLineage": "Data collected and prepared by European Space Agency (ESA). Downloaded for use by the UK scientific community.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12321/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30129/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/32818/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/71606/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/71602/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/71608/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/71604/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/71603/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/143586/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182460/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/71605/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/71609/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/71607/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/19026/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2586/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://sentinel.esa.int/documents/247904/690755/Sentinel_Data_Legal_Notice",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}