# ner-tagger

**Service migré vers https://github.com/Inist-CNRS/web-services**

## geoTagger

Cette instance propose un outil de détéction d'entités nommées dans des textes anglais.
Attention : Ce web service est, de par sa conception, assez lent. Il est donc normal que le traitement d'une grosse masse de données prenne un peu plus de temps que les autres web services.

### utilisation

- [v1/geoTagger/geoTagger](#v1%2fgeoTagger)

Ce service permet de détecter des entités géographiques dans des textes anglais.
Ce web service prend en entrée du JSON avec deux champs: `id` et `value`, et renvoie un JSON
avec les entités géographiques détéctées dans le champ `value`.

### Exemple

```bash
$ cat <<EOF | curl -X POST --data-binary @- "https://ner-tagger.services.inist.fr/v1/geoTagger/geoTagger"
[{"id":"1","value":"The City of Paris is the centre and seat of government of the region and province of Île-de-France, or Paris Region, with an estimated population of 12,997,058 in 2020, or about 18 percent of the population of France, making it in 2020 the largest metropolitan area in Europe, and 14th largest in the world in 2015."},
 {"id":"2","value":"The COVID-19 pandemic, also known as the coronavirus pandemic, is an ongoing global pandemic of coronavirus disease 2019 (COVID-19) caused by severe acute respiratory syndrome coronavirus2 (SARS-CoV-2). It was first identified in December 2019 in Wuhan, China. The World Health Organization declared the outbreak a Public Health Emergency of International Concern on 20 January 2020, and later a pandemic on 11 March 2020. As of 2 April 2021, more than 129 million cases have been confirmed, with more than 2.82 million deaths attributed to COVID-19, making it one of the deadliest pandemics in history."}]
EOF
```

Sortie

```json
[
    {
        "id":"1",
        "value":"The City of Paris is the centre and seat of government of the region and province of Île-de-France, or Paris Region, with an estimated population of 12,997,058 in 2020, or about 18 percent of the population of France, making it in 2020 the largest metropolitan area in Europe, and 14th largest in the world in 2015."
    },
    {
        "id":"2",
        "value":"The COVID-19 pandemic, also known as the coronavirus pandemic, is an ongoing global pandemic of coronavirus disease 2019 (COVID-19) caused by severe acute respiratory syndrome coronavirus2 (SARS-CoV-2). It was first identified in December 2019 in Wuhan, China. The World Health Organization declared the outbreak a Public Health Emergency of International Concern on 20 January 2020, and later a pandemic on 11 March 2020. As of 2 April 2021, more than 129 million cases have been confirmed, with more than 2.82 million deaths attributed to COVID-19, making it one of the deadliest pandemics in history."
    }
]
EOF
```

## Persee Baip tagger

Cette instance propose un outil de détection d'organismes scolaires et de localisation dans des bulletins administratifs de l'instruction publique pour Persee.

### utilisation

- [v1/perseeBaipTagger/tagger](#v1%2fgeoTagger)

Ce service permet de détecter des organismes scolaires, des localisations, ainsi que des opérations (transformation, nomination, affectation, etc) dans les bulletins administratifs de l'instruction publique.
Ce web service prend en entrée du JSON avec deux champs: `id` et `value`, et renvoie un JSON
avec un dictionnaire contenant les organismes scolaires, localisations et opérations trouvées dans le champs `value`.

### Exemple

```bash
$ cat <<EOF | curl -X POST --data-binary @- "https://ner-tagger.services.inist.fr/v1/perseeBaipTagger/tagger"
[{"id":"1","value":"Personnel de l'Ecole normale primaire de Barcelonnette. Personnel du Collège impérial de France et du collège communal de Confolens. Personnel de la Faculté des lettres de Dijon."},
{"id":"2","value":"Ecole normale supérieure. — M. Boulangier, agrégé des sciences physiques, professeur de physique au lycée impérial de Bar-le-Duc, ancien élève de l'école normale supérieure, est nommé préparateur de .chimie à ladite école, en remplacement de M. Debray."}]
EOF
```

Sortie

```json
[{
    "id": "1",
    "value": {
        "loc": [
            "Barcelonnette",
            "France",
            "Confolens",
            "Dijon"
        ],
        "org": [
            "Ecole normale primaire de Barcelonnette",
            "Collège impérial de France",
            "collège communal de Confolens",
            "Faculté des lettres de Dijon"
        ],
        "basicOrg": [
            "collège",
            "collège",
            "faculté"
        ],
        "operation": []
    }
},
{
    "id": "2",
    "value": {
        "loc": [
            "Bar-le-Duc"
        ],
        "org": [
            "Ecole normale supérieure",
            "lycée impérial de Bar-le-Duc",
            "école normale supérieure",
            "école"
        ],
        "basicOrg": [
            "lycée",
            "école",
            "école"
        ],
        "operation": []
    }
}]
```
