eBird

Website: https://ebird.org/ 

Prerequisites

Data Source

eBird API Key: Log in to your eBird account and generate an API key from the eBird Keygen page.

Area of Interest: You can define your area of interest in several ways:

  • Geographic location: Specify latitude and longitude coordinates.
  • eBird Hotspot: Use the unique identifier for a specific eBird Hotspot.
  • Region Code: Use the ISO two-letter country code for a broader region.
  • Species Code: Specify a specific bird species (may have limited accuracy).

Data Delivery

EarthRanger

To send data to EarthRanger, you will need:

  • A special EarthRanger user with permissions to post event data. 
  • A long-lived token for authentication assigned to the user created in the previous step.
  • Confirm that the required event type and schema are configured in EarthRanger. 
    • Required event type: ebird_observation

Please refer to EarthRanger's documentation or contact Support.

 
 

Smart Connect

To send data to SMART:

  • Ensure that the necessary categories and attributes are set up in your SMART CA data model before proceeding.
 
 

Configuration in Gundi

1. Click Create Connection.  
2. Select eBird.  
3. Enter your eBird API Key. Generate your key here.  
4. Set the number of days of data to retrieve.  
5. List eBird species codes to filter the query. If left blank, all species will be included.  

You can find the species code in the URL of the eBird species profile. Example:


6. Select the language for species information.  
7. Choose between:  

  • Fetching data around a specific location (provide latitude, longitude, and search distance in kilometers).  
  • Fetching data within a region (enter the Region Code from this list.

8. Choose whether to include unreviewed observations.  
9. Select your Organization.  
10. Enter a Connection Name (e.g., eBird - Project Name).  
11. Click Next.  
12. Select a Destination. Refer to our guides for details.

Characteristics

This section will be available shortly..

Data Delivery

The time it takes for data to appear in your destination system depends on several factors, such as latency introduced by the source, network conditions, and intermediary systems. While these factors may vary, Gundi typically checks for available data at scheduled intervals (approximately every 10 minutes).

If data is not available in your system after this interval, please check the source of the data for its availability. If the issue persists, contact our Support team for assistance.

Additional Resources

Notes for Support

We suggest consulting the eBird documentation for details on specific functionalities.

 

Internal Documentation: https://allenai.atlassian.net/wiki/spaces/ER/pages/30496456711/eBird 

 
 

Internal Documentation

This section will be available shortly..

 
 

Screenshots

This section will be available shortly..

Need documentation before it's ready?
Let us know at support@earthranger.com. We're happy to help.

 

Tags: Pull Integration, Events, Data Provider, Sightings