Avant propos

L'API du Géoportail a pour but de permettre la superposition des couches métiers utilisateurs avec les référentiels pour tous types d'applications.

L'API Web 2D du Géoportail est la déclinaison Web de l'API Géoportail permettant aux applications Web de superposer les données utilisateurs avec les référentiels.

Les informations contenues dans la présente documentation nécessitent à minima la connaissance d'un certain nombre de technologies liées à l'information géographique et de l'information. Parmi ces technologies, on trouvera :

  • le Web : les technologies utilisées par l'API WEB 2D relèvent principalement des mécanismes de l'internet. Les flux d'informations proviennent de différents serveurs qui amènent l'information au client Web privilégié : le butineur ;
  • les langages de programmation côté butineur : les pages Web de l'API sont des pages dynamiques qui utilisent 3 technologies de base :
    • HyperText Markup Language (HTML) : il faut savoir écrire une page Web pour utiliser l'API ;
    • Cascading Style Sheet (CSS) : l'ergonomie d'une page Web repose sur ce langage, l'API l'utilise fortement ;
    • Javascript : l'API et ses composants (comme OpenLayers) utilise ce langage de programmation. Il faut donc le maîtriser un minimum pour concevoir des pages Web utilisant l'API.
  • les standards de l'ISO (International Organization for Standardization), de l'OGC (Open Geospatial Consortium), de l'OSGeo (Fondation Géospatiale Open Source) : les services géographiques utilisent ces standards ou normes, il s'agit donc d'en connaître l'existence et les fonctionnements :
    • Web Map Service - Cached (WMS-C) : en l'absence d'un standard ISO/OGC, le Géoportail a mis en oeuvre un service de cartographie tuilé pour servir à hautes performances les données spécifié par MetaCarta ;
    • Web Map Service (WMS) : la cartographie par le réseau, ce service fournit principalement des images (mais pas uniquement). Bien que le butineur bénéficie au travers de l'API de ce type de services, un SIG est aussi potentiellement un client WMS ;
    • Web Feature Service (WFS) : à l'instar d'une connexion à une base de données, un tel service permet d'accéder à des bases de données géographiques par le réseau en utilisant principalement le format GML (Geographic Markup Language). Le butineur bénéficie au travers de l'API de ce type de service, mais un SIG est aussi potentiellement un client WFS ;
    • Keyhole Markup Language (KML) : ce langage est en cours d'adoption entre l'OGC et Google. Il est très utilisé dans Google Earth. Il est supporté par OpenLayers ;
    • GPS eXchange Format (GPX) : ce langage supporté par l'API permet de récupérer des traces GPS et de les afficher dans l'API.

Les technologies listées ci-dessus ne sont pas les seules dans le domaine de la géomatique...

La présente documentation et les exemples de code associés se rapportent à la version 1.0beta4 de l'API.

API Web 2D

L'API Web 2D permet d'intégrer en quelques lignes une carte Géoportail sur n'importe quelle page HTML.

Réalisée en JavaScript et basée sur la bibliothèque OpenLayers (logiciel libre sous licence BSD), elle surcharge les librairies de ce dernier pour apporter de nouvelles fonctionnalités.

Les livraisons bêta sont construites sur différentes versions d'OpenLayers :

Date de livraison Version Fonctionnalités
6 mai 2009 1.0beta4 Séparation entre le visualisateur et la carte en préparation
de la version 1.0 : il est nécessaire de modifier les pages
pour passer à cette version
comme indiqué dans les
évolutions.
Introduction des API minimum, standard et étendue.
Ajout du support de la recherche par OpenLS (Location
Utility Service). Expérimental.
4 novembre 2008 1.0beta3 OpenLayers 2.7, support préliminaire en écriture du format
Geoconcept export. Retrait de Prototype et Script.aculo.us.
Nouvelle barre d'édition et nouveaux composants pour le
gestionnaire de couches.
Documentation basée sur NaturalDocs.
Ouverture au zoom mondial.
1er juillet 2008 1.0beta2 OpenLayers 2.6, plus de fonctionnalités au support du
format GPX.
4 juin 2008 1.0beta1 Corrections de quelques boggues, quelques fonctionnalités
OpenLayers 2.6 et support préliminaire du format GPX.
28 avril 2008 1.0beta OpenLayers 2.5 avec le support des projections.

Pour de plus amples informations, se rapporter aux évolutions.

Toutes ces fonctionnalités sont accessibles d'une manière très simple grâce à la classe Geoportal.Map, qui encapsule toute la puissance de l'API derrière quelques méthodes.

Les développeurs peuvent également utiliser l'intégralité des fonctions OpenLayers.

La figure suivante schématise le fonctionnement de l'API 2D :

architecture

Le schéma ci-dessus décrit trois parties principales :

  • les composants côté serveur :

    Les entrepôts de données sont gérés ici. Ils peuvent être sous un gestionnaire de base de données (postgreSQL, mySQL, Oracle, Informix, ArcSDE, etc ...) ou directement sur le système de fichiers sous forme de répertoires de fichiers (cache, arborescences).

  • les services :

    Ces entrepôts sont accessibles par des services (Web Map Service, Web Feature Service, ...) ou par des transferts HTTP classiques (Keyhole Markup Language, ...). Un autre composant important réside côté service : le service de gestion de droits en information géographique (connu aussi sous les vocables GeoDRM ou GeoRM). Ce service gère la licence en provenance du client.

  • les composants côté client :

    L'API est chargée ici. Pour le client Web 2D, son architecture interne est la suivante :

    Cette bibliothèque met en oeuvre la charte graphique de l'API et se connecte avec le service GeoDRM.

Les services du Géoportail (WMS-C, WMS, WFS) peuvent être connectés à des applications SIG. Pour cela, il faut mettre en oeuvre un connecteur à notre GeoRM. Pour plus d'information, il faut nous contacter à 'contact dot api at ign dot fr'.