# bio.cuanto.survey

> Published by [cuanto.bio](https://lexicon.garden/identity/did:plc:dd7efi6wormdpmcyscnkjc6n)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:dd7efi6wormdpmcyscnkjc6n/bio.cuanto.survey)
- [Documentation](https://lexicon.garden/lexicon/did:plc:dd7efi6wormdpmcyscnkjc6n/bio.cuanto.survey/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:dd7efi6wormdpmcyscnkjc6n/bio.cuanto.survey/examples)

## Definitions

### `bio.cuanto.survey`

**Type**: `record`

An event where participants collect data required by a Survey Protocol.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `track` | `ref` → `#track` | No | A spatial path recorded during the survey. |
| `location` | `ref` → `org.atgeo.place` | Yes | Geographic location where the survey was conducted. |
| `protocol` | `ref` → `com.atproto.repo.strongRef` | Yes | Protocol followed when conducting this survey. |
| `createdAt` | `string` (datetime) | Yes | Client-declared timestamp when this survey was originally created. |
| `eventDate` | `string` | No | Date or datetime the survey began, ISO 8601 supporting partial forms (e.g. 2026, 2026-02, 2026-02-03, 2026-02-03T00:01:02Z). |
| `surveyorCount` | `integer` | No | Total number of people conducting the Survey. |
| `eventDurationUnit` | `string` | No | Unit of eventDurationValue (sensu Humboldt eco:eventDurationUnit). Known values: 'minutes', 'hours', 'days'. |
| `eventDurationValue` | `integer` | No | Duration of the survey in units specified by eventDurationUnit (sensu Humboldt eco:eventDurationValue). |
| `samplingPerformedBy` | `array` | No | DIDs of participants in addition to the record owner (sensu Humboldt eco:samplingPerformedBy). |

### `bio.cuanto.survey#track`

**Type**: `object`

A spatial path recorded during a survey.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `gpx` | `blob` | Yes | GPX 1.1 file recording the survey path. |
| `source` | `string` | Yes | Origin of the GPX file. |

## Raw Schema

```json
{
  "id": "bio.cuanto.survey",
  "defs": {
    "main": {
      "key": "tid",
      "type": "record",
      "record": {
        "type": "object",
        "required": [
          "protocol",
          "createdAt",
          "location"
        ],
        "properties": {
          "track": {
            "ref": "#track",
            "type": "ref",
            "description": "A spatial path recorded during the survey."
          },
          "location": {
            "ref": "org.atgeo.place",
            "type": "ref",
            "description": "Geographic location where the survey was conducted."
          },
          "protocol": {
            "ref": "com.atproto.repo.strongRef",
            "type": "ref",
            "description": "Protocol followed when conducting this survey."
          },
          "createdAt": {
            "type": "string",
            "format": "datetime",
            "description": "Client-declared timestamp when this survey was originally created."
          },
          "eventDate": {
            "type": "string",
            "description": "Date or datetime the survey began, ISO 8601 supporting partial forms (e.g. 2026, 2026-02, 2026-02-03, 2026-02-03T00:01:02Z)."
          },
          "surveyorCount": {
            "type": "integer",
            "description": "Total number of people conducting the Survey."
          },
          "eventDurationUnit": {
            "type": "string",
            "description": "Unit of eventDurationValue (sensu Humboldt eco:eventDurationUnit). Known values: 'minutes', 'hours', 'days'."
          },
          "eventDurationValue": {
            "type": "integer",
            "description": "Duration of the survey in units specified by eventDurationUnit (sensu Humboldt eco:eventDurationValue)."
          },
          "samplingPerformedBy": {
            "type": "array",
            "items": {
              "type": "string",
              "format": "did"
            },
            "description": "DIDs of participants in addition to the record owner (sensu Humboldt eco:samplingPerformedBy)."
          }
        }
      },
      "description": "An event where participants collect data required by a Survey Protocol."
    },
    "track": {
      "type": "object",
      "required": [
        "gpx",
        "source"
      ],
      "properties": {
        "gpx": {
          "type": "blob",
          "accept": [
            "application/gpx+xml"
          ],
          "maxSize": 10000000,
          "description": "GPX 1.1 file recording the survey path."
        },
        "source": {
          "type": "string",
          "description": "Origin of the GPX file.",
          "knownValues": [
            "device",
            "uploaded"
          ]
        }
      },
      "description": "A spatial path recorded during a survey."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```