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

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

{
    "ob_id": 6750,
    "uuid": "6d02f556f6941a050d2c52ad5ad9f4b0",
    "title": "QESDI: MODIS land cover classification data",
    "abstract": "QUEST projects both used and produced an immense variety of global data sets that needed to be shared efficiently between the project teams. These global synthesis data sets are also a key part of QUEST's legacy, providing a powerful way of communicating the results of QUEST among and beyond the UK Earth System research community.\r\n\r\nThis dataset contains MODIS land cover classification data.\r\n\r\nThe MODIS Land Cover Type product contains multiple classification schemes, which describe land cover properties derived from observations spanning a year's input of Terra and Aqua data. The primary land cover scheme identifies 17 land cover classes defined by the International Geosphere Biosphere Programme (IGBP), which includes 11 natural vegetation classes, 3 developed and mosaicked land classes, and three non-vegetated land classes. The MODIS Terra + Aqua Land Cover Type Yearly L3 Global 500 m SIN Grid product incorporates five different land cover classification schemes, derived through a supervised decision-tree classification method:\r\n\r\n* Land Cover Type 1: IGBP global vegetation classification scheme\r\n* Land Cover Type 2: University of Maryland (UMD) scheme\r\n* Land Cover Type 3: MODIS-derived LAI/fPAR scheme\r\n* Land Cover Type 4: MODIS-derived Net Primary Production (NPP) scheme\r\n* Land Cover Type 5: Plant Functional Type (PFT) scheme\r\n\r\nThe dataset stored here has been aggregated onto a 10 arc minute grid by Jose Gomez-Dans, working within the QUEST FIREMAFS project.",
    "keywords": "QUEST, QESDI, Land cover, Modis",
    "publicationState": "published",
    "dataPublishedTime": "2009-08-25T10:57:29",
    "doiPublishedTime": null,
    "updateFrequency": "",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/6751/?format=api",
        "dataPath": "/badc/quest/data/qesdi/external/modis",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 29400733674,
        "numberOfFiles": 639,
        "fileFormat": "Data are netCDF formatted"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/1973/?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/51186/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/51187/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91590/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91591/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91592/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91593/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91594/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91595/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91596/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91597/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91598/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91599/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91600/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91601/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91602/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91603/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91604/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91605/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/phenomona/91606/?format=api"
    ],
    "dataLineage": "Data created from MODIS_classification_IGBP.tiff",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/4445/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/6747/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/6742/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28972/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28971/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28977/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/71798/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28976/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28974/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28975/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/28973/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": "https://api.catalogue.ceda.ac.uk/api/v2/composites/6755/?format=api",
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2543/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/missing_licence.pdf",
            "licenceClassifications": "unstated"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}