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

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

{
    "ob_id": 27299,
    "uuid": "60d5d5e095024831a6f45e4febe4a95e",
    "title": "APHH: Meteorology and atmospheric chemistry measurements made at the Xibaidian, Beijing site during the summer and winter campaigns.",
    "abstract": "This dataset contains wind speed and direction, air temperature, relative humidity, barometric pressure, nitric oxide, nitric dioxide, nitric oxides, sulphur dioxide, carbon dioxide, ozone and pm2.5 based on a newly built-up rural site at Xibaidian, Pinggu district, Beijing in winter 2016 and summer 2017. The data were taken for the APHH-Beijing campaign for the Effects of air pollutions on cardiopulmonary disease in urban and peri-urban residents in Beijing (AIRLESS) project as part of the Atmospheric Pollution & Human Health in a Chinese Megacity (APHH) programme.\r\n\r\nInstruments were deployed on the roof of a one-story building in the far north end of a village, where most of the subjects resided nearby. Northern winds tend to bring relatively clean background air. In contrast, winds from the south are often contaminated by emissions from traffic and industries. \r\n\r\nThe following instruments were used:\r\n1. Meteorological parameter: TH16A meteorological station\r\n2. NOx: TEI 42 trace level chemiluminescence NOx Analyzer;\r\n3. SO2: Ecotech EC9850 Sulfur Dioxide Analyzer\r\n4. CO: Ecotech EC9830 Carbon Monoxide Analyzer\r\n5. O3: Ecotech EC9810 Ozone Analyzer\r\n6. PM2.5: Met One BAM 1020\r\n\r\nThe dataset was collected in Xibaidian, Pinggu district,  Beijing for the Effects of air pollutions on cardiopulmonary disease in urban and peri-urban residents in Beijing (AIRLESS) project can provide ambient level of air pollutant in rural Beijing, enabling better understanding of the exposure level for local residents and potential examination for the related health effects.",
    "keywords": "APHH, AIRLESS, China, Meteorology, Chemistry",
    "publicationState": "published",
    "dataPublishedTime": "2019-02-28T12:54:33",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27300/?format=api",
        "dataPath": "/badc/aphh/data/beijing/ucl-met-chem",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 155910,
        "numberOfFiles": 2,
        "fileFormat": "Data are BADC-CSV formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7321/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2387/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54165/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54167/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54170/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59281/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59282/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59283/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59284/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59285/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59286/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59287/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59288/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59289/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/59290/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60664/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60665/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60666/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/60667/?format=api"
    ],
    "dataLineage": "Data produced by APHH project participants at University College London and uploaded to 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/24808/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/24880/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/24817/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114160/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114159/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114167/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114161/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114162/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114164/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114165/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114166/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/114163/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/27308/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}