Skip to content

Main content

Biodiversity Taxon ID Namespace

Encode an exact supplied taxon identifier with its namespace without resolving taxonomy.

Loading tool…

Description

Encode an exact supplied taxon identifier with its namespace.

Biodiversity records distinguish surveyed sites, nondetection, counts, sampling units, voucher references and source-qualified taxonomic states. A coordinate-precision label changes metadata rather than protecting a location. Relative abundance and mean count per represented unit depend on their supplied denominators and survey scope.

Encode an exact supplied taxon identifier with its namespace.

When to use this tool

Use Biodiversity Taxon ID Namespace when you already have namespace, taxonId and need to encode an exact supplied taxon identifier with its namespace.

How to use the tool and how it works

  1. Enter namespace, taxonId. Use the units and conventions below.
  2. Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
  3. Read token. Use the output convention below.

Enter namespace, taxonId using the field constraints below. Encode these values, in exactly that order, as a JSON array and return the serialized array as text in token. String values are preserved without trimming or external terminology lookup.1

Input fieldMeaning and unitsAccepted input
namespaceNamespaceRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
taxonIdTaxon IdRequired. Text; minimum UTF-16 length 1; maximum UTF-16 length 8192.
Output fieldInterpretationReturned shape
tokenTokenRequired. Text; maximum UTF-16 length 8192.
json
{
  "input": {
    "namespace": "N17",
    "taxonId": "00124"
  },
  "output": {
    "token": "[\"N17\",\"00124\"]"
  }
}

Limitations and assumptions

  • The result records supplied values without resolving taxonomy. Sources and asserted relationships are not independently authenticated.
  • Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.

Alternative or Complementary methods

Review specimens, original observations, sampling design and controlled taxonomic sources. Use complete detection, population and spatial methods when a local count fraction, source label or precision bin cannot answer the ecological or disclosure question.

References

  1. Calculation and input contract: biodiversity/biodiversity-taxon-id-namespace — tool.io

Similar or alternative tools