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

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

{
    "ob_id": 27786,
    "uuid": "ad00efa6f2b44d92aa1022e5b122bb22",
    "title": "GAUGE: Ecotech Spectronus FTIR greenhouse gas concentrations on a landfill site near Great Blakenham, Suffolk, from 7th August 2014 to 15th August 2014",
    "abstract": "This dataset contains concentrations of methane, carbon dioxide, nitrous oxide, and carbon monoxide measured using an Ecotech Spectronus FTIR (Fourier transform infrared) spectrometer. The instrument operated from 7 August 2014 to 15 August 2014 on a landfill site near Great Blakenham, Suffolk. The measurement site was located at 52.112N, 1.082E, and the inlet was located 2m above the ground.\r\n\r\nThis data was collected as part of the Natural Environment Research Council (NERC) Greenhouse gAs Uk and Global Emissions (GAUGE) project.\r\n\r\nThe GAUGE project aimed to determine the magnitude, spatial distribution and uncertainties of the UK's Greenhouse Gas budget using new and existing measurement networks and modelling approaches at a range of scales.",
    "keywords": "GAUGE, FTIR, methane, carbon dioxide, carbon monoxide, nitrous oxide, spectrometer",
    "publicationState": "published",
    "dataPublishedTime": "2019-09-24T07:59:48",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27789/?format=api",
        "dataPath": "/badc/gauge/data/station/great-blakenham/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 458937,
        "numberOfFiles": 2,
        "fileFormat": "Data are BADC-CSV formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7433/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2441/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59099/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70274/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70275/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70276/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70277/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70278/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70279/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70280/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/70281/?format=api"
    ],
    "dataLineage": "Data were collected by the University of Leicester and deposited at the Centre for Environmental Data Analysis (CEDA) for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/12409/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12404/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116089/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116084/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116085/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116086/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116090/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116087/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116091/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116088/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116092/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/168407/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/116093/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27788/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2528/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://creativecommons.org/licenses/by/4.0/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}