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

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

{
    "ob_id": 27057,
    "uuid": "8889dfe3de45406e815bce13ae8a0c92",
    "title": "ESA Greenland Ice Sheet Climate Change Initiative (Greenland_Ice_Sheet_cci): Greenland Calving Front Locations, v3.0",
    "abstract": "The data set provides calving front locations of 28 major outlet glaciers of the Greenland Ice Sheet, produced as part of the ESA Greenland Ice Sheet Climate Change Initiative (CCI) project. \r\n\r\nThe Calving Front Location (CFL) of outlet glaciers from ice sheets is a basic parameter for ice dynamic modelling, for computing the mass fluxes at the calving gate, and for mapping glacier area change.  \r\n\r\nThe calving front location has been derived by manual delineation using SAR (Synthetic Aperture Radar) data from the  ERS-1/2, Envisat and Sentinel-1 satellites  and  satellite imagery from LANDSAT 5,7,8.    The digitized calving fronts are stored in ESRI vector shape-file format and include metadata information on the sensor and processing steps in the corresponding attribute table.\r\n\r\nThe product was generated by ENVEO (Environmental Earth Observation Information Technology GmbH)",
    "keywords": "Greenland, Ice sheet, CCI, ESA",
    "publicationState": "published",
    "dataPublishedTime": "2019-05-21T13:48:24",
    "doiPublishedTime": null,
    "updateFrequency": "notPlanned",
    "status": "completed",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/27062/?format=api",
        "dataPath": "/neodc/esacci/ice_sheets_greenland/data/greenland_calving_front_locations/v3.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 211204121,
        "numberOfFiles": 4369,
        "fileFormat": "Dara are ESRI vector shape-file format and include metadata information on the sensor and processing steps in the corresponding attribute table"
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/7282/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/1650/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data were produced by ENVEO (Environmental Earth Observation Information Technology GmbH) as part of the ESA CCI Greenland Ice Sheet project and were supplied to CEDA in the context 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/14317/?format=api"
    ],
    "observationcollection_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/observationcollections/14316/?format=api"
    ],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113386/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113381/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113382/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113383/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113384/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113385/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113387/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113380/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/113410/?format=api"
    ],
    "procedureAcquisition": null,
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2553/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "public",
            "accessRoles": null,
            "label": "public: None group",
            "licenceURL": "https://artefacts.ceda.ac.uk/licences/specific_licences/esacci_icesheets_greenland_terms_and_conditions.pdf",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": [
        {
            "ob_id": 1138,
            "name": "NDGO0003"
        },
        {
            "ob_id": 1140,
            "name": "ESACCI"
        }
    ]
}