Valoriser les données dans n'importe quelle interface logicielle grâce à l'API
La plateforme Isogeo repose sur la puissance de son API qui permet de développer des applicatifs adaptés à tous les besoins, en utilisant les métadonnées comme une couche d'abstraction intelligente pour brancher des services sur le patrimoine de données.
Les principes
Respectant l'architecture REST, l'API publique est dédiée à la lecture des catalogues et ouverte à quiconque souhaite développer et possède un accès à Isogeo. Elle permet d'exécuter des requêtes et d'en retranscrire les résultats dans une interface originale. L'idée est d'élargir les horizons des usages des catalogues de données constitués dans Isogeo.
Les premières applications à utiliser l'API Isogeo ne sont autres que APP et OpenCatalog !
Une application tierce peut être développée par Isogeo, un intégrateur, un partenaire ou un développeur indépendant.
Exemples d'applications basées sur l'API
Il est possible d'utiliser l'API dans autant d'applications qu'il y a de développeurs pour les faire. Voici quelques exemples d'applications développées aujourd'hui et disponibles en tant qu'extensions de la plateforme.
Les plugins pour les SIG
L'un des usages les plus demandés est de pouvoir consulter les catalogues directement dans les logiciels SIG. Aujourd'hui, des plugins ont été développés pour :
Astuce : consulter la page des plugins et widgets sur le site isogeo.
Les portails de données
Si l'OpenCatalog permet de couvrir l'essentiel des besoins de consultation, il est également possible de développer des portails d'accès aux données. Interne ou public, l’objectif n’est pas de mettre un simple catalogue en consultation mais d’implémenter des fonctionnalités dédiées à l’animation autour du patrimoine de données :
- suivi des modifications sur les données par abonnement mail personnalisable par chaque utilisateur (listes de favoris) ;
- commentaires et notation sur les données ;
- interopérabilité avec les annuaires internes (Active Directory, LDAP...) ;
- flux dynamiques autour de la vie du patrimoine ;
- interface cartographique de recherche et de consultation ;
- interface d'administration de type CMS (modèle WordPress) pour les configurations avancées et la gestion de contenus éditoriaux ;
- interfaces responsive design ;
- des fonctionnalités qu'il tient à chacun de contribuer à développer ! :)
Astuce : Consulter la documentation du portail.
Générique ou spécifique
Selon votre projet et vos besoins, il est possible d'envisager la mise en place d'un portail au socle générique ou bien d'un développement spécifique complet.
| Portail générique Isogeo & PixUp | geomayenne Isogeo & arx iT |
Astuce : consulter et se créer un compte sur le portail générique de démonstration.
Réalisations intéressantes supplémentaires
Voici une sélection de portails utilisant l'API Isogeo pour apporter des fonctionnalités d'interaction via le catalogue :
- Infrastructure de données géographiques du département des Hauts de Seine
- Syndicat Mixte d'Aménagement de la Vallée de la Durance (SMAVD) ;
- Lorient Agglomération ;
D'autres existent mais sont réservés à un accès en intranet (GRDF, ADP, CD 64 par exemple)
L'export vers les formats bureautiques
Pour les besoins d'une consultation hors-ligne, une sauvegarde ou une impression dans un modèle graphique propre à un organisme, un petit programme a été développé permettant d'exporter par lot les métadonnées dans des formats bureautiques :
- Microsoft Word (.docx) à partir d'un ou plusieurs modèles personnalisables par l'utilisateur ;
- Microsoft Excel (.xlsx) ;
- XML ISO 19139.
Au-delà de ces formats existants, il est possible d'envisager d'autres formats : CSV, base locale, etc.
Astuce : Consulter la documentation de l'application Isogeo to Office.
Capture d'écran de l'interface d'isogeo2office :
Lancez vous
Astuce : Consulter la documentation dee l'API.
Notions
Si vous avez des compétences en développement, voici les notions techniques utiles pour démarrer :
- l'API respecte le protocole REST pour les requêtes ;
- oAuth2 pour l'authentification des applications tierces ;
- l'accès aux fichiers hébergés via les métadonnées (données brutes, fiches XML...) est soumis à la mise en place d'un proxy.
Présentation technique de l'API
En janvier 2016, un webinaire a été consacré à une présentation de l'architecture de l'API et des bases de développement. Consulter le résumé sur notre blog
Documentation et ressources
Une liste de diffusion pour informer et prévenir des évolutions, à laquelle il est fortement recommandé de s'inscrire.
Des exemples de code dans différents langages sont librement disponibles en ligne, issus d'Isogeo ou de ses partenaires :
 |  |  |
|---|---|---|
| JavaScript (nodeJS) | Python | PHP |