A sampling or collecting event. Multiple dwc.occurrence records can reference the same event via eventRef, sharing location and protocol metadata.
tid
Timestamp-based ID
Properties
coordinateUncertaintyInMeters
integer
Optional
Uncertainty radius in meters around the coordinates.
minimum: 1country
string
Optional
The name of the country.
maxGraphemes: 128 graphemescountryCode
string
Optional
ISO 3166-1 alpha-2 country code.
maxLength: 2 bytesminLength: 2 bytescounty
string
Optional
Second-level administrative division.
maxGraphemes: 256 graphemescreatedAt
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 graphemesdecimalLongitude
string
Optional
Geographic longitude in decimal degrees (WGS84). Range: -180 to 180.
maxGraphemes: 32 graphemeseventDate
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 graphemeseventID
string
Required
An identifier for the event. Should be globally unique or unique within the dataset.
maxGraphemes: 256 graphemeseventRemarks
string
Optional
Comments or notes about the event.
maxGraphemes: 5000 graphemeseventTime
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 graphemesfieldNotes
string
Optional
Notes or a reference to notes taken in the field about the event.
maxGraphemes: 10000 graphemesgeodeticDatum
string
Optional
The spatial reference system. Recommended: 'EPSG:4326'.
maxGraphemes: 64 graphemeshabitat
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 graphemeslocality
string
Optional
Specific locality description.
maxGraphemes: 1024 graphemeslocationID
string
Optional
Identifier for the location where the event occurred.
maxGraphemes: 256 graphemeslocationRemarks
string
Optional
Comments about the location.
maxGraphemes: 2048 graphemesmaximumElevationInMeters
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 graphemesparentEventID
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 graphemesparentEventRef
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 graphemessampleSizeValue
string
Optional
A numeric value for a measurement of the size of a sample in the event (e.g., '20', '0.25').
maxGraphemes: 64 graphemessamplingEffort
string
Optional
The amount of effort expended during the event (e.g., '3 person-hours', '14 trap-nights', '2 km transect walked').
maxGraphemes: 256 graphemessamplingProtocol
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 graphemesstateProvince
string
Optional
First-level administrative division.
maxGraphemes: 256 graphemesView 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."
}