Cela fait 2 ans que Géoportail a été annoncé par l’IGN, souvenez-vous en avril 2006. Il y avait déjà une forte attente de la part du public. Le lancement de Géoportail en juin 2006 n’a fait que consolider l’engouement pour les internautes de voir leur "chez soi" vu du ciel.
Dans le monde du géospatial, l’API était tout aussi attendue. En effet, les données géographiques de l’IGN sont très vérrouillées (même si l’IGN est un établissement public de l’Etat), et le fait de pouvoir "manipuler" simplement ces données à travers une API était très attendu.
https://api.ign.fr/geoportail/
Qu’est-ce que l’API Géoportail ?
L’API Géoportail permet d’afficher des données du Géoportail ainsi que des données aux principaux formats standard dans une interface de navigation conviviale sur votre propre site Internet, Intranet ou Extranet. Vous pouvez également développer vos propres fonctionnalités afin d’enrichir celles déjà présentes.
L’API Géoportail utilise l’API OpenLayers de l’Open Source Geospatial Foundation. OpenLayers est une librairie Javascript dédiée à l’affichage de carte. L’API Géoportail surcharge les librairies de cette dernière pour apporter de nouvelles fonctionnalités.
Les données accessibles depuis l’API Géoportail sont pour le moment :
- "Ortho Photos" (avec des données de Planet Observer hors France métropolitaine)
- Cartes IGN
Formats standard de données acceptés pour l’ajout sont :
- KML (Keyhole Markup Language)
- WMS (Web Map Service)
- WFS (Web Feature Service)
L’API Géoportail, qu’en est il?
Première précision importante, il s’agit d’une version bêta. Ceci est clairement préciser dans les conditions générales mais très peu sur le site :
API Géoportail Web 2D version Bêta (ou « API bêta ») : package fourni au Bêta-Testeur (…)
L’IGN sollicite de votre part la remontée d’informations provenant de développeurs ou
d’utilisateurs finals de l’API bêta. Vous êtes donc invités à nous donner vos points de vue et
réactions sur l’API bêta et vous pouvez nous envoyer vos idées sur les perfectionnements,
améliorations et autres changements concernant l’API bêta par courrier électronique à
l’adresse contact.api@ign.fr .
D’où des restrictions d’utilisation très fortes pour ce lancement :
- Pas d’utilisation commerciale de l’API Géoportail Bêta ;
- Au maximum 100 pages vues par jour et par clé d’utilisation ;
- Au maximum 10 000 tuiles de 256 x 256 pixels chargées par jour et par clé d’utilisation ;
- Une taille de fenêtre cartographique de 400 x 400 pixels au maximum.
100 pages vues par jour, c’est très limité et ne permet donc pas de s’adapter à un site web.
Cette version bêta s’adresse donc aux développeurs, aux spécialistes des SIG qui pourraient remonter leurs avis à l’IGN. Donc un peu d’indulgence comme le souligne Luc Vaillancourt sur Baliz-Media. 
Il s’agit donc d’une version gratuite, appelée API Géoportail Web 2D. Selon les FAQ, une version payante est en préparation ainsi qu’une version 3D. Ceci confirme les propos de Patrick Leboeuf lors du Géo-événement 2008.
Les fonctionnalités
La fonction principale est d’afficher les données de l’IGN : vue aérienne (ou BD Ortho) et les cartes topographiques.
Du fait que l’API Géoportail se base sur l’API OpenLayers (logiciel libre), vous pouvez ajouter différentes informations sur ces cartes provenant d’un WMS (Web Map Service) ou WFS (Web Feature Service). Autre point intéressant c’est que vous pouvez aussi afficher des données provenant d’un fichier KML.
Voici un exemple fournit sur le site :
Entrons dans l’API… du moins essayons
Pour pour utiliser cet API, le parcours est assez classique
- Créer un compte
- Votre compte créé et validé, vous pouvez demander un nouveau contrat
- Vous sélectionnez un "client", pour le moment vous avez que "client léger 2D"
- Vous sélectionnez l’emprise (territoire que vous voulez visualiser sur votre carte) parmis :
- France métropolitaine
- Guadeloupe
- Martinique
- Guyane Française
- Réunion
- Mayotte
- Saint-Pierre-et-Miquelon
- Iles Crozet
- Nouvelle Calédonie
- Polynésie Française
- Saint-Barthélemy
- Saint-Martin
- Wallis-et-Futuna
- Précisez votre URL de site
- Vous obtenez la clé de votre contrat et un code exemple
L’API Géoportail 2D permet d’intégrer en quelques lignes une carte Géoportail dans une page HTML.
Les librairies disponibles sont accessibles d’une manière très simple grâce à la classe Geoportal.Map, qui encapsule toute les fonctionnalités de l’API derrière quelques méthodes.
Un shéma explique la structure de l’API Géoportail :
… mais je n’ai pas tout saisi….
Etudions le code d’exemple :
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<title>API Geoportail - votre carte personnelle</title>
<script src="http://api.ign.fr/api?v=1.0beta&key=8750437567523772095&instance=map"></script>
<script type="text/javascript">
function initGeoportalMap() {
geoportalLoadmap("GeoportalMapDiv", "normal", "FXX");
if(map.allowedGeoportalLayers){
map.addGeoportalLayers(map.allowedGeoportalLayers);
}
}
</script>
</head>
<body>
<div id="GeoportalMapDiv" style="width:400px;height:400px;"></div>
</body>
</html>
Vous devez charger le script de l’API en indiquant la version et votre clé. Si la clé n’est pas bonne vous avez une erreur Javascript.
Par contre, le script de l’API Géoportail, http://api.ign.fr/js/Geoportal.js est extrêmement lourd… 761Ko!! A titre de comparaison, les API de ViaMichelin, Microsoft ou Google font entre 200 et 250 ko. Cette "lourdeur" se ressent donc au chargement.
Sur le principe, le code javascript semble similaire aux API concurrentes. La chose un peu bizarre est d’instancier la carte au niveau du script de chargement avec le paramètre "instance". Voici les points signalés par l’IGN pour pouvoir afficher la carte :
- Placer une balise script qui fait appel à la page de vérification de licence. Vous devez remplacer le paramètre key par votre clé de licence;
- Vous devez remplacer le paramètre instance par le nom que vous voulez donné à la carte et qui vous servira ensuite pour configurer cette carte. Ce nom sera celui de la variable Javascript de votre carte;
- Placer dans le corps de la page HTML une balise DIV dont les attributs ID class et style sont renseignés comme dans le code qui suit;
- Définir la fonction Javascript initGeoportalMap() cette fonction sera exécutée au chargement de la page pour initialiser votre carte;
Il existe 2 types de cartes :
normal : carte avec tous les panneaux visibles (gestionnaire de couche, boîte à outils et panneau d’information)
petite taille : carte de petite taille sans panneaux. Les déplacements et les zooms se font avec la souris.
La documentation est mise à disposition. Malheureusement elle n’est pas très lisible. Un minimum d’exemples sont là pour éventuellement vous guider. Pour aller plus loin dans la manipulation de ces cartes, il faut maîtriser l’API OpenSource Openlayers.
Conclusion
Cette API Géoportail était très attendue. Elle poursuit la logique de mise à disposition du public des données de l’IGN.
L’IGN a souhaité être prudent quant au lancement de cette API en proposant une version bêta public très limitée en matière de requêtes autorisées. La démarche de se baser sur Open Layers est très louable pour un organisme public comme l’IGN.
Cette mise à disposition est intéressante pour créer des services nécessitant les données précises de l’IGN. Malheureusement, pour le moment, il me semble assez difficile d’étudier techniquement les possibilités de cette API sans passer par un apprentissage de l’API Open Layers.
De plus il n’est pas possible de vraiment la comparer aux API des leaders comme Google, Microsoft, Yahoo ou ViaMichelin. En effet l’API Géoportail n’est qu’une simple interface pour afficher sur votre site les données cartographiques de l’IGN. Des services proposés par ViaMichelin ou Google comme le calcul d’itinéraire ou le géocodage, ne sont pas disponibles.
N’oublions pas que l’objectif premier de Géoportail est d’offrir un véritable service public de mise à disposition d’information géographique en France. L’API en est une extension.
Dommage donc que pour un lancement si attendu, les limitations soient si importantes. Mais je suis sûr que la version 3D pourra apporter un nouveau regard à cette API. De plus la version commerciale pourra intéresser un bon nombre de collectivités locales ou de sociétés pour la mise en place de SIG en France. Enfin la qualité des vues aériennes (en constante amélioration) en terme de couverture reste innégalée, et ça Microsoft l’a bien compris.
Enfin quelques efforts sur la présentation et la documentation ne ferait pas de mal. 
Et vous quel est votre avis?
