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

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

{
    "ob_id": 8239,
    "uuid": "1999cc89208158c8616845f01ac93100",
    "title": "Modern UK Aerial Photography",
    "abstract": "Aerial photography obtained from The Geoinformation Group's (TGG) Cities Revealed project, acquired by the Landmap project, is available for over 65% of the UK's population, from 1969 to 2010. The imagery has a high resolution of 5-25cm. The Joint Information Systems Committee (JISC) funded Landmap service which ran from 2001 to July 2014 collected and hosted a large amount of earth observation data for the majority of the UK. After removal of JISC funding in 2013, the Landmap service is no longer operational, with the data now held at the NEODC.\r\n\r\nWhen using these data please also add the following copyright statement: Cities Revealed © The GeoInformation Group yyyy",
    "keywords": "",
    "publicationState": "published",
    "dataPublishedTime": "2007-08-01T14:32:32",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/8240/?format=api",
        "dataPath": "/neodc/landmap/data/optical/m_ap",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 1465985735433,
        "numberOfFiles": 32094,
        "fileFormat": "&lt;div property=\"cedacat:formats\"&gt;\r\nData are available in ecw (Enhanced Compression Wavelet) and MrSID (Multiresolution Seamless Image Database) formats which can both be opened with most image viewing/editing or GIS software such as such as &lt;a href=\"http://www.hexagongeospatial.com/products/remote-sensing/erdas-er-viewer\"&gt;Erdas ER viewer&lt;/a&gt;. Both formats are ultimately compressed images however the MrSID (Multiresolution Seamless Image Database) format (.sid extension) allows large compressed raster image files (such as aerial photographs or satellite imagery) to be quickly viewed without having to decompress the entire file. The data are archived in the directory structure of country/region_year/format/data for ease of use. Metadata containing location and other information (.ers, .sdw and .xml files) are included with their respective data files. \r\n&lt;/div&gt;\r\n\r\n"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/2359/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/186/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data collected and prepared by the Landmap team before a copy of the data were obtained by NEODC directly from Landmap.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/identifiers/5304/?format=api"
    ],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/8044/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/8212/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33193/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33194/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33195/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33196/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/41356/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/33192/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/41358/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/41357/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2588/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "restricted",
            "accessRoles": "landmap",
            "label": "restricted: landmap group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/landmap.pdf",
            "licenceClassifications": "academic, specific"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        }
    ]
}