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

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

{
    "ob_id": 37588,
    "uuid": "10af126c9dcf40e2aff7c3cf835d7e6b",
    "title": "EUMETNET E-PROFILE: ceilometer cloud base height and aerosol profile data from KNMI's Lufft CHM15k \"Nimbus\" instrument A deployed at Amsterdam Ap Schiphol, Netherlands",
    "abstract": "Daily concatenated files of ceilometer cloud base height and aerosol profile data from Royal Netherlands Meteorological Institute (KNMI)'s Lufft CHM15k \"Nimbus\" deployed at Amsterdam Ap Schiphol, Netherlands.\r\n\r\nThese data were produced by the EUMETNET's E-PROFILE processing hub as part of the ceilometer and lidar network operated as part of the by EUMETNET members. This network covers most of Europe with additional sites worldwide.\r\n\r\nThe site has a corresponding WMO Integrated Global Observing System (WIGOS) id: 0-20000-0-06240.\r\n See online documentation for link to station details in the Observing Systems Capability Analysis and Review (OSCAR) Tool. Note: this WIGOS ID is shared by 4 instruments located at the site. Data from the 4 instruments use one shared value for latitude and longitude:\r\n\r\nLatitude: 52.317008972168 N\r\nLongitude: 4.80366992950439 E\r\n \r\nThe actual instrument deployments are as follows:\r\n\r\nInstrument: Amsterdam AP Schiphol A\r\nLatitude: 52.317010 N\r\nLongitude: 4.803670 E\r\nAltitude: -4\r\nLocation: Amsterdam AP Schiphol end of runway 27\r\n\r\nInstrument: Amsterdam AP Schiphol B\r\nLatitude: 52.286140 N\r\nLongitude: 4.729310 E\r\n-Altitude: -4\r\nLocation: Amsterdam AP Schiphol end of runway 06\r\n \r\nInstrument: Amsterdam AP Schiphol C\r\nLatitude: 52.368290 N\r\nLongitude: 4.712660 E\r\nAltitude: --4\r\nLocation: Amsterdam AP Schiphol end of runway 18R\r\n \r\nInstrument: Amsterdam AP Schiphol D\r\nLatitude: 52.3395500183105 N\r\nLongitude: 4.7407398223877 E\r\nAltitude: --4\r\nLocation: Amsterdam AP Schiphol end of runway 18C \r\n    \r\nEUMETNET is a grouping of 31 European National Meteorological Services that provides a framework to organise co-operative programmes between its Members in the various fields of basic meteorological activities. One such programme is the EUMETNET Profiling Programme: E-PROFILE. See EUMETNET page linked from this record for further details of EUMETNET's activities.",
    "keywords": "E-PROFILE, ceilometer measurements",
    "publicationState": "published",
    "dataPublishedTime": "2022-06-10T23:10:06",
    "doiPublishedTime": null,
    "updateFrequency": "daily",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/37587/?format=api",
        "dataPath": "/badc/eprofile/data/daily_files/netherlands/amsterdam-ap-schiphol/knmi-lufft-chm15k_A",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 3481194357,
        "numberOfFiles": 1314,
        "fileFormat": "Data are netCDF formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10377/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/3521/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46582/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46583/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46584/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46585/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46586/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46587/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46588/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46589/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46590/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46591/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46592/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46593/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46594/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46595/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46597/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46598/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/46599/?format=api"
    ],
    "dataLineage": "Data were collected by instrument and transmitted to the central E-PROFILE processing hub at the UK's Met Office before preparation and delivery to the Centre for Environmental Data Analysis (CEDA). CEDA then produces daily concatenated files before ingestion into the CEDA Archive.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/32779/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/34905/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179397/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179398/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179399/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179400/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179401/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179402/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179403/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179404/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/179405/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/37589/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2527/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/cuncgl",
            "licenceClassifications": "personal, academic, policy"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}