L'API REST dans le Géoportail
L'API REST du Géoportail permet à chaque enregistrement de métadonnées dans le catalogue du géoportail d'avoir une URL unique attribuée accessible par le Web. Le catalogue du géoportail peut également être interrogé via des URL utilisant la syntaxe REST. L'accès aux documents de métadonnées individuels via leurs URL REST, ou aux groupes de documents qui correspondent aux critères spécifiques via une URL de recherche mise en forme par REST, offre une fonctionnalité puissante pour la recherche, l'affichage et le partage des enregistrements. Par exemple, vous pouvez envoyer l'URL à un document de métadonnées ou une recherche à des collègues, et ils peuvent accéder à cette ressource sans devoir aller sur le géoportail et mener leur propre recherche. L'intégration des URL dans d’autres pages web, ou dans le système de gestion de contenu de votre organisation, offre aux utilisateurs des liens rapides vers les ressources sans qu'ils aient besoin d’effectuer leur propre recherche. En outre, l'API REST permet une intégration facile aux applications externes, comme décrit ci-dessous.
Pour voir l'URL REST d'un enregistrement de métadonnées individuel, cliquez sur le lien Details (Détails) de l'enregistrement dans les résultats de la recherche et faites défiler l’écran vers le bas de la page Details (Détails). L'URL sera mise en forme de manière identique à ce qui suit, avec un GUID unique :/geoportal/rest/document?f=html&id=%7B<GUID>%7D
Pour voir les résultats mis en forme par REST pour une recherche spécifique, faites défiler l’écran jusqu'en bas de la page de résultats de recherche du géoportail après avoir effectué une recherche pour voir les liens pour la recherche aux formats GEORSS, ATOM, HTML, FRAGMENT, KML, et JSON REST. Chaque format REST est décrit dans la table ci-dessous, avec un exemple de la manière dont ce format peut être utilisé dans une application externe.
Format REST | Description | Application externe |
---|---|---|
GEORSS | Affiche les résultats en format GEORSS, ce qui permet également aux utilisateurs de s'abonner à un flux RSS pour les enregistrements correspondant aux critères de recherche | Lecteurs RSS tels que Microsoft Outlook, Microsoft Internet Explorer, et Mozilla Firefox |
ATOM | L'affichage génère un format ATOM, une autre norme pour récupérer les flux de syndication qui permet également aux utilisateurs de s'abonner aux mises à jour | Lecteurs RSS tels que Microsoft Outlook, Microsoft Internet Explorer, et Mozilla Firefox |
HTML | Met en forme les résultats sous forme de document HTML complet | Systèmes de gestion de contenu et Wikis tels que Microsoft SharePoint, Joomla!, et Apache JSPWiki |
FRAGMENT | Formate les résultats sous forme de Fragment HTML sans les balises <html>, <head>, <title>, ou <body> | Systèmes de gestion de contenu et Wikis tels que Microsoft SharePoint, Joomla!, et Apache JSPWiki |
KML | Met en forme les résultats sous forme de KML, permettant d'afficher les résultats de recherche dans les applications de cartographie Web | Applications de cartographies telles que Google Maps et Google Earth |
JSON | Jolis résultats d’impression au format JSON | Applications personnalisées |
L'API REST vous permet également de rechercher sur le géoportail directement à partir d’un navigateur web avec la fonctionnalité OpenSearch. Les possibilités d’intégration de votre catalogue de géoportail dans d'autres applications sont sans limite, ce qui offre à votre catalogue de métadonnées plus d'importance et d'exposition.
Vous avez un commentaire à formuler concernant cette rubrique ?