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

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

{
    "ob_id": 26901,
    "uuid": "a7ba08d073eb40a9aab5e312f371d007",
    "title": "MIDAS Open: UK soil temperature data, v201901",
    "abstract": "The UK soil temperature data contain daily and hourly values of soil temperatures at depths of 5, 10, 20, 30, 50, and 100 centimetres. The measurements were recorded by observation stations operated by the Met Office across the UK and transmitted within NCM or DLY3208 messages. The data spans from 1900 to 2017.\r\n\r\nAt many stations temperatures below the surface are measured at various depths. The depths used today are 5, 10, 20, 30 and 100cm, although measurements are not necessarily made at all these depths at a station and exceptionally measurements may be made at other depths. When imperial units were in general use, typically before 1961, the normal depths of measurement were 4, 8, 12, 24 and 48 inches.\r\n\r\nLiquid-in-glass soil thermometers at a depth of 20 cm or less are unsheathed and have a bend in the stem between the bulb and the lowest graduation. At greater depths the thermometer is suspended in a steel tube and has its bulb encased in wax.\r\n\r\nThis dataset is part of the Midas-open dataset collection made available by the Met Office under the UK Open Government Licence, containing only UK mainland land surface observations owned or operated by Met Office. It is a subset of the fuller, restricted Met Office Integrated Data Archive System (MIDAS) Land and Marine Surface Stations dataset, also available through the Centre for Environmental Data Analysis - see the related dataset section on this record.",
    "keywords": "Met Office, MIDAS, UK, meteorology, soil temperatures",
    "publicationState": "citable",
    "dataPublishedTime": "2019-02-12T14:30:19",
    "doiPublishedTime": "2019-03-01T08:55:33",
    "updateFrequency": "notPlanned",
    "status": "superseded",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/26902/?format=api",
        "dataPath": "/badc/ukmo-midas-open/data/uk-soil-temperature-obs/dataset-version-201901/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 3610831227,
        "numberOfFiles": 22503,
        "fileFormat": "Data are BADC-CSV formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7298/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/18/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68374/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68379/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68386/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68403/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68404/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68405/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68406/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68407/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68408/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68409/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68410/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68411/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68426/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68427/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68428/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68429/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68430/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68431/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68432/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68433/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/68434/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69868/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69869/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69870/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69871/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69873/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69874/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69875/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69876/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69877/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69878/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69879/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69880/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69881/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69882/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69883/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69884/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69885/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/69886/?format=api"
    ],
    "dataLineage": "Data collated by the Met Office and archived in the Met Office's MIDAS database. Data are extracted from a sub-set of available tables and delivered to Centre for Environmental Data Analysis (CEDA) approximately on a yearly basis.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/10497/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/1186/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/26184/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112935/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112940/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112941/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112938/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112937/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112936/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112934/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/112939/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/117063/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/1227/?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"
        }
    ]
}