search

sao-albacete / aoa

Anuario Ornitológico de Albacete Online
GNU General Public License v2.0
2 stars 2 forks source link

Obtener datos de eBird y mapearlos con los del anuario #131

Open viktorKhan opened 3 years ago

viktorKhan commented 3 years ago

La aplicación móvil eBird, usada mundialmente por observadores de aves expone una API REST que puede ser consultada.

Enlace a la documentación de la API -> https://documenter.getpostman.com/view/664302/S1ENwy59?version=latest

viktorKhan commented 3 years ago

He realizado una llamada a este endpoint https://documenter.getpostman.com/view/664302/S1ENwy59?version=latest#952a4310-536d-4ad1-8f3e-77cfb624d1bc para obtener la taxonomía que usa eBird y este es un ejemplo:

        "comName": "Long-eared Owl",
        "speciesCode": "loeowl",
        "category": "species",
        "taxonOrder": 8725.0,
        "bandingCodes": [
            "LEOW"
        ],
        "comNameCodes": [],
        "sciNameCodes": [
            "ASOT"
        ],
        "order": "Strigiformes",
        "familyComName": "Owls",
        "familySciName": "Strigidae"

Adjunto el fichero completo:

ebird-taxonomy.txt

@Terekab puedes mirar si podemos mapear este tipo de taxonomía con la que usamos en el anuario?

viktorKhan commented 3 years ago

Estos son los términos y condiciones de uso -> https://www.birds.cornell.edu/home/ebird-data-access-terms-of-use/

we make these data freely available for non-commercial use

viktorKhan commented 3 years ago

Los códigos para regiones son:

Country -> ES (Spain)
subnational1 -> ES-CM (Castilla - La Mancha)
subnational2 -> ES-CM-AB (Albacete)
viktorKhan commented 3 years ago

Este es un ejemplo de observación obtenida a través de la llamada https://documenter.getpostman.com/view/664302/S1ENwy59?version=latest#3d2a17c1-2129-475c-b4c8-7d362d6000cd

{
        "speciesCode": "eurser1",
        "comName": "European Serin",
        "sciName": "Serinus serinus",
        "locId": "L12848071",
        "locName": "Camino de los Paredazos a la Lobera, Albacete ES-Castilla-La Mancha 38.95948, -2.05428",
        "obsDt": "2020-12-01 13:03",
        "howMany": 16,
        "lat": 38.959483,
        "lng": -2.054281,
        "obsValid": true,
        "obsReviewed": false,
        "locationPrivate": true,
        "subId": "S76931794"
    }

El campo "subId": "S76931794" parece ser el código de la checklist.

viktorKhan commented 3 years ago

Con esta llamada https://documenter.getpostman.com/view/664302/S1ENwy59?version=latest#2ee89672-4211-4fc1-8493-5df884fbb386 se puede obtener la información de una checklist completa, y en ella se incluye el nombre del usuario entre otros datos

{
    "projId": "EBIRD",
    "subId": "S33881348",
    "protocolId": "P22",
    "locId": "L4745690",
    "durationHrs": 3.0,
    "allObsReported": true,
    "creationDt": "2017-01-23 05:03",
    "lastEditedDt": "2017-03-16 11:09",
    "obsDt": "2017-01-22 13:30",
    "obsTimeValid": true,
    "checklistId": "CL27693",
    "numObservers": 1,
    "effortDistanceKm": 5.0,
    "effortDistanceEnteredUnit": "km",
    "subnational1Code": "ES-AR",
    "submissionMethodCode": "EBIRD_android",
    "submissionMethodVersion": "1.5",
    "userDisplayName": "Víctor Cañizares Mata",
    "submissionMethodVersionDisp": "1.5",
    "obs": [
        {
            "speciesCode": "lammer1",
            "hideFlags": [],
            "obsDt": "2017-01-22 13:30",
            "subnational1Code": "ES-AR",
            "howManyAtleast": 1,
            "howManyAtmost": 1,
            "howManyStr": "1",
            "subId": "S33881348",
            "projId": "EBIRD",
            "obsId": "OBS459738404",
            "present": false,
            "obsAux": [
                {
                    "subId": "S33881348",
                    "obsId": "OBS459738404",
                    "speciesCode": "lammer1",
                    "fieldName": "breeding_code",
                    "entryMethodCode": "ebird_breeding",
                    "auxCode": "FO",
                    "value": "C1"
                }
            ]
        },
        {
            "speciesCode": "eurgri1",
            "hideFlags": [],
            "obsDt": "2017-01-22 13:30",
            "subnational1Code": "ES-AR",
            "howManyAtleast": 10,
            "howManyAtmost": 10,
            "howManyStr": "10",
            "subId": "S33881348",
            "projId": "EBIRD",
            "obsId": "OBS459738403",
            "present": false,
            "obsAux": [
                {
                    "subId": "S33881348",
                    "obsId": "OBS459738403",
                    "speciesCode": "eurgri1",
                    "fieldName": "breeding_code",
                    "entryMethodCode": "ebird_breeding",
                    "auxCode": "FO",
                    "value": "C1"
                }
            ]
        },
        {
            "speciesCode": "goleag",
            "hideFlags": [],
            "obsDt": "2017-01-22 13:30",
            "subnational1Code": "ES-AR",
            "howManyAtleast": 1,
            "howManyAtmost": 1,
            "howManyStr": "1",
            "subId": "S33881348",
            "projId": "EBIRD",
            "obsId": "OBS459738401",
            "present": false,
            "obsAux": [
                {
                    "subId": "S33881348",
                    "obsId": "OBS459738401",
                    "speciesCode": "goleag",
                    "fieldName": "breeding_code",
                    "entryMethodCode": "ebird_breeding",
                    "auxCode": "FO",
                    "value": "C1"
                }
            ]
        },
        {
            "speciesCode": "rebcho1",
            "hideFlags": [],
            "obsDt": "2017-01-22 13:30",
            "subnational1Code": "ES-AR",
            "howManyAtleast": 1,
            "howManyAtmost": 1,
            "howManyStr": "1",
            "subId": "S33881348",
            "projId": "EBIRD",
            "obsId": "OBS459738400",
            "present": false
        },
        {
            "speciesCode": "yebcho1",
            "hideFlags": [],
            "obsDt": "2017-01-22 13:30",
            "subnational1Code": "ES-AR",
            "howManyAtleast": 5,
            "howManyAtmost": 5,
            "howManyStr": "5",
            "subId": "S33881348",
            "projId": "EBIRD",
            "obsId": "OBS459738405",
            "present": false
        },
        {
            "speciesCode": "watpip1",
            "hideFlags": [],
            "obsDt": "2017-01-22 13:30",
            "subnational1Code": "ES-AR",
            "howManyAtleast": 1,
            "howManyAtmost": 1,
            "howManyStr": "1",
            "subId": "S33881348",
            "projId": "EBIRD",
            "obsId": "OBS459738402",
            "present": false
        }
    ]
}
viktorKhan commented 3 years ago

Esto se ajusta a lo que andamos buscando https://ebird.org/about/portals

Terekab commented 3 years ago

Me pongo en contacto con los coordinadores nacionales de eBird España para hablar sobre ello.