Avant propos

API 2D 
API Web 2D 
API Web 2D en Javascript 
API Web 2D en Flex 
API 3D

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.

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 ;
    • ECMA-262 et affiliés (JavaScript [1] / ActionScript [2]) : l'API Web 2D et ses composants (comme OpenLayers) utilise ces langages de programmation. Il faut donc maîtriser au moins l'un d'eux au 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. Ceci pourrait changer quand un standard émergera cette demande à commentaires de l'OGC ;
    • 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 figure suivante schématise le fonctionnement de l'API :

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 cliente est chargée ici.

    Cette partie 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'.

API 2D

L'API 2D permet d'intégrer des référentiels Géoportail depuis les services fournis par l'infrastructure du Géoportail.

API Web 2D

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.

API Web 2D en Javascript

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.

La présente documentation et les exemples de code associés se rapportent à la version 1.0 de l'API Web 2D en Javascript.

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

Date de livraison Version Fonctionnalités
17 janvier 2011 1.2 OpenLayers 2.10, les données vectorielles sont
dorénavant chargés en utilisant OpenLayers.Protocol et
OpenLayers.Strategy sans impact sur l'API elle-même et pour
se rapprocher d'OpenLayers 3.0. 
Voir les évolutions.
2 août 2010 1.1 OpenLayers 2.9.1  
Voir les évolutions.
15 mars 2010 1.0 OpenLayers 2.8, support expérimental des
ExtendedData pour KML. Voir les
évolutions
Analyse des capacités WMS (1.3.0) et WFS (1.1.0). 
Les accès OpenLS sont dorénavant protégés par GeoDRM.
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.

API Web 2D en Flex

Réalisée en Flex et basée sur le projet open source OPENSCALES (licence LGPL v3), l'API Web 2D en MXML/ActionScript est en cours de conception. Un exemple est donné .

L'IGN contribue à OPENSCALES avec la mise en oeuvre de la partie utile de la GeoAPI et des connecteurs GeoDRM.

API 3D

Une preuve de concept de l'utilisation des flux 2D dans une application 3D est l'inclusion dans Nasa World Wind des données du Géoportail.


N1 JavaScript est une marque déposée par Sun MicroSystems Inc.

N2 ActionScript est une marque déposée par Adobe Inc.