GBIF icon

GBIF

GBIF provides free and open access to biodiversity data

Actions22

  • Collection Actions
  • Dataset Actions
  • Dataset Search Actions
  • Installation Actions
  • Institution Actions
  • Occurrence Actions
  • Occurrence Count Actions
  • Occurrence Search Actions
  • Occurrence Search Catalog Number Actions
  • Occurrence Search Collection Code Actions
  • Occurrence Search Occurrence ID Actions
  • Occurrence Search Recorded By Actions
  • Occurrence Search Record Number Actions
  • Occurrence Search Institution Code Actions
  • Organization Actions
  • Name Parser Actions
  • Network Actions
  • Node Actions
  • Species Actions
  • Species Match Actions
  • Species Search Actions
  • Species Suggest Actions

Installation → Get

AI-generated

Overview

This node integrates with the GBIF (Global Biodiversity Information Facility) API to retrieve biodiversity data. Specifically, for the Installation resource with the Get operation, it fetches detailed information about a particular installation or its related sub-resources such as comments, contacts, datasets, endpoints, identifiers, tags, or machine tags.

Common scenarios where this node is beneficial include:

  • Retrieving metadata about biodiversity data installations.
  • Accessing related sub-resources of an installation for deeper insights.
  • Integrating GBIF installation data into workflows for biodiversity research, data aggregation, or reporting.

Practical example:

  • You want to get details about a specific installation by its ID.
  • You want to fetch all contact information associated with that installation.
  • You want to list datasets linked to a particular installation.

Properties

Name Meaning
ID The unique identifier of the installation to retrieve.
Sub-Resource Optional: Select a related sub-resource of the installation to fetch. Options are:
- (empty) (no sub-resource)
- Comment
- Contact
- Dataset
- Endpoint
- Identifier
- Tag
- Machine Tag

Output

The output is a JSON array containing the response from the GBIF API corresponding to the requested installation or its sub-resource. The structure depends on the selected sub-resource:

  • If no sub-resource is selected, the output contains the main installation object with its metadata.
  • If a sub-resource is selected, the output contains an array or object representing that sub-resource's data related to the installation.

No binary data is returned by this node.

Dependencies

  • This node requires internet access to call the public GBIF API at https://api.gbif.org/v1.
  • No authentication or API key is required as the GBIF API is publicly accessible.
  • The node uses standard HTTP GET requests with JSON responses.

Troubleshooting

  • Empty or invalid ID: If the ID property is empty or incorrect, the API will return an error or empty result. Ensure the correct installation ID is provided.
  • Invalid sub-resource selection: Selecting a sub-resource that does not exist for the given installation may result in an empty response or error.
  • Network issues: Connectivity problems can cause request failures. Verify network access to api.gbif.org.
  • API changes: If GBIF updates their API endpoints or response formats, the node might fail or return unexpected data. Check GBIF API documentation for updates.

Links and References

Discussion