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

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

{
    "ob_id": 10871,
    "uuid": "cfb9601675a667247a8bd5fb0e58f396",
    "title": "25m resolution raster formatted data from the CEH Land Cover Map 2000 for Monks Wood, Cambridgeshire, UK, in support of  the Network for Calibration and Validation of EO (NCAVEO) campaign.",
    "abstract": "This dataset contains 25m resolution raster formatted data derived from the Centre of Ecology and Hydrology's (CEH) Land Cover Map 2000 (LCM2000) data for the Monks Wood, Cambridgeshire, UK, NCAVEO calibration/validation (cal/val) test site. The NERC funded Network for Calibration and Validation of EO (NCAVEO) campaign was designed to illustrate and explain the processes involved in cal/val of earth observation data.\r\n",
    "keywords": "",
    "publicationState": "published",
    "dataPublishedTime": "2007-10-19T15:24:08",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/10872/?format=api",
        "dataPath": "/neodc/ncaveo_lcm2000/data/raster/lcmmonkswood/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 72569,
        "numberOfFiles": 9,
        "fileFormat": "&lt;div property=\"cedacat:formats\"&gt;\r\n&lt;div class=\"formats\"&gt;Data Availability&lt;/div&gt;\r\n&lt;p&gt;Datasets for NCAVEO's UK test sites available through NEODC include:&lt;/p&gt;\r\n&lt;ul class=\"style1\"&gt;\r\n&lt;li&gt;Centre for Ecology and Hydrology (CEH) Land Cover Map 2000 (LCM2000) Data, &lt;a href=\"http://neodc.nerc.ac.uk/browse/neodc/ncaveo_lcm2000/data/raster/\"&gt;25 m derived raster format&lt;/a&gt; \r\n&lt;/li&gt;&lt;li&gt;CEH LCM2000 Data, &lt;a href=\"http://neodc.nerc.ac.uk/browse/neodc/ncaveo_lcm2000/data/vector/\"&gt;Level 2 vector format&lt;/a&gt; &lt;/li&gt;&lt;/ul&gt;\r\n&lt;p class=\"style1\"&gt;If you have further relevant datasets to contribute to this project, please contact &lt;a href=\"mailto:neodc@rl.ac.uk\"&gt;NEODC&lt;/a&gt;.&lt;/p&gt;\r\n\r\n\r\n&lt;/div&gt;\r\n\r\n"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/3016/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/531/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "These data were provided to the NERC Earth Observation Data Centre (NEODC)by the NERC Centre for Ecology and Hydrology (CEH). They are a subset of the Land Cover Map 2000 dataset.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/7231/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/7827/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/10852/?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/39108/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39113/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39111/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39112/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39114/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39107/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39110/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/39109/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": "https://api.catalogue.ceda.ac.uk/api/v2/computations/10873/?format=api",
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2583/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "ncaveo_lcm2000",
            "label": "restricted: ncaveo_lcm2000 group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/ncaveo_lcm2000.pdf",
            "licenceClassifications": "academic, specific"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}