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/32785/?format=api

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

{
    "ob_id": 32785,
    "uuid": "67b646c363fc4f9289486ffd8c4c6b07",
    "title": "Sentinel 3A Synthetic Aperture Radar Altimeter (SRAL) Level 1A data",
    "abstract": "This dataset contains level 1a altimetry data from the Synthetic Aperture Radar Altimeter (SRAL) aboard the European Space Agency (ESA) Sentinel 3A Satellite. Sentinel 3A was launched on the 16th of February 2016. These data contain geo-located bursts of echoes with all calibrations applied. Level 1A (L1A) is an intermediate output of the Synthetic Aperture Radar (SAR) processor. L1A complex waveforms should be fully calibrated (including both instrumental gains and calibration corrections) and aligned in range within each burst. The time tag is given at the surface (that is when the middle of the burst reaches the surface). L1A is the starting point for the SAR processing which provides high-resolution products. Data are provided by ESA and are made available via CEDA to any registered user.",
    "keywords": "Sentinel, Synthetic Aperture Radar Altimeter, SRAL",
    "publicationState": "published",
    "dataPublishedTime": "2022-12-19T15:36:13",
    "doiPublishedTime": null,
    "updateFrequency": "continual",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/32786/?format=api",
        "dataPath": "/neodc/sentinel3a/data/SRAL/L1_SRA_A__/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 11349097935027,
        "numberOfFiles": 13802,
        "fileFormat": "Data are provided by ESA in zipped SAFE format."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/9014/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data collected and prepared by European Space Agency (ESA). Downloaded from the Sentinel hubs for use by the CEDA 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/32818/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30129/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146384/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146377/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146378/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146379/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146380/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146381/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146382/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146376/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146375/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146383/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/146385/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/32824/?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": []
}