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

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

{
    "ob_id": 31965,
    "uuid": "28e889210f884b469d7168fde4b4e54f",
    "title": "ESA Permafrost Climate Change Initiative (Permafrost_cci):   Permafrost extent for the Northern Hemisphere, v2.0",
    "abstract": "This dataset contains permafrost extent data produced as part of the European Space Agency's (ESA) Climate Change Initiative (CCI) Permafrost project. It forms part of the first version of their Climate Research Data Package (CRDP v1). It is derived from a thermal model driven and constrained by satellite data. Grid products of CDRP v1 are released in annual files, covering the start to the end of the Julian year. This corresponds to average annual ground temperatures (at 2 m depth) which forms the basis for the retrieval of yearly fraction of permafrost-underlain and permafrost-free area within a pixel. A classification according to the IPA (International Permafrost Association) zonation delivers the well-known permafrost zones, distinguishing isolated (0-10%) sporadic (10-50%), discontinuous (50-90%) and continuous permafrost (90-100%).\r\n\r\nCase A: It covers the Northern Hemisphere (north of 30°) for the period 2003-2017 based on MODIS Land Surface temperature merged with downscaled ERA5 reanalysis near-surface air temperature data.  \r\nCase B: It covers the Northern Hemisphere (north of 30°) for the period 1997-2002 based on downscaled ERA5 reanalysis near-surface air temperature data which are bias-corrected with the Case A product for the overlap period 2003-2018 using a pixel-specific statistics for each day of the year.",
    "keywords": "Permafrost, CCI, Permafrost Extent",
    "publicationState": "citable",
    "dataPublishedTime": "2020-11-02T15:39:12",
    "doiPublishedTime": "2020-11-02T16:04:34",
    "updateFrequency": "notPlanned",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/31972/?format=api",
        "dataPath": "/neodc/esacci/permafrost/data/permafrost_extent/L4/area4/pp/v02.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 3459944346,
        "numberOfFiles": 23,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8768/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2568/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/27732/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50547/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/50548/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/64149/?format=api"
    ],
    "dataLineage": "Data have been produced by the ESA CCI Permafrost project as part of ESA's Climate Change Initiative programme",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10788/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/29966/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/31981/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141388/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141390/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141391/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141392/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141393/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141412/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141413/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141389/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141394/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141395/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141396/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141397/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141398/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141399/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141400/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141401/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141402/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141403/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141404/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141405/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141406/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141407/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141408/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141409/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141410/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/141411/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/31971/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2596/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_permafrost_terms_and_conditions.pdf",
            "licenceClassifications": ""
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}