Species Identification

When a Bird camera identifies what it saw, the event carries EventModel.species: a tree of Species values, each with an id, a name, a probability, an optional type string, and children for finer identifications. Compare type against SpeciesRoleType (Parent / Child). Use displayName for a label — it replaces the underscores in the raw name — and pass Species.id as the speciesId below.

To show more than the name — an article, a description, reference images, the bird’s call — expand a node with the species details call below. SpeciesDetails carries articleLink, extract, images and call.

The same tree appears on wildlife events from Trail cameras, and the same call expands them.

Pre-requisite: The user has to be signed in to perform the following operations.

Get the species details

To get the species, The following method can be used:

• spaceId (required): The space ID of the device.
• speciesId (required): The species ID.

Factory.spaceService.getSpeciesDetails(spaceId: String, speciesId: String) -> IVPublisher<SpeciesDetails>