taxon_namespace
Updated: 28-6-2023Description
Remaps and filters the output to use a specific taxon namespace. Note that when using the token (authenticated) endpoint the taxon namespace can be set automatically. Alternatively, when using a token, this parameter is set automatically.
| Values | Description |
|---|---|
| WRN | Observation.org taxonomy |
| NBIC | Artsdatabanken taxonomy |
| APSE | Artdatabanken taxonomy |
| DK_ART | Arter.dk taxonomy |
| UK_iRecord | iRecord.uk taxonomy |
| FINBIF | FINBIF taxonomy |
Example use
Get test image
Requires curl and jq.
curl \
-X POST \
-F "image=@AO_1120028.jpg" \
-F "autozoom_enabled=1" \
-F "taxon_namespace=DK_ART" \
"https://multi-source.identify.biodiversityanalysis.eu/v2/observation/identify" | \
jqimport json
import requests
def example_request():
url = (
"https://multi-source.identify."
"biodiversityanalysis.eu/v2/"
"observation/identify"
)
image = "buteo2.jpg"
data = {
"taxon_namespace": "DK_ART",
}
with open(image, "rb") as image:
response = requests.post(
url=url,
files={"image": image},
data=data,
)
return response.json()
if __name__ == "__main__":
json_response = example_request()
print(json.dumps(json_response, indent=2))Requires the Python requests library. Available with pip install requests.
{
"api_implementation": {
"tag": "api-v2:2.1.0-20230616",
"version": "49476035"
},
"generated_by": {
"datetime": "2023-06-28T12:26:18.353619",
"parameters": {
"autozoom_enabled": "1",
"taxon_namespace": "DK_ART"
},
"tag": "algorithm=msm-eur:1.1-20230619,api=api-v2:2.1.0-20230616",
"version": "algorithm=df722733dc3eb9647870d237c918cecd0d8aabeb,api=49476035"
},
"identification": {
"image": {
"confidence": "uncertain"
}
},
"links": {
"taxa": {
"url": "v2/taxa/main_order"
},
"taxa_with_filter": {
"url": "v2/taxa/main_order?id={taxon_id}"
}
},
"media": [
{
"filename": "AO_1120028",
"id": "image0"
}
],
"model_implementation": {
"algorithm_tag": "msm-eur:1.1-20230619",
"tag": "main_order",
"version": "df722733dc3eb9647870d237c918cecd0d8aabeb"
},
"predictions": [
{
"region_group_id": "individual0",
"taxa": {
"items": [
{
"probability": 0.860428,
"scientific_name": "Saxicola rubicola",
"scientific_name_id": "DK_ART:a9092cf9-f785-ea11-aa77-501ac539d1ea",
"scientific_name_id_shared": "GBIF:4408759",
"scientific_name_shared": "Saxicola rubicola"
},
{
"probability": 0.139572,
"scientific_name": "Saxicola rubicola subsp. hibernans",
"scientific_name_id": "DK_ART:58cecafa-f785-ea11-aa77-501ac539d1ea",
"scientific_name_id_shared": "GBIF:7687128",
"scientific_name_shared": "Saxicola rubicola hibernans"
},
{
"probability": 0,
"scientific_name": "Saxicola rubicola subsp. rubicola",
"scientific_name_id": "DK_ART:59cecafa-f785-ea11-aa77-501ac539d1ea",
"scientific_name_id_shared": "GBIF:8248237",
"scientific_name_shared": "Saxicola rubicola rubicola"
},
{
"probability": 0,
"scientific_name": "Saxicola maurus subsp. maurus",
"scientific_name_id": "DK_ART:56cecafa-f785-ea11-aa77-501ac539d1ea",
"scientific_name_id_shared": "GBIF:7619236",
"scientific_name_shared": "Saxicola maurus maurus"
},
{
"probability": 0,
"scientific_name": "Anthus petrosus subsp. littoralis",
"scientific_name_id": "DK_ART:22cccafa-f785-ea11-aa77-501ac539d1ea",
"scientific_name_id_shared": "GBIF:6486586",
"scientific_name_shared": "Anthus petrosus littoralis"
},
{
"probability": 0,
"scientific_name": "Pelophylax",
"scientific_name_id": "DK_ART:1cbdf9f3-f785-ea11-aa77-501ac539d1ea",
"scientific_name_id_shared": "GBIF:2426629",
"scientific_name_shared": "Pelophylax"
},
{
"probability": 0,
"scientific_name": "Larus fuscus subsp. intermedius",
"scientific_name_id": "DK_ART:53cdcafa-f785-ea11-aa77-501ac539d1ea",
"scientific_name_id_shared": "GBIF:5846432",
"scientific_name_shared": "Larus fuscus intermedius"
},
{
"probability": 0,
"scientific_name": "Anthus pratensis",
"scientific_name_id": "DK_ART:d48511f4-f785-ea11-aa77-501ac539d1ea",
"scientific_name_id_shared": "GBIF:2490266",
"scientific_name_shared": "Anthus pratensis"
},
{
"probability": 0,
"scientific_name": "Trachemys scripta subsp. scripta",
"scientific_name_id": "DK_ART:8fcecafa-f785-ea11-aa77-501ac539d1ea",
"scientific_name_id_shared": "GBIF:7062200",
"scientific_name_shared": "Trachemys scripta scripta"
},
{
"probability": 0,
"scientific_name": "Saxicola rubetra",
"scientific_name_id": "DK_ART:a8092cf9-f785-ea11-aa77-501ac539d1ea",
"scientific_name_id_shared": "GBIF:2492521",
"scientific_name_shared": "Saxicola rubetra"
}
],
"type": "multiclass"
},
"taxa_unfiltered": {
"items": [
{
"probability": 0.860428,
"scientific_name": "Saxicola rubicola",
"scientific_name_id": "GBIF:4408759"
},
{
"probability": 0.139572,
"scientific_name": "Saxicola rubicola hibernans",
"scientific_name_id": "GBIF:7687128"
},
{
"probability": 0,
"scientific_name": "Saxicola rubicola rubicola",
"scientific_name_id": "GBIF:8248237"
},
{
"probability": 0,
"scientific_name": "Saxicola maurus maurus",
"scientific_name_id": "GBIF:7619236"
},
{
"probability": 0,
"scientific_name": "Anthus petrosus littoralis",
"scientific_name_id": "GBIF:6486586"
},
{
"probability": 0,
"scientific_name": "Pelophylax",
"scientific_name_id": "GBIF:2426629"
},
{
"probability": 0,
"scientific_name": "Larus fuscus intermedius",
"scientific_name_id": "GBIF:5846432"
},
{
"probability": 0,
"scientific_name": "Anthus pratensis",
"scientific_name_id": "GBIF:2490266"
},
{
"probability": 0,
"scientific_name": "Trachemys scripta scripta",
"scientific_name_id": "GBIF:7062200"
},
{
"probability": 0,
"scientific_name": "Pelophylax lessonae",
"scientific_name_id": "GBIF:2426654"
}
],
"type": "multiclass"
}
}
],
"region_groups": [
{
"id": "individual0",
"individual_id": "individual0",
"regions": [
{
"box": {
"x1": 0.166875,
"x2": 0.833125,
"y1": 0,
"y2": 1
},
"id": "image0?region=full",
"media_id": "image0"
},
{
"box": {
"x1": 0.389375,
"x2": 0.69875,
"y1": 0.23358348968105067,
"y2": 0.698874296435272
},
"id": "image0?region=globalzoom",
"media_id": "image0"
}
]
}
]
}