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

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

{
    "ob_id": 32504,
    "uuid": "723f7b8c12b046de94436f74c6d260cc",
    "title": "Air quality and meteorological measurements taken from Guangzhou Institute of Geochemistry (GIG), China (31/07/2019 -31/12/2019)",
    "abstract": "This dataset contains ozone, NO, NO2, NOX, SO2 and PM2.5 air quality and meteorological measurements from two campaigns undertaken in Guangzhou, China in 2019. NO, NO2 and NOX were measured by Chemiluminescence with a Thermo scientific 42i-TL. Ozone were measured via UV with a Thermo scientific 49i. PM2.5 were measured by a continuous particulate monitor (BAM-1020, Met One instruments Inc). SO2 were measured via Pulsed fluorescence with a Thermo scientific 43i-TLE. \r\nThis data were collected as part of the NERC project Investigating the large source of particulate mass from nitrophenols observed in Beijing during winter haze events (NITRO-PM).",
    "keywords": "NO, NO2, NOX, SO2, PM2.5, air quality, meteorology, China",
    "publicationState": "published",
    "dataPublishedTime": "2021-06-09T15:47:46",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/32505/?format=api",
        "dataPath": "/badc/deposited2021/nitro-pm/data/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 13933932,
        "numberOfFiles": 3,
        "fileFormat": "Data are NASA-Ames formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/8929/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/2762/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46836/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46837/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46838/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46839/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46840/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46841/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46842/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46843/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46844/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46845/?format=api"
    ],
    "dataLineage": "Data were collected, quality controlled and prepared for archiving by the instrument scientists before upload to the Centre for Environmental Data Analysis (CEDA) for long term archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/32506/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/144721/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/144710/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/144711/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/144712/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/144713/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/144714/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/144715/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/144720/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/144722/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/144723/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/144724/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/32507/?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"
        }
    ]
}