iNaturalist

Description

Integrations between iNaturalist and Gundi supported destinations allow users to receive the observations in iNaturalist as events. 

Scope

  • Data type: 
    • Events ✅
    • Images ✅
    • Movement data ❌ (not applicable)
  • Supported destinations:  EarthRanger 

Prerequisites

User

  • Information required to filter data
    • [Required] iNaturalist taxa IDs or iNaturalist project IDs.
    • [Optional] Annotations.
    • [Optional] Bounding box.
    • [Optional] Quality Grade.

Note: The project ID can be found on iNaturalist by going to the desired project and copying the ID found in the site URL. 

Example: arthropod-faces

 
 

EarthRanger

Create an event type for iNaturalist observations. Let EarthRanger define the schema automatically. 

 
 

Configurations

1. Gundi

1.1 Log in to Gundi's previous Portal

  1. Navigate to Gundi.

1.2 Verify Organization

  1. Confirm that an Organization exists for this connection, or create one.

1.3 Create a new Connection [Guide]

  1. Select iNaturalist from the list of available technologies.
  2. Specify values for the required and optional fields.

    Either the Taxa ID or the Project ID must be specified. 
    Taxa ID: List of iNaturalist taxa IDs for which to load observations. You can always find that number by going to the taxon’s page and looking at the URL (e.g. https://www.inaturalist.org/taxa/85553-Serpentes for Serpentes) or searching for it on Explore and looking at the URL.
    Project ID: List of project IDs to pull from iNaturalist.

    Optional Fields.
    Annotations: Map of annotation terms and the values which to include.  For example, 
    {"1": ["2"], "22": ["24", "25"]}
     would only include observations of Adults that had the Evidence of Presence annotation set to Organism or Scat.  Entries in the Dict are treated as ORs, whereas values in the Lists are treated as ANDs. 

    Annotation groups

    1=Life Stage
    9=Sex
    12=Plant Phenology
    17=Alive or Dead
    22=Evidence of Presence

     
     

    Values

    Life Stage (1)

    2=Adult
    3=Teneral
    4=Pupa
    5=Nymph
    6=Larva
    7=Egg
    8=Juvenile
    16=SubimagoBody

     
     

    Sex (9)

    10=Female
    11=Male

     
     

    Plant Phenology (12)

    13=Flowering
    14=Fruiting
    15=Flower Budding
    21=No Evidence of Flowering

     
     

    Alive or Dead (17)

    18=Alive, 19=Dead, 20=Cannot Be Determined

     
     

    Evidence of Presence (22)

    23=Feather
    24=Organism
    25=Scat
    26=Track
    27=Bone
    28=Molt
    29=Gall
    30=Egg
    31= Hair
    32=Leafmine
    35=Construction

     
     
     
     

    Bounding box: Bounding box for search area.  Of the format [ne_latitude, ne_longitude, sw_latitude, sw_longitude]
    Default number of days to load: The number of days of data to load from iNaturalist in the connection's first run.  
    Quality Grade: If present, only observations that have one of the entered quality grades will be included.  As of November, 2024, valid iNaturalist values are casual, needs_id and/or research.
    Include Photos: Whether or not to include the photos from iNaturalist observations.  Default: True.

    Event Type: The event type ID to use in EarthRanger.
    Event Prefix: A string to prefix to the observed species to set a title when creating the event.  Default: ‘iNat: ’

    Important: These filters will be applied on top of any filters already applied on the iNaturalist project. 
     

Future Plans

The Gundi team is planning on replacing the use of Annotation IDs with user friendly options. 

 

 

 

 

 

 

Was this article helpful?