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/40064/?format=api
HTTP 200 OK
Allow: GET, HEAD, OPTIONS
Content-Type: application/json
Vary: Accept

{
    "ob_id": 40064,
    "uuid": "229d671fe5524580838cc452ee7bef18",
    "title": "AMOF: cloud camera 2 imagery from Chilbolton, Hampshire (2016-present)",
    "abstract": "This dataset contains photographs taken by an all-sky camera located on the roof of the Receive Cabin (51.145168°N, -1.439750°E) at the National Centre for Atmospheric Science (NCAS) Chilbolton Atmospheric Observatory (CAO) in southern England, UK. Photos are taken at 5 minute intervals on a continuous basis in order to record general atmospheric conditions.\r\n\r\nThe camera is an AXIS M3027-PVE network camera, which is alternatively known as an AXIS 0556-001. In the frame of reference of the photos, the angular field of view is 187° in the horizontal and 168° in the vertical, i.e. essentially covering a hemisphere. The centre of the field of view is nominally directed towards the zenith, although it is not known with what level of accuracy. The azimuthal alignment (measured in degrees from North), ϕ_AZIMUTH, of each part of the photo can be estimated from the relationship:\r\n\r\n               ϕ_AZIMUTH = 280 - ϕ_PHOTO\r\n\r\nwhere ϕ_PHOTO is the angle measured (in degrees) clockwise from the the 12 o'clock position in a polar coordinate system whose pole is at the centre of the photo. Note that ϕ_PHOTO decreases as ϕ_AZIMUTH increases. Details of how this relationship has been derived can be found in the publication available from https://doi.org/10.5281/zenodo.8096680 .\r\n\r\nThe camera synchronises its internal clock with Coordinated Universal Time (UTC). This clock is used to trigger the capture of photographs and to produce the time stamps used in the file names. For a reason that is not entirely clear, there is typically a 1 s delay between the time stamp shown in the overlay at the top of each photograph and the one used in the file name. Although the time stamp shown in the overlay is assumed to be the more appropriate one, it is not computer-readable without making use of image processing software. Consequently, the time stamp from the file name has been adopted as the official one and recorded in the embedded metadata.",
    "keywords": "CFARR, cloud camera",
    "publicationState": "preview",
    "dataPublishedTime": null,
    "doiPublishedTime": null,
    "updateFrequency": "continual",
    "status": "ongoing",
    "result_field": {
        "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/42897/?format=api",
        "dataPath": "/badc/ncas-cao/data/ncas-cam-9/20160510_longterm/v1.0/",
        "oldDataPath": [],
        "storageLocation": "internal",
        "storageStatus": "online",
        "volume": 4402937,
        "numberOfFiles": 3,
        "fileFormat": "Data are PNG formatted."
    },
    "timePeriod": "https://api.catalogue.ceda.ac.uk/api/v2/times/965/?format=api",
    "geographicExtent": "https://api.catalogue.ceda.ac.uk/api/v2/bboxes/59/?format=api",
    "nonGeographicFlag": false,
    "phenomena": [],
    "dataLineage": "Data are prepared by Chilbolton Facility for Atmospheric and Radio Research (CFARR) staff prior to submission to CEDA for archiving.",
    "removedDataTime": null,
    "removedDataReason": "",
    "language": "English",
    "identifier_set": [],
    "projects": [
        "https://api.catalogue.ceda.ac.uk/api/v2/projects/3464/?format=api"
    ],
    "observationcollection_set": [],
    "responsiblepartyinfo_set": [
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/195214/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/195212/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/195218/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/195211/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/195215/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/195216/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/195217/?format=api",
        "https://api.catalogue.ceda.ac.uk/api/v2/rpis/195220/?format=api"
    ],
    "procedureAcquisition": "https://api.catalogue.ceda.ac.uk/api/v2/acquisitions/20054/?format=api",
    "procedureCompositeProcess": null,
    "procedureComputation": null,
    "permissions": [
        {
            "ob_id": "https://api.catalogue.ceda.ac.uk/api/v2/observations/2522/?format=api",
            "useLimitation": null,
            "accessConstraints": null,
            "accessCategory": "registered",
            "accessRoles": null,
            "label": "registered: None group",
            "licenceURL": "http://www.nationalarchives.gov.uk/doc/open-government-licence/version/3/",
            "licenceClassifications": "any"
        }
    ],
    "discoveryKeywords": []
}