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

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

{
    "ob_id": 27563,
    "uuid": "d2090552c8fe4c16a2fd7d616adc2d9f",
    "title": "Deriving Emissions related to Climate Change Network: CO2, CH4, N2O, SF6 and CO measurements from Bilsdale Tall Tower, North York Moors National Park",
    "abstract": "High frequency measurements of carbon dioxide (CO2), methane (CH4), nitrous oxide (N2O), sulfur hexafluoride (SF6) and carbon monoxide (CO) made at  Bilsdale Tall Tower, North York Moors National Park were made for the UK-DECC (Deriving Emissions related to Climate Change) Network. \r\n\r\nBilsdale (BSD) tall tower is in a remote area of the North York Moors National Park and is the first monitoring site in the northeast region of England. The closest large conurbations are York and Middlesbrough, located 30 miles south and 16 miles northeast, respectively. The tower is on a high plateau overlooking green valleys used mainly for livestock (sheep and cattle). Between 2014-01-01 and 2017-03-17, air samples are taken from a line sampling 108 m above ground level. From 2017-03-17 onwards, air was sampled from 248 m above ground level. Due to the sites location, far from strong sources of local pollution, measurements from this site will be used to calculate emission maps of trace gas species in the UK in combination with other measurement stations in the UK (Ridge Hill, Tacolneston and Heathfield) and Ireland (Mace Head).\r\n\r\n\r\nThis work was funded by  Business Energy and Industrial Strategy (BEIS) contracts TRN1028/06/2015 and TRN1537/06/2018 to the University of Bristol.",
    "keywords": "UK-DECC, Bilsdale, trace gas",
    "publicationState": "published",
    "dataPublishedTime": "2019-09-04T10:05:24",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27564/?format=api",
        "dataPath": "/badc/uk-decc-network/data/previous_versions/Bilsdale",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 603829253,
        "numberOfFiles": 52,
        "fileFormat": "NetCDF"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7392/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2298/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58411/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58412/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58413/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58414/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58415/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/58416/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/61969/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74599/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74600/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74601/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74602/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74603/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74605/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74606/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74607/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74609/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74612/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/74613/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75537/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/75543/?format=api"
    ],
    "dataLineage": "Data were collected by the University of Bristol 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/27561/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/27499/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115279/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115274/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115275/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115272/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115277/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115273/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115269/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115276/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115270/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/115271/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179869/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179870/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27565/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2526/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}