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

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

{
    "ob_id": 38327,
    "uuid": "4dd145a7060143cd875325390d3b01c8",
    "title": "ESA Soil Moisture Climate Change Initiative (Soil_Moisture_cci): PASSIVE product, Version 06.2",
    "abstract": "The Soil Moisture CCI PASSIVE dataset is one of three datasets created as part of the European Space Agency's (ESA) Soil Moisture Essential Climate Variable (ECV) Climate Change Initiative (CCI) project. The product has been created by merging data from the SMMR, SSM/I, TMI, AMSR-E, WindSat, AMSR2, SMOS, SMAP, FY-3B and GPM satellite instruments. ACTIVE and COMBINED products have also been created.\r\n\r\nThe v06.2 PASSIVE product, provided as global daily images in NetCDF-4 classic file format, presents a global coverage of surface soil moisture at a spatial resolution of 0.25 degrees. It is provided in volumetric units [m3 m-3] and covers the period (yyyy-mm-dd) 1978-11-01 to 2021-12-31. For information regarding the theoretical and algorithmic base of the product, please see the Algorithm Theoretical Baseline Document. Additional reference documents and information relating to the dataset can also be found on the CCI Soil Moisture project website.\r\n\r\nThe data set should be cited using the following references:\r\n\r\n1. Gruber, A., Scanlon, T., van der Schalie, R., Wagner, W., and Dorigo, W. (2019). Evolution of the ESA CCI Soil Moisture climate data records and their underlying merging methodology, Earth Syst. Sci. Data, 11, 717–739, https://doi.org/10.5194/essd-11-717-2019\r\n\r\n2. Dorigo, W.A., Wagner, W., Albergel, C., Albrecht, F., Balsamo, G., Brocca, L., Chung, D., Ertl, M., Forkel, M., Gruber, A., Haas, E., Hamer, D. P. Hirschi, M., Ikonen, J., De Jeu, R. Kidd, R. Lahoz, W., Liu, Y.Y., Miralles, D., Lecomte, P. (2017). ESA CCI Soil Moisture for improved Earth system understanding: State-of-the art and future directions. In Remote Sensing of Environment, 2017, ISSN 0034-4257, https://doi.org/10.1016/j.rse.2017.07.001",
    "keywords": "ESA, CCI, Passive, Soil Moisture",
    "publicationState": "published",
    "dataPublishedTime": "2023-03-10T12:30:06",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/39686/?format=api",
        "dataPath": "/neodc/esacci/soil_moisture/data/daily_files/PASSIVE/v06.2",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 16047379733,
        "numberOfFiles": 15768,
        "fileFormat": "Data are in NetCDF format."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/10567/?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/52664/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/52665/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54641/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54646/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54647/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54648/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54649/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54650/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/54651/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62501/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/62745/?format=api"
    ],
    "dataLineage": "Data were processed by the ESA CCI Soil Moisture project team and transferred to CEDA for the ESA CCI Open Data Portal Project",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/13332/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/38329/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182512/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182514/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182515/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182516/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182517/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182518/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182519/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182513/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182521/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182520/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182522/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182523/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182524/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182525/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182526/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182527/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182528/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182529/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182530/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/182531/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/32307/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2535/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_soilmoisture_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}