Webservice multiwhere⚓
Objet⚓
Ce webservice renvoie, pour un PPN bibliographique--envoyé en paramètre de la requête--, les bibliothèques(RCR) qui sont localisées sur la notice.
Pour chaque bibliothèque disposant d'un exemplaire, le webservice fournit les informations de géolocalisation (latitude et longitude)
Remarque :
RCR[1] = chaque bibliothèque du réseau Sudoc possède un identifiant dans le Répertoire des Centres de Ressources. Précisons que le RCR est un identifiant national de bibliothèque, qui devient un identifiant international (ISIL) si vous le préfixez de “FR-”.
par exemple 341725201 est le n° RCR du Centre de documentation de l'ABES
PPN[2] = chaque notice RCR décrivant les informations (adresse, coordonnées, services) d'une bibliothèque est identifiée par un n° PPN dans le catalogue Sudoc.
par exemple 050947664 est le n°PPN de la notice RCR du centre de documentation de l'Abes dans le Sudoc
Nom du service⚓
<sudoc service="multiwhere">
Exemple : Structure de l'information dans la notice en xml⚓
Notice RCR du centre de documentation de l'ABES dont le PPN est 050947664 dans le Sudoc https://www.idref.fr/050947664.xml
Les informations de géolocalisation sont renseignées en zone : 202 $aLatitude $bLongitude
</datafield> <datafield tag="202" ind1=" " ind2=" "> <subfield code="a">43.6363048</subfield> <subfield code="b">3.8284966</subfield> </datafield> |
Structure d'une requête simple⚓
Structure d'une requête multiple⚓
Réponse en format XML⚓
Par défaut, le format de sortie est en xml
Exemple :
Exemple
https://www.sudoc.fr/services/multiwhere/144089661
<sudoc service="multiwhere">
<query>
<ppn>144089661</ppn>
<result>
<library>
<rcr>130012101</rcr>
<shortname>AIX-MARSEILLE1-BU Lettres</shortname>
<latitude>43.516025</latitude>
<longitude>5.448238</longitude>
</library>
<library>
<rcr>130012102</rcr>
<shortname>AIX-MARSEILLE3-BU Droit Sci.Eco.</shortname>
<latitude>43.519271</latitude>
<longitude>5.4467564</longitude>
</library>
<library>
<rcr>173002101</rcr>
<shortname>LA ROCHELLE-BU</shortname>
<latitude>46.1523269</latitude>
<longitude>-1.1531369</longitude>
</library>
<library>
<rcr>290192103</rcr>
<shortname>BREST-BU Droit-Sciences-Sports</shortname>
<latitude>48.40063989999999</latitude>
<longitude>-4.4999641</longitude>
</library>
<library>
[...]
</result>
</query>
</sudoc>
Réponse en format JSON⚓
Il est possible de demander une réponse dans le format JSON.
En appelant l'URL de base en précisant dans le Header de la requête HTTP préférer du JSON (Accept: text/json). Vous utiliserez alors le mécanisme de la négociation de contenu, que vous pouvez tester avec le plugin Firefox Modify Headers par exemple.
En complétant l'URL de base de l'information suivante &format=text/json
Exemple :
Exemple
https://www.sudoc.fr/services/multiwhere/144089661&format=text/json
{
"sudoc": {
"query": {
"result": {
"library": [
{
"longitude": "5.448238",
"shortname": "AIX-MARSEILLE1-BU Lettres",
"latitude": "43.516025",
"rcr": "130012101"
},
{
"longitude": "5.4467564",
"shortname": "AIX-MARSEILLE3-BU Droit Sci.Eco.",
"latitude": "43.519271",
"rcr": "130012102"
},
{
"longitude": "-1.1531369",
"shortname": "LA ROCHELLE-BU",
"latitude": "46.1523269",
"rcr": "173002101"
},