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

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

{
    "ob_id": 25918,
    "uuid": "9255faeb392f41debf5402caa40dada8",
    "title": "ESA Greenhouse Gases Climate Change Initiative (GHG CCI): Column-averaged CO2 from GOSAT generated with the OCFP (UoL-FP) algorithm (CO2_GOS_OCFP), v7.0",
    "abstract": "The CO2_GOS_OCFP dataset comprises level 2, column-averaged dry-air mole fractions (mixing ratios) of carbon dioxide (XCO2) from the Thermal and Near Infrared Sensor for Carbon Observations (TANSO-FTS) NIR and SWIR spectra, onboard the Japanese Greenhouse gases Observing Satellite (GOSAT). It has been produced using the University of Leicester Full-Physics Retrieval Algorithm, which is based on the original Orbiting Carbon Observatory (OCO) Full Physics Retrieval Algorithm and modified for use on GOSAT spectra. A second product, generated using the alternative SRFP algorithm, is also available. The OCFP product is considered the GHG_cci baseline product and it is advised that users who aren't sure which of the two products to use, use this product.  For more information regarding the differences between baseline and alternative algorithms please see the Greenhouse Gases CCI data products webpage.\r\n\r\nThe XCO2 product is stored in NetCDF format with all GOSAT soundings on a single day stored in one file. For further information, including details of the OCFP algorithm and the TANSO-FTS instrument, please see the associated product user guide (PUG).",
    "keywords": "ESA, GHG, CCI, CO2",
    "publicationState": "published",
    "dataPublishedTime": "2018-03-19T20:57:12",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/25919/?format=api",
        "dataPath": "/neodc/esacci/ghg/data/crdp_4/GOSAT/CO2_GOS_OCFP/v7.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1829382960,
        "numberOfFiles": 2388,
        "fileFormat": "Data are in NetCDF format"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7000/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/529/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1050/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1635/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/1636/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11816/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11852/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11853/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11854/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11855/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11856/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11857/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11858/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11859/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11860/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11863/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11864/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11866/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11867/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11869/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11870/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11871/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/11872/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/13276/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25159/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25160/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/25161/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/26287/?format=api"
    ],
    "dataLineage": "Data were processed by the ESA CCI GHG project team and supplied to CEDA as part of the ESA CCI Open Data Portal Project",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13295/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/12808/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/30128/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108340/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108334/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108335/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108339/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108338/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108337/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108333/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108336/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/108341/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2564/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_ghg_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        },
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}