unnest: Unnest a query

In galah: Biodiversity Data from the GBIF Node Network

Unnest a query

Description

This syntax is borrowed from tidyr, and is conceptually used in the same way here, but in galah unnest amends the query to unnest information server-side, rather than on your machine. It powers all of the show_values() functions in galah.

Usage

unnest(.query)

Arguments

.query

An object of class metadata_request

Details

Re-implementing existing functions has the consequence of supporting consistent syntax with tidyverse, at the cost of potentially introducing conflicts. This can be avoided by using the :: operator where required.

Value

An object of class metadata_request

Examples

## Not run: 
# Return values of field `basisOfRecord`
request_metadata() |> 
  unnest() |> 
  filter(field == basisOfRecord) |> 
  collect()
  
# This is equivalent to:
galah_call() |>
  distinct(basisOfRecord) |>
  collect()

# and also to:
show_all(fields, "basisOfRecord") |> 
  show_values()
  
# Add information to a species list
request_metadata() |>
  filter(list == "dr650") |>
  select(everything()) |>
  unnest() |>
  collect()

# Find 'child' taxa
request_metadata() |>
  identify("Crinia")
  unnest() |>
  collect()

## End(Not run)

galah documentation built on Sept. 18, 2026, 9:08 a.m.