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

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

{
    "ob_id": 33298,
    "uuid": "9c350d4ff7ee438f9f1fc7252cbb2282",
    "title": "ESA Sea State Climate Change Initiative (Sea_State_cci) : Global remote sensing merged multi-mission monthly gridded significant wave height from altimetry,  L4 product, version 3",
    "abstract": "The ESA Sea State Climate Change Initiative (CCI) project has produced global multi-sensor time-series of along-track satellite altimeter significant wave height data (referred to as Level 4 (L4) data) with a particular focus for use in climate studies.\r\n\r\nThis dataset contains the Version 3 Remote Sensing Significant Wave Height product, gridded over a global regular cylindrical projection (1°x1° resolution), averaging valid and good measurements from all available altimeters on a monthly basis (using the L2P products also available). These L4 products are meant for statistics and visualization.\r\n\r\nThe altimeter data used in the Sea State CCI dataset v3 come from multiple satellite missions spanning from 2002 to 2021 ( Envisat, CryoSat-2, Jason-1, Jason-2, Jason-3, SARAL, Sentinel-3A), therefore spanning over a shorter time range than version 1.1. Unlike version 1.1, this version 3 involved a complete and consistent retracking of all the included altimeters. Many altimeters are bi-frequency (Ku-C or Ku-S) and only measurements in Ku band were used, for consistency reasons, being available on each altimeter but SARAL (Ka band).",
    "keywords": "Sea State, CCI, Significant Wave Height",
    "publicationState": "citable",
    "dataPublishedTime": "2022-10-10T09:23:54",
    "doiPublishedTime": "2022-10-11T15:07:23",
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/38280/?format=api",
        "dataPath": "/neodc/esacci/sea_state/data/v3_release/altimeter/l4/v3.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 414414459,
        "numberOfFiles": 225,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10551/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2578/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6021/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/6022/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/12066/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60940/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60941/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/66538/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67813/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67814/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67815/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67816/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67817/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67818/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67819/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67820/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67821/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67822/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67823/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67824/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67825/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67826/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67827/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67828/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67829/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67830/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67831/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67832/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/67833/?format=api"
    ],
    "dataLineage": "Data was produced by the ESA Sea State CCI team at Ifremer and was transferred to CEDA as part of the ESA CCI Open Data Portal project.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/12211/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/30004/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148681/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148684/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148678/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148682/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148683/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148677/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148680/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148679/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148685/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148686/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/148687/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/38290/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2604/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_sea_state_terms_and_conditions.pdf",
            "licenceClassifications": ""
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}