app.gainforest.dwc.event

gainforest.earth

Documentation

A sampling or collecting event. Multiple dwc.occurrence records can reference the same event via eventRef, sharing location and protocol metadata.

main record

A sampling or collecting event. Multiple dwc.occurrence records can reference the same event via eventRef, sharing location and protocol metadata.

Record Key tid Timestamp-based ID

Properties

coordinateUncertaintyInMeters integer Optional

Uncertainty radius in meters around the coordinates.

minimum: 1
country string Optional

The name of the country.

maxGraphemes: 128 graphemes
countryCode string Optional

ISO 3166-1 alpha-2 country code.

maxLength: 2 bytesminLength: 2 bytes
county string Optional

Second-level administrative division.

maxGraphemes: 256 graphemes
createdAt string datetime Required

Timestamp of record creation in the ATProto PDS.

decimalLatitude string Optional

Geographic latitude in decimal degrees (WGS84). Range: -90 to 90.

maxGraphemes: 32 graphemes
decimalLongitude string Optional

Geographic longitude in decimal degrees (WGS84). Range: -180 to 180.

maxGraphemes: 32 graphemes
eventDate string Required

The date or date range during which the event occurred. ISO 8601 format (e.g., '2024-03-15', '2024-03-15/2024-03-17').

maxGraphemes: 64 graphemes
eventID string Required

An identifier for the event. Should be globally unique or unique within the dataset.

maxGraphemes: 256 graphemes
eventRemarks string Optional

Comments or notes about the event.

maxGraphemes: 5000 graphemes
eventTime string Optional

The time or time range during which the event occurred. ISO 8601 format (e.g., '06:30:00', '06:30:00/09:00:00').

maxGraphemes: 64 graphemes
fieldNotes string Optional

Notes or a reference to notes taken in the field about the event.

maxGraphemes: 10000 graphemes
geodeticDatum string Optional

The spatial reference system. Recommended: 'EPSG:4326'.

maxGraphemes: 64 graphemes
habitat string Optional

A category or description of the habitat in which the event occurred (e.g., 'primary tropical rainforest', 'degraded pasture', 'riparian zone').

maxGraphemes: 512 graphemes
locality string Optional

Specific locality description.

maxGraphemes: 1024 graphemes
locationID string Optional

Identifier for the location where the event occurred.

maxGraphemes: 256 graphemes
locationRemarks string Optional

Comments about the location.

maxGraphemes: 2048 graphemes
maximumElevationInMeters integer Optional

Upper limit of elevation range in meters above sea level.

minimumElevationInMeters integer Optional

Lower limit of elevation range in meters above sea level.

municipality string Optional

Third-level administrative division.

maxGraphemes: 256 graphemes
parentEventID string Optional

An identifier for the broader event that this event is part of (e.g., a survey campaign that contains multiple transects).

maxGraphemes: 256 graphemes
parentEventRef string at-uri Optional

AT-URI reference to the parent app.gainforest.dwc.event record.

sampleSizeUnit string Optional

The unit of measurement for the sampleSizeValue (e.g., 'square meters', 'hectares', 'trap-nights').

maxGraphemes: 128 graphemes
sampleSizeValue string Optional

A numeric value for a measurement of the size of a sample in the event (e.g., '20', '0.25').

maxGraphemes: 64 graphemes
samplingEffort string Optional

The amount of effort expended during the event (e.g., '3 person-hours', '14 trap-nights', '2 km transect walked').

maxGraphemes: 256 graphemes
samplingProtocol string Optional

The names of, references to, or descriptions of the methods used during the event (e.g., 'camera trap array', 'line transect distance sampling', 'audio point count 10-min').

maxGraphemes: 1024 graphemes
stateProvince string Optional

First-level administrative division.

maxGraphemes: 256 graphemes
View raw schema
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "eventID",
      "eventDate",
      "createdAt"
    ],
    "properties": {
      "county": {
        "type": "string",
        "description": "Second-level administrative division.",
        "maxGraphemes": 256
      },
      "country": {
        "type": "string",
        "description": "The name of the country.",
        "maxGraphemes": 128
      },
      "eventID": {
        "type": "string",
        "description": "An identifier for the event. Should be globally unique or unique within the dataset.",
        "maxGraphemes": 256
      },
      "habitat": {
        "type": "string",
        "description": "A category or description of the habitat in which the event occurred (e.g., 'primary tropical rainforest', 'degraded pasture', 'riparian zone').",
        "maxGraphemes": 512
      },
      "locality": {
        "type": "string",
        "description": "Specific locality description.",
        "maxGraphemes": 1024
      },
      "createdAt": {
        "type": "string",
        "format": "datetime",
        "description": "Timestamp of record creation in the ATProto PDS."
      },
      "eventDate": {
        "type": "string",
        "description": "The date or date range during which the event occurred. ISO 8601 format (e.g., '2024-03-15', '2024-03-15/2024-03-17').",
        "maxGraphemes": 64
      },
      "eventTime": {
        "type": "string",
        "description": "The time or time range during which the event occurred. ISO 8601 format (e.g., '06:30:00', '06:30:00/09:00:00').",
        "maxGraphemes": 64
      },
      "fieldNotes": {
        "type": "string",
        "description": "Notes or a reference to notes taken in the field about the event.",
        "maxGraphemes": 10000
      },
      "locationID": {
        "type": "string",
        "description": "Identifier for the location where the event occurred.",
        "maxGraphemes": 256
      },
      "countryCode": {
        "type": "string",
        "maxLength": 2,
        "minLength": 2,
        "description": "ISO 3166-1 alpha-2 country code."
      },
      "eventRemarks": {
        "type": "string",
        "description": "Comments or notes about the event.",
        "maxGraphemes": 5000
      },
      "municipality": {
        "type": "string",
        "description": "Third-level administrative division.",
        "maxGraphemes": 256
      },
      "geodeticDatum": {
        "type": "string",
        "description": "The spatial reference system. Recommended: 'EPSG:4326'.",
        "maxGraphemes": 64
      },
      "parentEventID": {
        "type": "string",
        "description": "An identifier for the broader event that this event is part of (e.g., a survey campaign that contains multiple transects).",
        "maxGraphemes": 256
      },
      "stateProvince": {
        "type": "string",
        "description": "First-level administrative division.",
        "maxGraphemes": 256
      },
      "parentEventRef": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI reference to the parent app.gainforest.dwc.event record."
      },
      "sampleSizeUnit": {
        "type": "string",
        "description": "The unit of measurement for the sampleSizeValue (e.g., 'square meters', 'hectares', 'trap-nights').",
        "maxGraphemes": 128
      },
      "samplingEffort": {
        "type": "string",
        "description": "The amount of effort expended during the event (e.g., '3 person-hours', '14 trap-nights', '2 km transect walked').",
        "maxGraphemes": 256
      },
      "decimalLatitude": {
        "type": "string",
        "description": "Geographic latitude in decimal degrees (WGS84). Range: -90 to 90.",
        "maxGraphemes": 32
      },
      "locationRemarks": {
        "type": "string",
        "description": "Comments about the location.",
        "maxGraphemes": 2048
      },
      "sampleSizeValue": {
        "type": "string",
        "description": "A numeric value for a measurement of the size of a sample in the event (e.g., '20', '0.25').",
        "maxGraphemes": 64
      },
      "decimalLongitude": {
        "type": "string",
        "description": "Geographic longitude in decimal degrees (WGS84). Range: -180 to 180.",
        "maxGraphemes": 32
      },
      "samplingProtocol": {
        "type": "string",
        "description": "The names of, references to, or descriptions of the methods used during the event (e.g., 'camera trap array', 'line transect distance sampling', 'audio point count 10-min').",
        "maxGraphemes": 1024
      },
      "maximumElevationInMeters": {
        "type": "integer",
        "description": "Upper limit of elevation range in meters above sea level."
      },
      "minimumElevationInMeters": {
        "type": "integer",
        "description": "Lower limit of elevation range in meters above sea level."
      },
      "coordinateUncertaintyInMeters": {
        "type": "integer",
        "minimum": 1,
        "description": "Uncertainty radius in meters around the coordinates."
      }
    }
  },
  "description": "A sampling or collecting event. Multiple dwc.occurrence records can reference the same event via eventRef, sharing location and protocol metadata."
}

Lexicon Garden

@